跳到主要内容

添加自定义工具

如果你有自己的函数、Webhook 或 API，可以把它描述成一个工具，让 AI 在对话、任务和智能体中调用。本页介绍 HTTP API 方式；如果要连接 MCP 服务器，参见添加 MCP 服务器。

打开创建工具的弹窗​

  1. 点击左侧导航栏的 …（更多），再点击 能力库。
  2. 在 工具 标签中点击 添加自定义工具。
  3. 选择 HTTP API，即描述一个 HTTP API，让它可以作为工具被调用。

添加自定义工具菜单（英文界面）：MCP server 和 HTTP API

弹窗（英文界面标题为 Create a Tool）分为两部分：工具定义和调用方式。

创建工具弹窗（英文界面），包含 JSON Schema 编辑器、View help、Generate by AI 和调用方式选项

用 JSON Schema 描述工具​

在工具定义的 JSON Schema 输入框（英文界面为 Enter JSON Schema for Tool Definition）中，写明工具做什么、需要哪些输入。格式与 OpenAI Function Calling 兼容。

  • 点击 View help 查看所需格式。
  • 点击 Generate by AI，用自然语言描述工具，由 AI 生成 JSON Schema 草稿，生成后再检查一遍。

一个好的定义能让模型更准确地使用工具：

  • 清晰的 name，以及说明工具用途和使用时机的 description。
  • parameters 与你的接口实际需要的参数完全一致，并为每个参数写上说明。
  • 接口缺少就无法工作的参数，列为 required。

选择调用方式​

在调用方式（英文界面为 Invocation Method）中选择一项：

  • GET 或 POST：ConsoleX 会把模型提供的参数发送到你的接口。按接口支持的方式选择，并按弹窗要求填写接口信息。常见做法包括调用你自己发布的函数，或调用 n8n、Dify、Make.com、Coze 等平台上的工作流（参见本节中各平台的说明）。如果你为接口添加了 API Key，ConsoleX 会把它放在请求头的 Authorization 中以 Bearer 方式发送：
Authorization: Bearer <your-api-key>
  • Use Mock Data：在真实接口还没做好之前先用模拟数据测试。适合在没有后端的情况下，先看看模型会怎样使用这个工具、后续回答的质量如何。

点击 Save 保存。工具返回的结果会交给模型，由模型据此生成回答。

使用自定义工具​

你的工具会出现在 工具 标签的 自定义 筛选中。在需要的地方开启它：

  • 在对话中：点击输入框下方的 工具，打开它的开关。用 自定义 筛选可以只看你自己的工具。
  • 在任务或智能体中：点击 添加能力，打开它的开关。

面板的用法参见使用预置工具，模型如何调用工具参见对话中的工具调用。