registry-broker

🔍 跨平台 AI Agent 发现与通信中枢

Hashgraph Online 官方推出的跨平台 AI Agent 发现与通信工具,支持 14 个注册表、7.2 万+ Agent 搜索与对话,助力开发者快速接入去中心化智能体生态。

收藏
4.5k
安装
1.7k
版本
v1.0.0
CLS 安全性认证2026-07-12
点击查看完整报告 >

使用说明

核心用法

Registry Broker 是一款面向 AI Agent 生态的通用发现与跨平台通信工具。用户可通过语义搜索(vector_search)或关键词搜索(search_agents)在 14 个主流注册表(包括 AgentVerse、NANDA、OpenRouter、Virtuals Protocol、PulseMCP、Near AI 等)中查找超过 72,000 个 AI Agent。找到目标 Agent 后,用户可获取其详细信息(get_agent),并通过 start_conversation 和 send_message 命令与其建立会话、持续对话,最后以 end_session 结束。此外,开发者还能通过 register_agent 将自己的 Agent 注册到指定注册表,实现生态接入。

显著优点

1. 生态覆盖广:整合 14 个主流注册表,打破平台孤岛,实现一站式 Agent 发现。
2. 语义搜索精准:支持向量语义搜索并返回相关性评分,优于传统关键词匹配。

3. 协议兼容性强:支持 20 种通信协议,适配 OpenAI、A2A、ERC-8004 等多种标准。

4. 开发者友好:纯 CLI 工具,JSON 输出便于脚本集成;TypeScript 代码结构清晰,易于二次开发。

5. 注册门槛低:支持自定义注册表接入,降低 Agent 发布门槛。

潜在缺点与局限性

1. 网络依赖重:所有功能依赖 hol.org API,离线环境完全无法使用。
2. 功能边界有限:仅提供发现与通信能力,不包含 Agent 本身的执行或托管功能。

3. 会话状态外置:会话 ID 由服务端管理,本地无持久化,异常中断可能丢失上下文。

4. 认证非强制:API Key 为可选项,未配置时可能面临限流,影响生产环境稳定性。

适合的目标群体

  • AI Agent 开发者:需要快速发现同类 Agent、研究竞品或寻找合作伙伴。
  • 去中心化应用构建者:基于 Hedera、Solana 等链上 Agent 生态开发 DApp。
  • 自动化工作流工程师:通过 CLI 将 Agent 发现与对话集成到 CI/CD 或数据处理管道。
  • AI 研究员:需要批量检索、对比不同平台 Agent 的能力与协议实现。

使用风险

1. 第三方服务可用性:hol.org 服务中断将直接导致功能失效,需评估 SLA 风险。
2. 数据隐私:对话内容经第三方服务器中转,敏感业务场景需评估合规性。

3. 依赖项维护:依赖 dotenv 等 npm 包,需关注供应链安全更新。

4. 限流与成本:高频调用可能触发限流,生产环境建议配置 API Key 并实施调用频率控制。

安全解读

核心用法

registry-broker 是一个轻量级 TypeScript CLI 工具,专注于 AI Agent 的全生命周期管理:

  • 智能发现:支持语义向量搜索(vector_search)与传统关键词搜索(search_agents),覆盖 AgentVerse、NANDA、OpenRouter、Virtuals Protocol、PulseMCP、Near AI 等 14 个主流注册表
  • 即时通信:通过 start_conversationsend_message 与任意 Agent 建立会话,支持会话历史查询与优雅结束
  • 注册发布:提供标准化接口将自研 Agent 注册到指定注册表,需配置名称、描述、能力、端点 URL 和通信协议
  • 元数据管理:可查询注册表列表、支持协议(20 种)、平台适配器及实时统计数据

典型工作流
1. 语义搜索目标 Agent → 2. 获取 UAID 详情 → 3. 发起对话并持续交互 → 4. 结束会话或长期订阅

显著优点

  • 生态整合度极高:一站式打通 14 个异构注册表,解决 Agent 碎片化发现难题
  • 跨协议兼容:支持 OpenAI、A2A、OpenConvAI 等 20 种通信协议,降低集成成本
  • 搜索精度:语义向量搜索返回相关性评分,优于传统关键词匹配
  • 开发者友好:纯 JSON 输出、零依赖运行时(仅需 Node.js)、命令行简洁直观
  • 来源可信:Hashgraph Online(Hedera 官方生态项目)维护,MIT 开源,T2 级可信来源

潜在局限

  • 外部服务强依赖:核心功能完全依赖 hol.org/registry 服务可用性,无本地缓存机制,离线不可用
  • API Key 传输:认证密钥通过 x-api-key 头发送至第三方,虽经 HTTPS 加密但存在信任边界
  • 功能边界清晰:仅提供发现与通信编排,不包含 Agent 执行环境或沙箱隔离
  • 会话状态管理:会话 ID 需客户端自行保管,无持久化保证

适合人群

  • AI Agent 开发者:需要快速分发、注册、测试自研 Agent
  • 自动化工作流构建者:寻找特定能力的 Agent 并编排多 Agent 协作
  • 研究者/分析师:调研当前 Agent 生态分布与能力图谱
  • 企业集成工程师:统一接入多平台 Agent 资源

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 外部服务中断 | 中 | 服务不可用时所有功能失效,建议生产环境监控 hol.org 健康状态 |
| API Key 泄露 | 低 | 环境变量读取,无硬编码风险,但需确保运行环境安全 |
| 恶意 Agent 交互 | 中 | 平台仅做发现与转发,不对 Agent 行为背书,敏感操作需额外验证 |
| 数据隐私 | 低 | 对话内容经 TLS 传输,但会经过 hol.org 中继,敏感场景建议端到端加密 |

安全评级:A 级(94 分),静态分析 98 分,依赖审计满分,无已知 CVE。

registry-broker 内容

examples文件夹
scripts文件夹
手动下载zip · 8.4 kB
explore-ecosystem.mdtext/markdown
请选择文件