API打包

更新时间:
复制为 MD 格式

通过API打包功能,您可以将多个不同类型的工具(MCP Server、RESTful API)统一打包成一个MCP服务,对外提供统一的访问入口。这样可以实现零改造快速接入存量API,同时减少Agent访问多个工具时的网络和资源开销。

功能介绍

API打包支持以下三种类型的工具接入:

工具类型

说明

适用场景

MCP Server

标准MCP协议服务

原生MCP工具、AI模型服务

RESTful API

基于OpenAPI规范的REST接口

企业内部API、第三方SaaS服务

自定义工具

引用已有的Toolset配置

工具复用、组合编排

典型场景

快速打通Agent与存量API

无需修改现有API,只需提供OpenAPI规范,平台会自动处理RESTMCP的协议转换,实现零改造的快速接入。

  • 企业内部的RESTful API(如CRM、ERP系统)转换为MCP工具

  • 将第三方SaaS服务的OpenAPI接口包装为MCP Server

  • 快速为Agent提供业务系统的数据访问能力

提升工具复用性与系统性能

将多个独立的工具组合成一个统一的MCP Server,实现一次配置,统一管理多个工具;同时Agent只需连接一个MCP Server即可使用所有工具,显著降低网络和资源开销。

  • 将搜索、计算、数据查询等多个工具打包为"AI助手工具集"

  • 为不同业务场景组合定制化的工具组合

  • 构建企业级的统一工具服务网关

创建API打包工具

  1. 登录AgentRun控制台

  2. 在顶部菜单栏,单击其他

  3. 在左侧导航栏,单击工具管理

  4. 单击创建工具

  5. 选择创建方式区域,选择API打包

  6. 配置基本信息。

    参数

    说明

    工具名称

    工具的唯一标识。必须以字母或下划线开头,包含字母、数字、下划线和连字符。

    工具描述

    描述工具的功能和用途,便于后续管理和使用。

  7. 配置打包方式。根据您的需求选择以下任一方式:

  8. 配置网络类型(可选)。

    参数

    说明

    允许访问VPC

    开启后,工具可以访问指定VPC内的资源。需要配置专有网络、交换机和安全组。

    允许默认网卡访问公网

    开启后,工具可以通过默认网卡访问公网。默认开启。

  9. 配置访问凭证(可选)。

    目前工具仅支持API Key类型的凭证。您可以选择匿名访问或添加凭证来控制工具的访问权限。

  10. 单击创建工具,等待工具创建完成。

打包方式

选择已有API

选择平台上已导入的FunctionCall工具进行打包。

  1. 打包方式区域,选择支持API

  2. API列表中,选择要打包的API端点。

    说明:打包的API需要使用相同的凭证。

  3. 完成其他配置后,单击创建工具

选择已有MCP

选择平台上已导入的MCP工具进行打包。

  1. 打包方式区域,选择支持MCP

  2. MCP配置列表中,选择要打包的MCP配置。

    说明:打包的MCP需要使用相同的凭证。

  3. 完成其他配置后,单击创建工具

API导入

直接导入MCP配置或OpenAPI规范来创建打包工具。

导入MCP端点

  1. 打包方式区域,选择API导入

  2. 导入类型下拉列表中,选择MCP端点

  3. 根据MCP服务器的部署方式,选择远程本地

    远程MCP

    远程MCP通过网络连接到MCP服务器,支持SSEStreamable HTTP两种协议。

    MCP配置文本框中,输入MCP配置JSON。示例如下:

    {
      "mcpServers": {
        "server-name": {
          "transportType": "sse",
          "url": "https://your-mcp-server.com/sse"
        }
      }
    }
    

    本地MCP

    本地MCP通过npxuvx命令启动MCP服务器,使用stdio协议通信。

    MCP配置文本框中,输入MCP配置JSON。示例如下:

    {
      "mcpServers": {
        "server-name": {
          "command": "npx",
          "args": ["@your-org/mcp-server"],
          "env": {
            "API_KEY": "your-api-key"
          }
        }
      }
    }
    
  4. (可选)单击新增配置项,添加更多MCP配置,实现多工具组合。

  5. 完成其他配置后,单击创建工具

导入API端点

  1. 打包方式区域,选择API导入

  2. 导入类型下拉列表中,选择API端点

  3. 通过以下任一方式导入OpenAPI规范:

    • URL导入:在OpenAPI规范URL文本框中输入OpenAPI规范的URL地址,单击导入

    • 直接粘贴:在或直接粘贴OpenAPI/Swagger规范文本框中,粘贴OpenAPI/Swagger JSONYAML内容。

    说明:支持OpenAPI 3.0规范。

  4. 完成其他配置后,单击创建工具

实践教程

RESTful APIMCP

将存量的RESTful API转换为MCP Server,实现AgentAPI能力的快速打通。

  1. 在创建工具页面,选择API打包方式。

  2. 打包方式区域,选择API导入

  3. 导入类型下拉列表中,选择API端点

  4. 或直接粘贴OpenAPI/Swagger规范文本框中,粘贴您的OpenAPI规范。示例如下:

{
  "openapi": "3.0.0",
  "info": {
    "title": "示例 API",
    "version": "1.0.0",
    "description": "这是一个示例 API"
  },
  "servers": [
    {
      "url": "https://api.example.com/v1"
    }
  ],
  "paths": {
    "/users": {
      "get": {
        "summary": "获取用户列表",
        "operationId": "getUsers",
        "responses": {
          "200": {
            "description": "成功返回用户列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": { "type": "string" },
                      "name": { "type": "string" },
                      "email": { "type": "string" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
  1. 如果API需要在特定VPC下访问,开启允许访问VPC并配置相应的网络设置。

  2. 配置入站访问凭证,让MCP Server自带鉴权能力。

  3. 单击创建工具,等待创建完成。

多工具组合

将多个工具组合成一个MCP Server,提升操作便捷性并降低网络开销。

  1. 在创建工具页面,选择API打包方式。

  2. 打包方式区域,选择API导入

  3. 导入类型下拉列表中,选择MCP端点

  4. 选择本地方式,填写第一个MCP ServerJSON安装配置。

  5. 单击新增配置项,添加第二个MCP Server的配置。

  6. 重复步骤5,从下往上添加更多MCP Server(如需要)。

    高德地图MCP服务,可从高德平台创建并获取具体的api-key。

    {
      "mcpServers": {
        "amap-maps": {
          "args": [
            "-y",
            "@amap/amap-maps-mcp-server"
          ],
          "env": {
            "AMAP_MAPS_API_KEY": "9******0"
          },
          "command": "npx"
        }
      }
    }

    时间查询服务

    {
      "mcpServers": {
        "time": {
          "args": [
            "mcp-server-time"
          ],
          "command": "uvx"
        }
      }
    }

    思维链工具:

    {
      "mcpServers": {
        "sequential-thinking": {
          "args": [
            "-y",
            "@modelcontextprotocol/server-sequential-thinking"
          ],
          "command": "npx"
        }
      }
    }
  7. 单击右上角的创建工具,等待安装完成。

  8. 创建完成后,您可以通过快速创建一个Agent,配置刚创建的组合工具进行测试。测试时,观察一个MCP Server可以同时输出多个MCP Server的结果。

    image

常见问题

打包的API/MCP为什么需要使用相同的凭证?

为了确保安全性和访问控制的一致性,打包在一起的APIMCP需要使用相同的凭证。这样可以统一管理访问权限,避免凭证混乱。

如何选择远程MCP和本地MCP?

  • 远程MCP:适用于已部署在云端或服务器上的MCP服务,通过网络连接访问。

  • 本地MCP:适用于需要在运行时动态启动的MCP服务,通过npxuvx命令启动。

API打包后如何测试?

创建工具完成后,您可以:

  1. 进入工具详情页查看MCP端点信息。

  2. 快速创建一个Agent,配置刚创建的工具。

  3. Agent中执行测试,验证工具是否正常工作。