如果你第一次使用腾讯元器,建议先把目标缩小到一个最小可用问答工作流:上传一小批个人文档,让智能体能够根据知识库回答问题,并能识别“资料中没有答案”的情况。本文按这个目标展开,重点放在每一步如何验证结果,不涉及多智能体协同、复杂提示词工程或模型微调。由于平台界面和节点能力可能调整,实际名称请以当前页面显示为准。

先准备一个可验证的小场景
不要一开始就上传整个电脑里的资料。先选择一个主题明确、内容较少的资料包,例如:
- 一份个人项目说明;
- 一份产品使用手册;
- 一组固定格式的常见问题与答案;
- 一份会议记录或工作流程说明。
准备资料时,优先处理以下问题:
- 文件中是否有明确的标题和段落?
- 同一个概念是否始终使用同一个名称?
- 过期内容、重复内容和无关附件是否已经删除?
- 能否设计出三类测试问题:资料中明确写过的问题、需要综合多个段落的问题、资料中完全没有的问题?
建议先准备不超过十份、主题相近的文档。资料越多,不代表第一次测试越容易判断,反而可能增加检索结果混杂的情况。
创建知识库
进入腾讯元器后,先创建一个知识库。名称可以直接体现用途,例如“项目说明问答库”,描述中写清楚资料范围,例如“用于回答项目功能、操作步骤和已知限制”。
然后上传准备好的文档,等待平台完成处理。不同文件的解析速度可能不同,页面通常会显示处理状态。只有当文档进入可用状态后,才适合继续配置问答流程。
这一步如何验证
先不要创建复杂工作流,打开知识库相关的预览、测试或问答入口,使用一个文档中原句或接近原句的问题进行测试。
预期结果是:
- 系统能够返回与文档相关的回答;
- 回答中的关键事实能在原文中找到;
- 如果平台展示引用片段,可以定位到对应内容;
- 文档仍显示为处理中时,不应把测试失败直接判断为检索能力不足。
如果连原文中明确写过的问题都无法回答,先检查文档状态、文件内容和知识库绑定情况,不要急着增加模型节点。
创建智能体和工作流
创建一个新的智能体,给它设置清晰的用途说明,例如:
你是项目资料问答助手。优先依据已绑定的知识库回答问题。资料中没有明确依据时,说明暂未找到相关内容,不要自行编造。
这段说明不需要写得很长。初学阶段,最重要的是先让知识库回答链路跑通,而不是同时加入大量角色设定、格式要求和复杂规则。
接着进入智能体的工作流管理区域,新建一个工作流。工作流的基本链路可以先保持为:
开始节点 → 知识库问答节点 → 回复节点 → 结束节点
平台当前可能将知识库能力显示为“大模型知识回答”“知识检索”等不同节点。选择时可以按下面的方式判断:
- 如果节点能够直接根据知识库生成回答,适合先搭建最小流程;
- 如果节点只负责检索资料,还需要额外的大模型节点组织答案;
- 如果节点支持配置未命中处理,先保留默认行为,完成基础测试后再调整。
配置开始节点的输入变量
打开开始节点,为用户问题配置一个输入变量。变量名可以使用 question,类型选择文本或字符串。
这个变量的作用是接收用户在对话框中输入的问题。后续知识库节点要使用同一个变量作为查询内容,回复节点则要使用知识库节点输出的回答。
配置完成后,检查变量连接关系:
用户输入 → question → 知识库查询内容
不要把固定测试问题直接写死在节点配置里,否则测试时看起来能够回答,实际对话却可能没有使用用户输入。
这一步如何验证
在工作流测试面板中输入一句简单问题,例如:
这个项目主要解决什么问题?
预期结果是知识库节点能够收到这句话,并返回检索结果或生成回答。如果节点没有输入、输出为空,重点检查变量映射,而不是先修改知识库内容。
绑定知识库并回填回答
在知识库问答节点中选择刚才创建的知识库,把开始节点的 question 变量映射为查询输入。
如果节点还需要设置回答范围,建议先使用保守配置:
- 只绑定当前主题相关的知识库;
- 保留平台默认的检索数量或召回设置;
- 暂时不要同时接入多个内容相近的知识库;
- 未找到依据时,要求节点返回“未找到相关资料”或类似状态。
然后在回复节点中,选择知识库问答节点输出的回答变量。不要重新手打一段固定回复,否则无论用户问什么,最终都可能只显示固定文字。
基础连接关系可以整理为:
开始节点.question
↓
知识库问答节点.query
↓
知识库问答节点.answer
↓
回复节点.content
↓
结束节点
这一步如何验证
至少使用三种问题测试:
| 测试类型 | 示例 | 预期结果 |
|---|---|---|
| 原文事实 | “项目支持哪些功能?” | 能在资料中找到依据并回答 |
| 综合理解 | “先完成配置后,下一步应该做什么?” | 能结合相关段落给出步骤 |
| 未知问题 | “这个项目明年会不会涨价?” | 明确说明资料中没有相关信息 |
测试时不要只看最终回复,还要查看节点运行记录。重点确认:
- 开始节点确实接收了当前问题;
- 知识库节点使用了正确的知识库;
- 回复节点引用的是本次运行的输出;
- 未命中时没有沿用上一次测试的回答。
按意图增加分支
基础链路能够稳定回答后,再考虑把问题按意图拆分。常见的最小分支可以是:
开始节点
↓
条件判断节点
├─ 资料问答 → 知识库问答 → 回复
├─ 需要外部信息 → 联网搜索答案 → 回复
└─ 无法判断 → 回复澄清问题
不要一开始就细分十几种意图。先区分三类就够了:
- 能够由个人资料回答的问题;
- 需要当前外部信息的问题;
- 无法判断或问题过于模糊的问题。
条件判断节点的规则可以从简单关键词开始,但要注意关键词只是辅助判断。例如,出现“文档”“项目说明”“操作步骤”等词,并不一定意味着问题必然能在知识库中找到。更稳妥的做法是先让知识库尝试回答,再根据检索结果或命中状态决定后续处理,具体取决于当前节点是否提供相应输出。
为什么要后加分支
知识库问答、条件判断和联网搜索同时加入时,问题可能来自三处:
- 分支条件没有覆盖实际说法;
- 知识库回答和联网回答的优先级不清楚;
- 某个节点输出为空,后续节点仍然被强制执行。
先跑通单一路径,可以把问题范围控制在资料和变量映射上。基础链路稳定后,每增加一个节点,都能通过前后对比判断它是否真的改善了结果。
对未命中问题做专门测试
“未命中”不是只测试一句完全无关的问题。建议准备以下三种情况:
资料中完全没有
例如资料只介绍软件功能,却询问某个未出现的价格或未来计划。
预期结果是智能体说明没有找到依据,而不是用常识补充一个看似确定的答案。
关键词相似但含义不同
例如资料讨论“账号权限”,用户询问“文件访问权限”。两者词语接近,但答案可能不同。
预期结果是智能体能够区分概念,或者明确表示资料不足。
问法不同但事实相同
例如文档写的是“管理员可创建成员”,用户问“谁能添加新成员”。
预期结果是能够通过语义理解找到相关内容。若这类问题经常失败,再考虑整理同义词、补充常见问答,或调整资料结构。

再考虑联网补充
联网搜索适合处理具有时效性、而且不应写入个人知识库的问题,例如公开网页上的最新信息。但它不能替代个人资料问答,也不意味着答案一定正确。
如果当前平台提供“联网搜索答案”节点,可以把它放在知识库未命中或明确属于外部信息的分支中。建议在回复规则中区分来源:
- 个人资料问题:优先依据知识库;
- 当前公开信息:使用联网搜索结果,并提示信息可能随时间变化;
- 两者都没有可靠依据:直接说明无法确认。
测试联网分支时,使用一个明确需要最新信息的问题,并单独检查搜索结果是否真的进入了回复节点。不要仅凭最终回答中出现了新内容,就判断联网节点已经生效。
用一组固定问题做回归测试
每次修改知识库、节点连接或提示说明后,都使用同一组问题重新测试。可以建立一个简单的测试表:
| 编号 | 问题 | 期望来源 | 实际结果 | 是否通过 |
|---|---|---|---|---|
| 1 | 资料中的明确事实 | 知识库 | ||
| 2 | 需要综合的操作问题 | 知识库 | ||
| 3 | 相似关键词问题 | 知识库或澄清 | ||
| 4 | 资料外问题 | 未命中处理 | ||
| 5 | 当前外部信息 | 联网搜索 |
判断结果时,不要只看回答是否“听起来合理”,还要核对它是否有资料依据、是否回答了原问题、是否把不确定内容说成了确定事实。
这组测试不能证明智能体的整体准确率,也不能覆盖所有用户表达。它的作用是帮助你发现一次修改是否破坏了已有路径。
常见卡点和处理方式
知识库节点没有结果
先检查文档是否处理完成、工作流是否绑定了正确知识库,以及查询变量是否为空。可以用文档中的完整句子进行测试,排除问法差异造成的干扰。
最终回复始终相同
通常是回复节点使用了固定文本,或者没有绑定知识库节点的输出变量。打开回复节点,确认内容来自当前运行中的回答字段。
能回答,但内容来自资料之外
检查智能体说明和节点配置是否允许模型自由补充。对于个人文档问答,应该明确要求优先依据知识库,缺少依据时说明无法确认。仍然出现补充内容时,可以降低任务范围,或者将未命中处理单独接到回复节点。
增加分支后流程不执行
逐个检查条件判断的输入变量、判断表达式和每条分支的连线。先只保留一条分支运行,确认它能工作后再恢复其他分支,这样更容易定位问题。
修改资料后结果没有变化
确认新文档是否已经完成处理,并检查测试时使用的知识库是否就是更新后的版本。必要时用一条新文档中特有的句子测试,避免继续使用旧问题造成误判。
回退和继续调整
如果增加意图分支或联网节点后结果变差,可以先回退到这条基础链路:
开始节点 → 知识库问答节点 → 回复节点 → 结束节点
保留原来的知识库和测试问题,只移除新增节点,确认基础问答是否恢复。之后一次只增加一个变化,例如先增加未命中处理,再增加联网分支,并在每一步运行固定测试集。
当基础流程已经稳定后,可以继续调整三个方向:
- 为高频问题补充结构清晰的问答资料;
- 为容易混淆的概念统一名称和同义词;
- 为不同来源的回答增加明确的来源说明。
先让一个小范围知识库问答工作流可用,再逐步扩展,通常比一次搭建完整智能体更容易判断问题,也更适合第一次使用腾讯元器的场景。
















































固定问题做回归测试,后面改配置会省很多时间
知识库处理没完成时测试,结果确实不好判断
节点运行记录比只看最终答案更重要
未命中问题单独测试这个思路很实用
第一次搭工作流,先做小场景确实更容易排错