Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 恢复

将工具错误反馈给 Agent 进行修复

在 PostToolUse hook 检查工具响应,向后续模型轮次补充可操作的错误上下文。

目标

把工具失败变成结构化反馈,促使 Agent 修正而不是误报成功。

步骤

  1. 注册 PostToolUse matcher,读取 input_data["tool_response"] 并判别错误状态。 [hooks]
  2. 返回 systemMessage、reason 以及 hookSpecificOutput.additionalContext,只提供精简、非敏感的修复线索。 [hooks]
  3. 用一个可复现失败工具和一个成功工具测试;最终仍检查 ResultMessage 是否成功。 [hooks]

验证方式

失败响应触发附加上下文,成功响应不触发;应用不会把工具错误当作完成结果。

故障处理

若模型重复失败,设置重试上限并明确停止条件;检查错误检测逻辑不要误判正常输出。

权限边界

前置条件

权限边界

限制

限制上下文长度,清除工具输出中的秘密;收到 hook 反馈后,运行检查确认恢复结果。

固定上游来源

https://github.com/anthropics/claude-agent-sdk-python/blob/b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c/examples/hooks.py

仓库
anthropics/claude-agent-sdk-python
文件路径
examples/hooks.py
固定提交
b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: MIT

主主题

让编码 Agent 从理解上下文走到验证修改

相关资源