# 工具调用与 AI Agent 模型指南

Agent 的核心不是会调用工具，而是受控循环：结构化 schema、最小权限、状态、幂等、超时、人工确认、审计和可回放评测。

## Agent 的最小结构

一个 Agent 循环包含目标与状态、模型决策、结构化工具调用、工具结果和终止条件。模型只提出调用，应用负责验证、授权、执行与记录；任何自然语言都不能直接变成高权限命令。

## 工具设计

工具 schema 要小而明确，枚举危险选项，限制字符串长度和资源范围。读写工具分离，高风险操作使用预览/确认两阶段；所有网络目标、文件路径、金额和收件人都在服务端重新校验。

## 状态与恢复

为每轮设置 token、时间、工具次数和费用上限，持久化可恢复状态和幂等键。处理超时、部分成功、重复回调、工具不可用和模型切换，并提供人工接管与取消。

## 如何评测

用可回放轨迹统计任务成功、错误工具、越权尝试、循环、人工介入、延迟与成本。测试提示注入、伪造工具结果、数据外传和删除操作；不要只评最终文字是否好看。

## 上线原则

默认最小权限和拒绝未知工具，敏感操作必须确认。记录模型版本、提示、工具参数、结果和决策原因，并对日志中的密钥与个人数据脱敏。

## 适用场景

- 多步骤执行
- 工具调用
- 长程研究和编码

## API 路径

- /v1/responses
- /v1/chat/completions
- /v1/messages

## 关联指南

- [OpenAI GPT 与 o 系列](https://api.tu-zi.com/docs/models/openai-gpt): 截至 2026-08-08，OpenAI 官方以 GPT-5.6 Sol、Terra、Luna 分别覆盖复杂专业任务、能力成本平衡和高吞吐场景，并通过 Responses API 提供。
- [Anthropic Claude](https://api.tu-zi.com/docs/models/claude): 截至 2026-08-08，Anthropic 官方以 Fable 5、Opus 5、Sonnet 5 和 Haiku 4.5 分别覆盖最高能力、复杂 Agent、平衡型与低延迟任务。
- [Google Gemini](https://api.tu-zi.com/docs/models/gemini): Gemini 是 Google 的多模态家族，官方目录按通用推理、低延迟、图像、视频、音频、Embedding 与 Agent 等任务列出独立型号和方法。
- [智谱 GLM](https://api.tu-zi.com/docs/models/glm): 智谱官方当前推荐 GLM-5.2 处理长程文本与 Coding、GLM-5V-Turbo 处理视觉 Coding、GLM-Image 处理图像生成，并提供多类专用模型。
- [OpenAI 兼容 API 调用指南](https://api.tu-zi.com/docs/api/openai): 本站 OpenAI 兼容接口使用 Bearer 令牌；Responses、Chat Completions 与媒体端点拥有不同对象和流式语义，需按目标模型选择。

## 常见问题

### 模型返回 tool_call 是否表示工具已经执行？

通常不表示。模型只提出工具名和参数，应用必须校验 schema、权限与副作用后执行，再把结果回传；部分厂商服务端工具会返回已执行结果，应按响应 type 区分，避免重复执行。

### 怎样防止 Agent 无限循环并持续消耗 token 和费用？

为每次运行设置 token、时间、工具次数、并发和费用上限，定义成功与停止条件，持久化状态和幂等键。重复失败时应降级、人工接管或终止，而不是无界重试。

### 如何评测 Agent，最终答案正确就够了吗？

不够。要回放完整轨迹并统计任务成功、错误工具、越权尝试、循环、人工介入、延迟和总成本，同时测试提示注入、伪造工具结果、数据外传和取消恢复。

### Agent 可以直接访问生产数据库、文件系统和任意网址吗？

不应该。采用最小权限，分离读写工具，限制路径、网络目标、金额和收件人；高风险写操作使用预览加确认。日志中的密钥和个人数据要脱敏，并支持审计和撤销。

## 参考来源

- OpenAI Function Calling: https://developers.openai.com/api/docs/guides/function-calling
- Anthropic Tool Use: https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview

## 文档来源

来源: https://api.tu-zi.com/docs/use-cases/agents

核验日期: 2026-08-08

本文为文档接入参考。厂商原生接口与本站接口可能不同；请结合对应 API Reference 和模型广场确认本站地址、鉴权、模型 ID、分组与参数。本文不表示所有模型或上游服务均已通过实时调用验收。仅包含文档与示例，不包含当前用户的密钥或请求记录。