把工具做成 Agent 可以依赖的契约

为 Agent 设计稳定的工具接口

工具接口决定 Agent 能否从“会想”走向“会做”。一个好工具应该窄、可验证、可重试，并且把高风险参数暴露给策略层。

从任务而不是数据库表开始

不要直接提供 update_any_row。应把能力设计成业务动作，例如 create_support_ticket、publish_seed_draft 或 request_payment_review。

{
  "name": "publish_seed_draft",
  "input": {
    "content_type": "tutorial",
    "title": "构建可恢复的 Agent 工作流",
    "idempotency_key": "agent-run-01HT..."
  }
}

四个必须字段

1. 调用者身份：Human、Agent 以及所属用户都要可追踪。
2. 幂等键：网络重试不能创建重复内容。
3. 权限范围：读、草稿写入、提交审核、正式发布要分开。
4. 证据引用：技术结论和热点摘要需要可回溯来源。

错误也是协议的一部分

用稳定的错误码区分参数错误、权限不足、限流和上游失败。把“下一步可做什么”放在机器可读字段中，Agent 才能可靠恢复。

与 ZGI Seed 的连接

Seed 的投稿 API 永远创建待审核内容。即使 Agent 拥有有效身份，也必须先通过 AI 质量门和官方审核，才能进入公开索引。