说明工具结果为何需要区分结构化数据、给模型阅读的说明和 isError 语义，避免把失败伪装成空结果。
这篇要解决什么
搜索这个问题的读者通常正在尝试：让智能体能够可靠消费工具结果，并让开发者能从日志判断调用是否真正失败。。先在测试环境用只读或模拟数据完成链路，再考虑接入真实业务。
按步骤完成
- 先定义业务成功时必须出现的结构化字段，例如 status、source 和 checked_at；自然语言说明只用于辅助理解。
- 遇到无权限、找不到资源或参数错误时返回可区分的错误状态，不用空数组假装查询成功。
- 客户端收到结果后先检查错误标记和结构字段，再决定是否交给模型总结；错误不应被改写成确定事实。
用一条固定消息检查链路
以下只是协议层示例，展示要记录的字段，不代表已经连到你的服务器：
{"isError":true,"content":[{"type":"text","text":"ticket not found"}]}把其中的工具名、参数和允许范围替换成自己的清单。不要把密钥、客户资料、订单号或生产地址写进演示文件。
怎样验收结果
用成功、资源不存在和权限拒绝三种响应检查客户端分支。验收要求三种状态进入不同日志和不同用户提示。
失败边界
结果格式正确不能证明数据源正确或实时。需要另外核对数据同步时间和业务权限。
依据与核验日期
以上官方资料于 2026-10-01 核对。协议、SDK 和客户端界面会更新；实施前应再次阅读对应版本的官方说明。
相关问答
工具返回成功就能说明业务完成吗？
不能。工具返回只说明该调用得到响应；涉及写入时还要核对业务系统的最终状态、权限和审计记录。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32580.html
