tool-descriptions

作者认为，一个好的 AI agent 工具描述应当回答五个关键问题——何时使用、每个输入的含义、成功是什么样子、所有可能的错误以及权限规则——而大多数工具只涉及其中一项，迫使 agent 猜测其余部分。

我做了 riviera.so，一个让开发者编辑 AI Agent 通过 OpenAPI 或 MCP 服务器读取的工具及参数描述的工具，无需重新部署后端。它支持草稿/发布版本管理、故障排查，还能把 Agent 的错误变成工具选择测试。

作者分享了在生产环境中使用定时任务运行AI智能体一个月时遇到的四个机械故障，强调所有问题都源于设置问题，而非模型缺陷。