工具集成工程指南

Overview

Agent 如何连接工具决定了可靠性、延迟、成本、可调试性和生产事故数量。本文综合三种视角——工具集成方法、权限管理和 Artifact 管理——提供完整的工程指南。

为什么重要

工具集成是 Agent 工程化的真实成本所在——直连 API、MCP、子 Agent、计算环境七种集成方式，每种延迟成本、可观测性、权限边界差异巨大。错选集成方式 = 生产事故频发；权限策略不当 = 数据泄漏；Artifact 管理缺位 = 多轮对话状态丢失。本文给出三个维度的完整决策框架。

七种工具集成方法对比

方法	可靠性	延迟	复杂度	动态发现
MCP + SKILL.md	★★★★★	低	中	协议原生
Native Function Calling	★★★★★	极低	低	静态清单
JSON Mode + Schema	★★★★☆	极低	低	静态清单
Direct API Calling	★★★★☆	极低	很低	硬编码
Regex/Output Parsing	★★☆☆☆	近零	很低	脆弱
RAG-Based Tool Finding	★★★★☆	中	高	语义搜索
Embedding-Based Discovery	★★★★☆	中	高	动态清单

场景选择

场景	推荐方法
新生产 Agent，固定工具	Native Function Calling
企业 Agent，50+ 工具	RAG Tool Finding + Function Calling
多供应商 Agent 生态	MCP + SKILL.md
高流量分流/路由	Semantic Router

架构演进路径

• Stage 1 (PoC)：2-5 个工具，Direct API Calling 或 Native Function Calling
• Stage 2 (Production)：≤20 个工具 + SKILL.md 规则
• Stage 3 (Scaled)：RAG Tool Finding + MCP 服务器
• Stage 4 (Enterprise)：MCP + SKILL.md + Semantic Router

权限管理

六大权限类别：文件系统、网络、浏览器、通信、系统与执行、记忆。

核心原则：“如果可以读写某个位置，Agent 最终就会做到。”

永远不应在作用域内的文件：~/.ssh/、~/.aws/、含密钥的 .env 文件。

5 分钟权限审查（每周）：6 个问题，最重要的是”今天能关闭什么？“

Artifact 管理

约 90% 的 Agent 任务产出需要落盘的文件。五大类别：代码、文档、数据、视觉、配置。

关键原则：

• 维护”唯一事实来源”，即使副本存在
• 命名规范：日期戳 + 版本指示 + 描述性前缀
• 保留策略：草稿保留期、归档时机、临时文件最大存续
• 人机交接：审核就绪通知、状态指示器

See Also

• Agent 开发综合指南 — Agent 开发完整框架
• Skill 开发综合指南 — Skill 开发的详细规范