跳到主要内容

澄清判断逻辑与执行计划构建

上一篇讲了候选文档选择逻辑，这一篇我们来看系统是如何决定是否需要向用户发起澄清，以及如何构建澄清执行计划的。

为什么需要澄清机制？​

在自动文档路由中，可能会遇到以下情况：

  1. 没有找到候选文档 - 路由完全失败
  2. 置信度过低 - 不确定哪个文档是正确答案
  3. 前两名得分接近 - 存在真实歧义，难以自动选择

在这些情况下，如果系统强行选择一个文档，可能会导致：

  • 检索不到相关内容
  • 回答答非所问
  • 用户体验变差

所以系统采用了一个保守策略：当不确定时，先向用户发起澄清，让用户明确指定要查询哪个文档。

shouldAskClarification 方法：澄清判断逻辑​

/**
 * 判断是否应该先向用户发起澄清。
 *
 * @param routeDecision 路由结果
 * @param candidateDocuments 候选文档
 * @return true 表示应先澄清，false 表示可直接继续
 */
private boolean shouldAskClarification(KnowledgeRouteDecision routeDecision,
                                       List<DocumentRouteCandidate> candidateDocuments) {
    if (candidateDocuments == null || candidateDocuments.isEmpty()) {
        // 连候选都没有时，必须先澄清。
        return true;
    }
    if (routeDecision == null || routeDecision.getDocuments() == null || routeDecision.getDocuments().isEmpty()) {
        // 路由器没有给出有效结果时，同样先澄清。
        return true;
    }
    if (routeDecision.getConfidence() == null || routeDecision.getConfidence().doubleValue() < 0.55D) {
        // 整体置信度过低时，不冒险自动选文档。
        return true;
    }
    if (candidateDocuments.size() < 2) {
        // 只有一个候选时，通常无需澄清。
        return false;
    }
    BigDecimal topScore = candidateDocuments.get(0).getScore();
    BigDecimal secondScore = candidateDocuments.get(1).getScore();
    if (topScore == null || secondScore == null) {
        return false;
    }
    // 前两名分差过小且知识域不同，说明存在真实歧义，优先让用户确认。
    return topScore.subtract(secondScore).doubleValue() <= 3D
        && !Objects.equals(candidateDocuments.get(0).getKnowledgeScopeCode(), candidateDocuments.get(1).getKnowledgeScopeCode());
}

这个方法包含了五个判断条件，只要满足任意一个，就会触发澄清。

条件一：候选文档为空​

if (candidateDocuments == null || candidateDocuments.isEmpty()) {
    // 连候选都没有时，必须先澄清。
    return true;
}

如果候选文档列表为空，说明路由完全失败，没有找到任何相关文档。这时候必须向用户澄清。

付费内容提示

该文档的全部内容仅对「JavaUp项目实战&技术讲解」知识星球用户开放

加入星球后，你可以获得：

  • 超级八股文：100万+字的全栈技术知识库，涵盖技术核心、数据库、中间件、分布式等深度剖析的讲解
  • 讲解文档：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的从0到1的详细文档
  • 讲解视频：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的核心业务详细讲解
  • 1 对 1 解答：可以对我进行1对1的问题提问，而不仅仅只限于项目
  • 针对性服务：有没理解的地方，文档或者视频还没有讲到可以提出，本人会补充
  • 面试与简历指导：提供面试回答技巧，项目怎样写才能在简历中具有独特的亮点
  • 中间件环境：对于项目中需要使用的中间件，可直接替换成我提供的云环境
  • 面试后复盘：小伙伴去面试后，如果哪里被面试官问住了，可以再找我解答
  • 远程的解决：如果在启动项目遇到问题，本人可以帮你远程解决
进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。
知识星球二维码

1. 打开微信 -> 扫描左侧二维码 -> 加入「JavaUp项目实战&技术讲解」知识星球

2. 查看星球使用指导，获取完整项目讲解资料索引

👉 点击解锁全部付费内容
🎁优惠