Fri Jul 24 2026 08:00:00 GMT+0800 (China Standard Time)·2 min readAI Architecture吃透 AI Agent 开发
Tool System
一次 Tool Call 的完整生命周期
从模型提出调用到业务返回 observation，中间至少有解析、鉴权、执行、超时和审计几个阶段。
#Tools#MCP#Security
Tool Call 不是模型和函数之间的直连。运行时需要先解析模型输出，确认工具存在，再校验参数和权限，建立调用上下文，执行工具，最后把可供模型继续判断的结果写回消息历史。
需要记录什么
每次调用至少记录 traceId、agentId、toolName、参数摘要、租户、开始和结束时间、结果状态以及错误类型。敏感参数不能原样打日志，长结果也应截断并保留对象引用。
项目落点
Agent 共享集群用 Gateway 和 MCP Server 承担统一鉴权、日志和配额。业务工具只关注领域逻辑，调用链的通用治理被放在中间层，便于后续审计和统计。
结论
把 Tool Call 当成一次有边界的业务交易来设计，系统才有机会在复杂任务中保持可追踪。