工具优化概述
工具优化是通过分析Agent在真实业务场景中产生的历史会话Trace和工具调用日志，自动识别工具调用过程中存在的问题，并对工具的描述文案、调用前置校验规则、接口使用限制等进行针对性优化，从而减少工具匹配错误、参数填写异常等问题，整体提升Agent的任务执行效率。
工具（Tool）是Agent可执行的最小动作单元，工具不限于插件或MCP，任何Agent可以调用的外部能力都属于工具的范畴，例如：查询订单状态、搜索网页、调用计算接口、发送消息通知等。只要Agent需要通过参数化调用获取结果的动作，都是工具优化的潜在对象。
为什么需要工具优化
模型在调用工具时，完全依赖工具的文本信息来做决策。选哪个工具、传什么参数、何时调用。如果这些文本信息存在问题，模型的工具调用行为就会出错。常见的问题包括：
| 问题类型 | 典型表现 |
|---|---|
| 工具匹配错误 | 模型在功能相近的工具之间混淆选择，例如将“查询订单状态”误用为“查询物流信息”。 |
| 接口释义模糊 | 工具描述对功能边界、适用条件的说明不清晰，模型无法准确判断何时该使用该工具。 |
| 入参规范混乱 | 参数的类型、格式、取值范围、必填/选填等约束说明不完整，导致模型传入错误参数。 |
| 调用规则不清 | 工具的调用前提条件、依赖关系、频率限制等未明确说明，导致调用错误。 |
这类问题的根因不在模型本身，而在工具的说明写得不够好。工具优化正是针对这类问题的解决方案，全程不改动模型，仅优化工具的配置信息，让模型能够更准确地理解每个工具的适用场景和使用规范。
工具优化覆盖以下维度，系统会根据Trace中的实际错误模式，自动判断需要优化哪些维度：
| 优化维度 | 说明 |
|---|---|
| 工具介绍文案 | 工具的名称说明和功能描述，明确工具做什么、不做什么、与其他工具的边界。 |
| 调用前置校验规则 | 调用该工具前需满足的前提条件，例如“需先完成验证”或“需先调用工具 A 获取 ID”。 |
| 接口使用限制 | 工具的调用频率限制、并发约束、数据量上限等运行约束说明。 |
支持的优化对象（智能体类型）
工具优化支持对以下类型的智能体进行优化：
| 类型 | 说明 | Trace数据来源 |
|---|---|---|
| 单智能体 | 在AgentArts平台通过低代码方式创建的单智能体 | 平台自动采集并上报，无需额外配置 |
| 智能体运行时 | 通过高代码方式在本地开发、并托管至AgentArts运行时（Runtime）的智能体 | 部署至AgentArts运行时后自动上报 |
| 第三方托管 | 在AgentArts平台以外开发和运行、通过观测OpenAPI上报Trace数据的第三方智能体 | 手动对接AgentArts观测功能后上报 |
- 如需了解高代码开发和智能体运行时的详细说明，请参考高代码开发概述、基础示例：创建基础对话智能体。
- 如需了解第三方智能体数据上报的配置方法，请参考上报第三方智能体 Trace、Metric、Log 数据。
- 无论哪种类型的智能体，轨迹分析均依赖会话Trace数据。在创建轨迹分析任务前，请确保目标智能体已在指定时间范围内产生了足够量的Trace数据，否则分析结果的覆盖度和准确性将受到影响。可在AgentArts平台“观测与优化 > 观测”功能中查看。
