为 Agent 工具调用写一条可读的状态行
【摘要】 当一个 Agent 同时调用多个工具时,最难回答的问题往往不是“结果对不对”,而是“现在卡在哪一步”。日志很多,却没有一行能让人一眼看懂当前状态。本文给出的做法很简单:为每一次工具调用维护一条可读的状态行。 状态行只写三件事当前步骤:正在做什么,例如“正在检索知识库”。等待对象:正在等谁,例如“等待搜索工具返回”。进展与代价:已用时间、重试次数,例如“第 2 次重试,已用 8 秒”。一个可用...
当一个 Agent 同时调用多个工具时,最难回答的问题往往不是“结果对不对”,而是“现在卡在哪一步”。日志很多,却没有一行能让人一眼看懂当前状态。本文给出的做法很简单:为每一次工具调用维护一条可读的状态行。
状态行只写三件事
- 当前步骤:正在做什么,例如“正在检索知识库”。
- 等待对象:正在等谁,例如“等待搜索工具返回”。
- 进展与代价:已用时间、重试次数,例如“第 2 次重试,已用 8 秒”。
一个可用的格式是:
步骤 2/4 · 检索知识库 · 等待搜索工具 · 第 1 次重试 · 已用 6 秒
三条规则
第一,只保留一行。新的状态覆盖旧的状态,不要让状态行变成不断刷屏的日志。第二,失败时保留最后一条状态。任务结束、超时或重试耗尽后,最后的状态行应该还在,方便定位。第三,不输出密钥、Token 和完整请求参数。状态行只写步骤和结果类别,不写敏感内容。
一个小检查清单
在下一次调试多工具调用时,可以先问自己三个问题:我能在一秒内说出当前步骤吗?我知道它在等谁吗?我知道它已经重试几次了吗?如果有一个答案是否定的,就先补状态行,再去查更详细的日志。状态行不是为了好看,而是为了在出问题时少翻几页日志、少猜一次原因。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)