意图分组工具

定义

设计 Agent 工具集时按用户意图组合，而非按 API 端点一对一映射。工具数量更少、描述更丰富，让 Agent 在两三次调用内完成任务，而不是把多个原语拼起来。

要点

• 反面教材：把 API 一对一搬进 MCP 服务器（"把 REST 端点直接生成工具"是新手陷阱）
• 正面例子：单个 create_issue_from_thread 胜过 get_thread + parse_messages + create_issue + link_attachment
• 设计准则：少而准比多而全更可靠；工具的 schema 应表达任务的边界，而非系统的边界
• 何时不适用：当系统表面非常大（数百到数千端点），改用代码编排型MCP策略

示例

支持多种附件来源的工单系统：与其暴露 5 个细粒度工具，不如做 1 个 create_ticket_with_context(thread_id, attachments, priority)，让 Agent 一次调用完成，内部由服务器编排子操作。

相关概念

• MCP
• 代码编排型MCP - 表面太大时的替代策略
• 渐进式披露
• Agent-CLI设计

参考资料

• Anthropic Engineering: writing-tools-for-agents
• Anthropic Engineering Blog: Building agents that reach production systems with MCP