大家好，随着智能体生态系统的持续扩张，我们注意到一个Agent 生态开发的问题：当你可能拥有一个API或者是专有的Dataset，但为了使其能在不同的Agent 和用户以各种方式接入比如 Agent的命令行CLI，MCP，本地Skills库，路由的REST API等。如果要是考虑变成语言的SDK（Python / TypeScript），那

尤其是当你想要升级时，你需要对所有的Distribution的包进行升级，非常痛苦

。这里介绍一个更简单的方案，对于已经有API的开发者来说维护一个稳定API，通过

 OneKey Gateway注册一个 Agent的API Registry

的Agent 流量接入转化Converter到你的API

API2MCP，API2CLI，API2Skills，API2RestAPI

的各类格式转化。你只需要维护一个API/数据，用户/智能体就能以各种格式使用它。

https://github.com/aiagenta2z/onekey-gateway

你只需要：准备好你的API → 准备 agent.json 文件和api的meta (可以codex 等自动生成)→ API Registry 注册中心Host → 完成。

不用再发布任何的包，然后用户可以通过：- CLI， Skills，- MCP，REST Router 等方式使用你的API -> 路由到你的API.

例子：API2MCP，API2CLI，API2Skills，API2Rest

## api to CLI
npx onekey agent <unique_id> <api_id> $data_json

## api to skills
npx agtm skills build <unique_id>

### api to MCP
npx onekey mcp <unique_id>

### api to router REST
curl -X POST "https://agent.deepnlp.org/agent_router" -H "Content-Type: application/json" -H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" -d '{"unique_id":"<unique_id>","api_id":"<api_id>","data":{}}'

USDA美国农业部的食品营养nutrition的

  （支持GET/POST并且有access key验证Open API），利用 agtm 包管理工具 (agent manager) 注册后，就可以使用了哈。

curl -XPOST -H "Content-Type:application/json" -d '{"pageSize":25}' https://api.nal.usda.gov/fdc/v1/foods/list?api_key=DEMO_KEY``

格式：npx onekey agent <unique_id> <api_id> $data_json

npx onekey agent fdcnal/usda-fooddata-central-agent search_foods '{"query": "Cheddar Cheese","pageSize": 10}'```

API2Skills：用户本地Agent环境拉取你的API meta，构建Skills，包含OneKey 验证

格式：npx agtm skills build <unique_id>

npx agtm skills build fdcnal/usda-fooddata-central-agent

执行之后就会返回一个 skills/yourskill/SKILL.md /scripts等文件

用户Agent通过添加StreamingHttpServer来验证

npx onekey mcp fdcnal/usda-fooddata-central-agent

API2RestAPI：原始API转化为OneKey Gateway 统一路由的API，支持调用量监控

例如请求 search_foods 搜索食物卡路里的API

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ROUTER_KEY
curl -X POST "https://agent.deepnlp.org/agent_router" -H "Content-Type: application/json" -H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" -d '{"unique_id":"fdcnal/usda-fooddata-central-agent","api_id":"search_foods","data":{"query":"Cheddar Cheese","pageSize":10}}'

2. 具体API转化为Agent接入格式的步骤

让我们看看如何注册和转换一个食品营养API：

api_list:
  - api_id: search_foods
    protocol: http
    description: Search for food items and calories
    endpoint: https://api.nal.usda.gov/fdc/v1/foods/search
    method: POST
    params:
      query: str
      pageSize: int
    auth:
      type: API_KEY
      header: "X-Api-Key"
      value: $YOUR_FDC_API_KEY

不想手写的同学可以直接利用codex/Claude Code描述和生成，利用这个prompt，在Github代码库的examples下面的例子作为格式的模板

Generate agent.json and agent.yaml file following the format of ./examples/usda_food_api/agent.json and agent.yaml format, fill in the api_list key, with meta of APIs: api_id,protocol,description,endpoint,method,params,auth, For params, you can read the necessary informations from the the OpenAPI specs of fdc_api.json. Output to /agent.json or /agent.yaml formats

获取你的OneKey Gateway API的注册管理密钥 

export AI_AGENT_MARKETPLACE_ACCESS_KEY=YOUR_REGISTRY_KEY
npx agtm upload --config ./agent.yaml

你的智能体的唯一ID格式是 user_id/repo_name，例如：

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ROUTER_KEY

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "fdcnal/usda-fooddata-central-agent",
  "api_id": "search_foods",
  "data": {"query": "Cheddar Cheese","pageSize": 10}
}'

搜索 search_foods，Cheddar Cheese的营养配料表

npx onekey agent fdcnal/usda-fooddata-central-agent search_foods '{"query": "Cheddar Cheese","pageSize": 10}'


export AI_AGENT_MARKETPLACE_ACCESS_KEY=YOUR_REGISTRY_KEY
npx agtm skills build fdcnal/usda-fooddata-central-agent

用户本地项目目录下创建的 Skills目录，可以参考

skills/fdcnal-usda-fooddata-central-agent/
  ├── SKILL.md
  ├── scripts/
  └── reference/

执行命令行，然后把 mcp 配置添加到 mcp.config里面

https://www.producthunt.com/products/ai-agent-a2z?launch=onekey-agent-gateway

大家好，随着智能体生态系统的持续扩张，我们注意到一个Agent 生态开发的问题：当你可能拥有一个API或者是专有的Dataset，但为了使其能在不同的Agent 和用户以各种方式接入比如 Agent的命令行CLI，MCP，本地Skills库，路由的REST API等。如果要是考虑变成语言的SDK（Python / TypeScript），那需要维护5-10个版本的Agent接入API的方式，就更加复杂了。尤其是当你想要升级时，你需要对所有的Distribution的包进行升级，非常痛苦。这里介绍一个更简单的方案，对于已经有API的开发者来说维护一个稳定API，通过 OneKey Gateway注册一个 Agent的API Registry, 然后平台负责把各种格式的Agent 流量接入转化Converter到你的API，实现了从 API2MCP，API2CLI，API2Skills，API2RestAPI的各类格式转化。你只需要维护一个API/数据，用户/智能体就能以各种格式使用它。

一键把任意API转为Agent需要格式CLI/MCP/Skills使用格式-基于OneKey Gateway的Converter

一键把任意API转为Agent需要格式CLI/MCP/Skills使用格式-基于，为了使其能在不同的Agent 和用户以各种方式接入比如 Agent的命令行CLI，MCP，本地Skills库，路由的REST API等。如果要是考虑变成语言的SDK（Python / TypeScript），那需要维护5-10个版本的Agent接入API的方式十分痛苦。

开发工具

后端

低代码

OneKeyGateway简化Agent生态开发，通过统一API注册中心实现多格式接入转换。开发者只需维护一个API，即可支持CLI、Skills、MCP、REST等多种接入方式，无需维护多个版本SDK。提供API2CLI、API2Skills等转换功能，大幅降低API接入复杂度，提升开发效率。

TypeScript

智能体

路由

Python

Agent

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

一键把任意API转为Agent需要格式CLI/MCP/Skills使用格式-基于OneKey Gateway的Converter

一键把任意API转为Agent需要格式CLI/MCP/Skills使用格式-基于OneKey Gateway的Converter

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐