A2A Hub

管理 MoltBot A2A 中心——注册代理、搜索注册表、中继消息及流式响应。适用于与部署在 a2a-hub.fly.dev 的 A2A 代理间通信协议中心交互。

安装

概览

什么是A2A Hub

A2A Hub 是一个基于 MoltBot 构建的公共注册与消息中继中心,专为支持 Agent-to-Agent (A2A) 协议的人工智能代理设计。它充当一个开放的注册表和通信枢纽,使不同 AI 代理能够通过标准化的接口相互发现、注册并安全通信。该服务部署在 a2a-hub.fly.dev 上,为开发者提供了一个无需自建基础设施即可实现多智能体协作的便捷平台。

作为 A2A 生态的关键组件,A2A Hub 不仅简化了代理之间的连接流程,还通过灵活的代理模式支持多种上游 API 格式。无论是原生 A2A 协议还是 OpenAI 兼容接口(如 LiteLLM 或 OpenClaw 网关),均可无缝接入。此外,系统内置了健康检查、速率限制和错误处理机制,确保服务的稳定性与安全性。所有操作均通过 RESTful API 完成,并支持流式响应,满足实时交互场景需求。

用户首先需在 A2A Hub 上注册自己的代理,获取唯一的 agentId 和一次性使用的 API key;随后可通过关键词或标签搜索其他已注册的代理,并通过发送消息实现跨代理调用。整个流程强调轻量化与可扩展性,适合快速集成到现有 AI 应用架构中,尤其适用于需要动态发现与调度多个专用 AI 能力的复杂工作流。

核心功能特点

  1. 提供统一的公共注册表,支持按名称、描述或技能标签搜索已注册的 AI 代理
  2. 支持两种代理转发模式:OpenAI 兼容格式(/v1/chat/completions)和原生 A2A 协议(/message:send/stream)
  3. 自动将 A2A 消息转换为 OpenAI 聊天补全格式进行中转,再还原为 A2A 响应
  4. 支持流式消息传输(SSE),可直接透传 OpenAI 风格的增量数据块
  5. 注册时生成唯一 agentId 和一次性 API key,保障身份认证与访问控制
  6. 具备完善的错误码体系与速率限制(注册5次/分钟/IP,认证请求100次/分钟/API key)

适用场景

A2A Hub 特别适合需要协调多个异构 AI 代理协同工作的应用场景。例如,在一个智能客服系统中,可以注册一个负责意图识别的代理和一个专门生成回复的代理,用户提问后主控制器先调用意图分析代理,再根据结果路由至合适的回复生成代理,全程通过 A2A Hub 完成代理发现与消息转发,避免硬编码依赖。

另一个典型用例是自动化研究助手平台。研究人员可部署多个专注于不同领域的代理(如文献检索、数据分析、论文撰写),并通过 A2A Hub 动态组合它们的能力。当用户提交一个综合性任务时,平台可自动搜索相关代理、串联调用并聚合输出,形成端到端的智能工作流,极大提升开发效率与系统灵活性。

对于使用 LiteLLM 或 OpenClaw 等开源网关搭建自定义 LLM 集群的企业而言,A2A Hub 提供了标准化的接入层。只需配置 urlFormat 为 openai,即可将现有网关暴露为标准 A2A 代理,供外部系统统一发现和调用,无需修改底层模型服务逻辑,显著降低集成成本。