自定义工具概述

什么是自定义工具

在数据智能平台中，自定义工具是构建智能体（Agent）应用的核心能力，为上层Agent与工作流编排提供统一的工具元数据与调用能力，帮助大模型突破自身知识限制，调用企业内部API、执行业务逻辑，实现与外部系统的交互。

自定义工具是将多个相关API接口封装为统一的技能组，其中每个API调用可被视为一项具体技能。例如，创建“订单管理”自定义工具，为其接入“创建订单”、“查询订单”、“取消订单”等多个API，大模型在调用时可根据用户意图选择该工具中合适的API执行。

自定义工具在智能问答与应用开发中的应用

自定义工具作为技能组，支持在多类业务场景中灵活调用，包括智能体问答、智能体技能扩展及工作流编排等。

• 智能体问答：在对话交互中可直接被选中调用，实时响应业务需求。例如，用户在对话中提问“北京明天天气怎么样”，智能体自动调用天气查询工具获取实时天气数据并组织回答，无需人工跳转查询。
• 智能体技能：作为智能体的扩展能力，使其能够执行特定业务操作。例如，为售后智能体配置工单管理工具（含创建工单、查询工单状态、关闭工单等API），当用户反馈产品故障时，智能体可自动创建工单并反馈工单编号，实现问题受理的自动化。
• 工作流编排：作为工作流中的标准化工具节点，参与复杂任务的自动化执行流程。例如，在订单审批工作流中，审批通过时自动调用订单管理工具的“更新订单状态”API，将订单状态变更为“已确认”，实现审批与业务系统操作的自动联动，无需人工切换系统的手动操作。

自定义工具来源

支持接入数据智能平台进行统一管理的自定义工具API有两种，包括外部API与开发自定义API工具。

• 集成外部API：第三方或内部API工具，如必应搜索、天气查询、企业通讯录等。
• 开发自定义API工具：企业基于OpenAPI规范自主开发的API工具。OpenAPI是一种用于描述RESTful API接口的规范文档格式，定义了接口的路径、请求方法、参数和响应结构，使工具能够自动解析并识别API信息。

自定义工具接入调试流程

本流程为您提供从自定义工具创建、接入API到验证调试的全流程操作指导，整体流程为：创建自定义工具->为自定义工具接入API->调试工具API验证连通性。

图1 自定义工具接入验证测试流程