🧰 工具与协议
工具设计：Schema、幂等、错误与可靠性
让模型更容易选对，也让系统安全执行和恢复。
好工具的特征
- 名称是清晰动词，如
get_order、create_refund； - 一项职责，读写边界明确；
- 描述包含何时使用、何时不用和副作用；
- 参数类型严格，枚举替代自由文本；
- 输出短且结构化，包含稳定状态码。
过细会让模型规划太多步骤，过粗会把权限和错误藏进黑盒。合适粒度通常对应一个可审计业务动作，确定性细节由后端封装。
读取工具可有限重试；写工具必须有幂等键；超时区分确定失败与结果未知；错误分 validation、permission、not_found、temporary、conflict；并行只用于无依赖、无写冲突的调用。