塔斯娱乐资讯网

Agent开源 API管理组件

Agent开源 API管理组件Apicurio Registry 是一款开源服务,用于存储和管理 API 设计文档与各类规约文件,支持 OpenAPI、AsyncAPI、Avro、JSON Schema、Protobuf 等格式。应用程序可通过 REST API 在运行时共享、更新和拉取规约版本,保障生产者与消费者之间的数据规约同步,减少重新部署的需求。它支持多种存储方案,包括内存存储、SQL 数据库、KafkaSQL,可在 Docker 或 Kubernetes 环境中部署。对你而言,这意味着规约变更更安全、版本管理更简便、开发效率更高。
Apicurio Registry 本质上是一个 API 和 Schema 注册中心,但它现在已经开始支持 AI Agent 注册与发现,包括 MCP Server、MCP Tools 和 A2A Agent Card。
这意味着它不仅能管理传统软件接口,也开始涉足多 Agent 系统的基础设施。
一、Apicurio Registry 是什么?
它主要解决一个问题:
当系统中存在大量 API、消息数据结构、MCP 工具和 Agent 时,如何统一注册、管理版本,并让其他系统找到和理解它们?
例如,现在有:
Bugzilla Agent:读取和提交 Bug。GitHub Agent:访问代码、Issue 和 PR。Testing Agent:执行测试。Coding Agent:修改代码。Plane Agent:操作项目管理看板。这些 Agent 分别具备什么能力、提供什么接口、接口发生了什么变化,都需要一个可管理的地方。
Apicurio Registry 可以承担其中的能力描述和接口契约注册部分。
二、它的主要功能功能
具体作用
API 注册
管理 OpenAPI 等接口定义
Schema 管理
管理 JSON Schema、Avro、Protobuf 等数据格式
版本管理
保存接口或数据结构的不同版本
兼容性检查
识别 Schema 修改是否破坏已有消费者
Agent 注册(实验性)
管理 A2A Agent Card 等描述
MCP 发现(实验性)
登记 MCP Server 和工具,支持发现
身份认证
可对接 OIDC,包括 Keycloak
其中最值得你关注的是最近新增的 AI Agent Registry 功能。
官方 README 已经提供专门的实验性 Docker Compose 示例,说明这并不只是一个未来规划,而是已经有可以运行的原型。不过它仍然标注为实验性功能,不能直接视为生产成熟。
三、最新的 AI Agent Registry 功能我进一步查看了它专门的 AI Agent 示例代码,发现官方已经实现了以下注册类型:
注册对象
示例
用途
MCP_SERVER
weather
登记 MCP 服务
MCP_TOOL
weather.get_forecast
登记工具及其接口定义
AGENT_CARD
translator-agent
描述 Agent 的身份与能力
PROMPT_TEMPLATE
support-reply
管理提示词模板
还有一个值得关注的功能:兼容性规则。
例如一个 MCP Tool 的输入格式升级时,可以通过 BACKWARD 规则检查接口是否保持向后兼容,降低 Agent 因工具接口变化而发生调用错误的风险。
它的工作方式可以理解为:

这里要注意:Apicurio 负责的是能力目录和契约管理,不是实际执行 Agent 任务的调度系统。
四、与 Agent Collaboration Hub 的关系这是我认为最有价值的部分。
能力
Apicurio Registry
Agent Collaboration Hub
Agent 身份与能力目录
有,实验性
可以集成
MCP 工具注册
有,实验性
可以集成
API / Schema 版本
强项
建议借用
Agent 消息通信
不是核心功能
核心功能
Agent 任务调度
不负责
核心功能
Plane 项目管理
不内置
计划集成
Bugzilla / GitHub 同步
不内置
计划集成
Agent 执行审计
非主要用途
核心功能
两者不是竞争关系,而是可以互补。
Agent Collaboration Hub 继续负责团队协作、任务管理、事件流和 Agent 执行。mcp-relay 继续负责 MCP 通信、身份授权和工具调用代理。Apicurio Registry 可以作为独立的能力目录和契约注册组件,供前两者调用。不建议直接将整个 Hub 改造成 Apicurio,也不建议立即引入一个新的生产服务。
五、可以先自己部署试试官方提供了完整的 AI Agent Registry 演示环境,包含 PostgreSQL、Registry API、Web UI 和示例数据。
git clone 项目仓库
cd apicurio-registry

docker compose -f \
distro/docker-compose/ai-agent-registry/docker-compose.yml up -d启动后,在运行 Docker 的本机访问:
地址
用途
http://localhost:8888
Web 管理界面,包含 Agents 标签页
http://localhost:8080/apis/registry/v3
Registry REST API
http://localhost:8080/.well-known/ard.json
Agent Registry Discovery 目录
注意:这个官方示例没有身份认证,使用固定演示数据库密码,且绑定本机端口,只适合本地测试。不能直接暴露到你的公网 VPS。
六、商业使用与安全性项目采用 Apache License 2.0,通常允许商业使用、修改和集成到闭源产品,但再分发时需要遵守许可证、版权及 NOTICE 等要求。
另外,它支持 OIDC 认证,与现在使用的 Keycloak 技术体系是兼容的。不过,正式集成时仍然需要设计项目级权限、Agent 凭据和接口访问控制,不能简单把 OIDC 登录等同于完整的多租户隔离。
七、一点点建议优先借鉴:Schema 版本管理和 Agent 能力目录
这是最适合当前项目、也最容易形成实际价值的两部分。
先做独立 PoC
注册 3 个现有 Agent,例如 Coding、Testing、Bugzilla,再让 Hub 查询并展示它们的工具能力和版本。
生产环境暂不依赖其实验性 Agent 功能
保持 Hub 自有任务和能力数据模型,预留 Registry Adapter,验证成熟后再决定是否纳入基础设施。
最终判断:Apicurio Registry 是 Agent Collaboration Hub 很值得研究的一个基础设施组件,但并不是完整的 Agent 协作平台。
Github搜索apicurio-registry