★ FEATURED ARTICLE 在 Dify 安装了工具Agent 却直接给出答案不能只靠它说“已经查询”判断工具是否执行。本文面向首次配置经典 Agent 节点的同学用一个只读查询任务区分安装、授权、可见、选择与执行五个环节再判断是否应改用独立工具节点。资料核验于 2026 年 10 月 15 日未在读者实例实测不涉及自动执行真实写入。1. 先明确这一步是否必须执行工具经典 Agent 会依据任务选择工具并非只要安装某个插件每次对话都一定调用。Dify Agent 说明 如果业务要求每次都读取一次当前状态应先考虑将这个确定步骤放成工作流中的独立工具节点再由模型解释结果。如果只有某些问题才需要查询Agent 自主选择可能更适合。两种方式的差异是执行决策放在哪里不是工具节点天然比 Agent 更准确。先确定你的业务约定避免用不断加重提示词的方式弥补流程选择不合适。本文选择只读示例查询演示仓库当天开放状态。工具由你已有的可信测试插件提供输入一个虚构位置编号返回 OPEN-DEMO 或 CLOSED-DEMO 及测试日期。不要用发邮件、扣费或修改订单作为首次工具实验。如果没有可用的测试工具先完成插件自身的只读调用验证。本文不假装所有 Dify 安装都内置同名工具也不要求你为了复现安装来历不明的插件。2. 沿着五个环节找到第一处断点在集成页面确认插件已安装并在工具配置中选择正确凭证。随后打开 Agent 节点把所需工具加入它可访问的工具集合。仅在工作区安装完成不代表每个 Agent 自动获得该工具。环节应当观察什么常见下一步安装能在工具列表找到动作核对插件与版本授权只读测试能通过认证修正选中的凭证可见Agent 配置包含该动作将工具加入当前节点选择运行记录出现调用意图改任务或工具说明执行有参数、结果或明确错误排查工具服务本身完成前一步再看下一步。认证失败时提高模型迭代次数不会让密钥变正确工具不在可见列表时反复要求“务必查询”也无法补齐能力配置。工具描述写清用途与时机例如“读取演示仓库当天开放状态回答是否开放前使用不提供历史状态”。参数说明应解释编号来自哪里而不是只写一个不透明的 id。任务可以写成“请查询编号 DEMO-N4 今天是否开放基于工具结果回答工具无法访问时明确说明不能猜测。”这段是教学指令不是强制调用的技术保证仍然需要查看运行记录。3. 模型、策略与参数要匹配经典 Agent 有不同策略。采用 Function Calling 时所选模型和接入路径需要支持相应能力采用 ReAct 时也要使用与当前节点兼容的策略。不要只凭模型网页能聊天就推断其 API 和插件一定支持当前工具策略。检查必填参数是否可以从任务或上游获得。位置编号缺失时正确行为可能是向用户追问如果你让工具自动生成编号它也可能生成不存在的值。固定测试参数能先排除这一层不确定性。工具调用有意图但执行失败查看参数形状、HTTP 状态或插件错误而不是把错误归为“Agent 不愿意调用”。有结果却答案不引用查看结果是否能被 Agent 读懂以及任务是否要求基于结果解释。运行记录没有调用时检查问题是否确实需要实时信息。简单问“什么是仓库”可以直接回答并不需要开放状态工具。用两个有明显区别的问题做对照避免把所有未调用都误判成故障。4. 必须查询的流程用工具节点固定下来如果需求是每次都查状态可在画布添加 Tools 节点选择对应动作及凭证显式绑定位置编号再连接模型或输出节点。Dify 官方说明独立工具节点可以在工作流中配置动作与认证。Tool Node这条链路中是否执行由工作流连线与条件决定而不是让模型临时选择。为了先验证动作工具后面可以直接输出返回标记成功后再增加自然语言说明。不要一开始就把查询失败后的多层模型回退一起搭上。工具返回 CLOSED-DEMO模型应如实说明测试位置关闭。工具返回认证错误模型不能给出“今天开放”。为无结果与明确否定结果设置不同输出能避免一个空值被解释成正常状态。如果下游模型只是润色文字应保留工具日期和来源字段避免它把旧状态改写成当前事实。实时查询也可能返回服务侧缓存是否满足你的时效要求要由业务另外定义不从“调用过一次”直接推出数据绝对最新。5. 验收看工具证据不看模型承诺准备三类问题必须查询、无需查询、缺少参数。分别核对工具是否执行、参数是否正确、失败时是否说明原因。模型最终说“已查询”只是一段文字运行轨迹里的动作记录与实际结果才是执行证据。在可信测试端修改虚构状态再问同一问题。答案应随本次结果变化且运行记录能指向新结果。若仍给旧值检查输入来源、历史上下文和服务缓存不先认为修改提示词就一定能解决。保存实例版本、模型名称、策略、工具动作名称与脱敏错误即可。分享截图时隐藏 API Key、认证头和真实客户数据测试状态码比真实业务详情更适合复现问题。最终完成标准是你能解释每次未调用的原因并能对必须执行的步骤给出工具记录。若业务要求确定执行把它表达在工作流里若业务需要动态选择给 Agent 清晰能力和任务再以轨迹验收其选择。参考资料AgentDify更新于 2026-08-27本文限定经典节点。Tool NodeDify更新于 2026-07-02。访问于 2026-10-15。
阅读完成 · 觉得有帮助？
