添加FunctionCalling工具

本文介绍如何在工具列表页面添加 Function Calling（函数调用）工具。Function Calling 工具通过定义 API 接口规范，使支持 Function Calling 能力的大模型能够理解并调用外部 API 服务。

核心概念

• Function Calling：一种让大模型理解并调用外部 API 的能力，通过定义接口规范（参数、返回值等）实现模型与外部服务的交互。

• OpenAPI 规范：一种标准的 API 描述格式，用于定义 API 的端点、参数结构和返回值格式，平台据此自动生成工具定义。

进入创建页面

1. 登录智能体引擎控制台，在左侧菜单中选择工具。

2. 在工具列表页面，点击右上角的添加工具按钮。

   

配置基本信息

在弹出的添加工具对话框中，配置以下基本信息：

配置 OpenAPI 规范

在 OpenAPI规范编辑器中，粘贴符合 OpenAPI 3.0 规范的 JSON 或 YAML 配置。平台会根据 OpenAPI 文档自动生成对应的工具定义，包括 API 端点、参数结构和返回值格式。

以下为一个 OpenAPI 规范示例：

{
  "openapi": "3.0.1",
  "info": {
    "title": "微博热搜",
    "description": "使用微博搜索查询实时新闻消息。",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://weibo-hot-js.xxxx.run"
    }
  ],
  "paths": {
    "/hot": {
      "get": {
        "summary": "获取热搜列表",
        "operationId": "getHotList",
        "responses": {
          "200": {
            "description": "成功返回热搜列表"
          }
        }
      }
    }
  }
}

OpenAPI 文档中需正确定义 paths 和 servers 字段，以便平台解析 API 端点和服务地址。

配置访问凭证

完成创建

点击添加按钮完成 FunctionCalling 工具的添加。

常见问题

导入 OpenAPI 规范失败怎么办？

• 确认 OpenAPI 文档符合 3.0 规范。

• 检查 paths、servers 等必要字段是否定义完整。

• 确认 servers 中的 URL 地址可以正常访问。

工具调用失败怎么办？

• 确认 API 服务的地址和端口可正常访问。

• 确认访问凭证配置正确，API 服务端已授权。

• 检查 OpenAPI 规范中定义的路径与方法是否与实际 API 一致。

凭证下拉框中没有可选凭证怎么办？

• 点击创建凭证快捷跳转至凭证管理页面，创建新的凭证后再返回工具创建页面。

• 详情请参考 身份凭证管理。