首页 注册 登录
OA0 = Omni AI 0
OA0 是一个探索 AI 的论坛
现在注册
已注册用户请  登录
OA0  ›  技能包  ›  registry-broker-skills：全球 AI 智能体注册中心与搜索经纪人

registry-broker-skills：全球 AI 智能体注册中心与搜索经纪人

 
  oauth ·  2026-02-18 02:17:50 · 3 次点击  · 0 条评论  

名称： registry-broker
描述： 通过 Hashgraph Online Registry Broker API，搜索并与来自 14 个注册表的 72,000+ AI 智能体进行对话。适用于发现智能体、发起对话或注册新智能体。
主页： https://hol.org/registry
元数据：
{
"openclaw":
{
"emoji": "🔍",
"requires": { "env": ["REGISTRY_BROKER_API_KEY"] },
"primaryEnv": "REGISTRY_BROKER_API_KEY",
},
}

Registry Broker

通过 Hashgraph Online Registry Broker，搜索来自 AgentVerse、NANDA、OpenRouter、Virtuals Protocol、PulseMCP、Near AI 等平台的 72,000+ AI 智能体。

设置

在 https://hol.org/registry 获取您的 API 密钥，并设置：

export REGISTRY_BROKER_API_KEY="your-key"

API 基础地址

https://hol.org/registry/api/v1

发现

关键词搜索

# GET /search 带查询参数
curl "https://hol.org/registry/api/v1/search?q=trading+bot&limit=5"

# 带过滤器：registries, adapters, capabilities, protocols, minTrust, verified, online, sortBy, type
curl "https://hol.org/registry/api/v1/search?q=defi&registries=agentverse,nanda&verified=true&limit=10"

向量/语义搜索

# POST /search 带 JSON 请求体
curl -X POST "https://hol.org/registry/api/v1/search" \
  -H "Content-Type: application/json" \
  -d '{"query": "help me analyze financial data", "limit": 5}'

能力搜索

# POST /search/capabilities
curl -X POST "https://hol.org/registry/api/v1/search/capabilities" \
  -H "Content-Type: application/json" \
  -d '{"capabilities": ["code-generation", "data-analysis"], "limit": 10}'

智能体详情

# GET /agents/{uaid} - 获取智能体详情
curl "https://hol.org/registry/api/v1/agents/uaid:aid:fetchai:..."

# GET /agents/{uaid}/similar - 查找相似智能体
curl "https://hol.org/registry/api/v1/agents/uaid:aid:fetchai:.../similar"

# GET /agents/{uaid}/feedback - 获取智能体反馈
curl "https://hol.org/registry/api/v1/agents/uaid:aid:fetchai:.../feedback"

路由与解析

# GET /resolve/{uaid} - 将 UAID 解析为智能体元数据
curl "https://hol.org/registry/api/v1/resolve/uaid:aid:fetchai:..."

# GET /uaids/validate/{uaid} - 验证 UAID 格式
curl "https://hol.org/registry/api/v1/uaids/validate/uaid:aid:fetchai:..."

# GET /uaids/connections/{uaid}/status - 检查连接状态
curl "https://hol.org/registry/api/v1/uaids/connections/uaid:aid:.../status"

注册表信息

# GET /registries - 列出已知注册表
curl "https://hol.org/registry/api/v1/registries"

# GET /adapters - 列出可用适配器
curl "https://hol.org/registry/api/v1/adapters"

# GET /adapters/details - 适配器元数据（含聊天能力）
curl "https://hol.org/registry/api/v1/adapters/details"

# GET /stats - 平台统计信息
curl "https://hol.org/registry/api/v1/stats"

# GET /providers - 提供商目录（含协议）
curl "https://hol.org/registry/api/v1/providers"

# GET /popular - 热门搜索查询
curl "https://hol.org/registry/api/v1/popular"

# GET /search/facets - 可用搜索分面
curl "https://hol.org/registry/api/v1/search/facets"

# GET /search/status - 搜索后端状态
curl "https://hol.org/registry/api/v1/search/status"

聊天

会话管理

# POST /chat/session - 创建会话（通过 UAID 或 agentUrl）
curl -X POST "https://hol.org/registry/api/v1/chat/session" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"uaid": "uaid:aid:fetchai:..."}'

# 或通过智能体 URL：
curl -X POST "https://hol.org/registry/api/v1/chat/session" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"agentUrl": "https://agent.example.com/api"}'
# 返回：{"sessionId": "sess_..."}

消息发送

# POST /chat/message - 发送消息
curl -X POST "https://hol.org/registry/api/v1/chat/message" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"sessionId": "sess_...", "message": "Hello!"}'

# 流式传输（SSE）：
curl -X POST "https://hol.org/registry/api/v1/chat/message" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"sessionId": "sess_...", "message": "Hello!", "stream": true}'

历史记录与管理

# GET /chat/session/{sessionId}/history - 获取对话历史
curl "https://hol.org/registry/api/v1/chat/session/sess_.../history" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /chat/session/{sessionId}/compact - 总结历史记录（扣减积分）
curl -X POST "https://hol.org/registry/api/v1/chat/session/sess_.../compact" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /chat/session/{sessionId}/encryption - 获取加密状态
curl "https://hol.org/registry/api/v1/chat/session/sess_.../encryption" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# DELETE /chat/session/{sessionId} - 结束会话
curl -X DELETE "https://hol.org/registry/api/v1/chat/session/sess_..." \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

注册

报价与注册

# GET /register/additional-registries - 列出可用于注册的注册表
curl "https://hol.org/registry/api/v1/register/additional-registries" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /register/quote - 获取积分成本估算
curl -X POST "https://hol.org/registry/api/v1/register/quote" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"profile": {"name": "My Agent", "description": "..."}}'

# POST /register - 注册智能体（返回 200/202/207）
curl -X POST "https://hol.org/registry/api/v1/register" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{
    "profile": {"name": "My Agent", "description": "..."},
    "endpoint": "https://my-agent.com/api",
    "protocol": "openai",
    "registry": "custom"
  }'

状态与更新

# GET /register/status/{uaid} - 检查注册状态
curl "https://hol.org/registry/api/v1/register/status/uaid:..." \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /register/progress/{attemptId} - 轮询注册进度
curl "https://hol.org/registry/api/v1/register/progress/{attemptId}" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# PUT /register/{uaid} - 更新智能体
curl -X PUT "https://hol.org/registry/api/v1/register/uaid:..." \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"profile": {"name": "Updated Name"}}'

# DELETE /register/{uaid} - 注销智能体
curl -X DELETE "https://hol.org/registry/api/v1/register/uaid:..." \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

积分与支付

# GET /credits/balance - 查询余额（可选 accountId 查询参数）
curl "https://hol.org/registry/api/v1/credits/balance" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /credits/providers - 列出支付提供商
curl "https://hol.org/registry/api/v1/credits/providers" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /credits/payments/hbar/intent - 创建 HBAR 支付意向
curl -X POST "https://hol.org/registry/api/v1/credits/payments/hbar/intent" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"credits": 100}'

# POST /credits/payments/intent - 创建 Stripe 支付意向
curl -X POST "https://hol.org/registry/api/v1/credits/payments/intent" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"credits": 100}'

账本认证（基于钱包）

使用 EVM 或 Hedera 钱包进行认证，替代 API 密钥：

# POST /auth/ledger/challenge - 获取签名挑战
curl -X POST "https://hol.org/registry/api/v1/auth/ledger/challenge" \
  -H "Content-Type: application/json" \
  -d '{"network": "hedera-mainnet", "accountId": "0.0.12345"}'
# 返回：{"challengeId": "...", "challenge": "sign-this-message", "expiresAt": "..."}

# POST /auth/ledger/verify - 验证签名，获取临时 API 密钥
curl -X POST "https://hol.org/registry/api/v1/auth/ledger/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "challengeId": "...",
    "accountId": "0.0.12345",
    "network": "hedera-mainnet",
    "signature": "...",
    "publicKey": "...",
    "signatureKind": "raw"
  }'
# 返回：{"apiKey": {...}, "expiresAt": "..."}

支持的网络：hedera-mainnet, hedera-testnet, ethereum, base, polygon

签名类型：raw, map, evm

加密密钥

# POST /encryption/keys - 注册长期加密密钥
curl -X POST "https://hol.org/registry/api/v1/encryption/keys" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"publicKey": "...", "uaid": "uaid:..."}'

内容铭刻（HCS）

# GET /inscribe/content/config - 获取铭刻服务配置
curl "https://hol.org/registry/api/v1/inscribe/content/config" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /inscribe/content/quote - 获取成本报价
curl -X POST "https://hol.org/registry/api/v1/inscribe/content/quote" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"content": "base64...", "mimeType": "text/plain"}'

# POST /inscribe/content - 创建铭刻任务
curl -X POST "https://hol.org/registry/api/v1/inscribe/content" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"content": "base64...", "mimeType": "text/plain", "quoteId": "..."}'

# GET /inscribe/content/{jobId} - 检查任务状态
curl "https://hol.org/registry/api/v1/inscribe/content/{jobId}" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /inscribe/content - 列出用户铭刻记录
curl "https://hol.org/registry/api/v1/inscribe/content?limit=20" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

路由（高级）

# POST /route/{uaid} - 向智能体发送路由消息
curl -X POST "https://hol.org/registry/api/v1/route/uaid:..." \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"message": "Hello", "metadata": {}}'

# DELETE /uaids/connections/{uaid} - 关闭活动连接
curl -X DELETE "https://hol.org/registry/api/v1/uaids/connections/uaid:..." \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

MCP 服务器（推荐用于 Claude/Cursor）

为了与 AI 编程工具进行更丰富的集成，请使用 MCP 服务器：

npx @hol-org/hashnet-mcp up --transport sse --port 3333

MCP 工具

发现
- hol.search - 带过滤器的关键词搜索
- hol.vectorSearch - 语义相似性搜索
- hol.agenticSearch - 混合语义 + 词法搜索
- hol.resolveUaid - 解析并验证 UAID

聊天
- hol.chat.createSession - 通过 uaid 或 agentUrl 打开会话
- hol.chat.sendMessage - 发送消息（如果需要会自动创建会话）
- hol.chat.history - 获取对话历史
- hol.chat.compact - 为上下文窗口进行总结
- hol.chat.end - 关闭会话

注册
- hol.getRegistrationQuote - 成本估算
- hol.registerAgent - 提交注册
- hol.waitForRegistrationCompletion - 轮询直到完成

积分
- hol.credits.balance - 检查积分余额
- hol.purchaseCredits.hbar - 使用 HBAR 购买积分
- hol.x402.minimums - 获取 X402 支付最低限额
- hol.x402.buyCredits - 通过 X402 (EVM) 购买积分

账本认证
- hol.ledger.challenge - 获取钱包签名挑战
- hol.ledger.authenticate - 验证签名，获取临时 API 密钥

工作流
- workflow.discovery - 搜索 + 解析流程
- workflow.registerMcp - 报价 + 注册 + 等待
- workflow.chatSmoke - 测试聊天生命周期

详见：https://github.com/hashgraph-online/hashnet-mcp-js

链接

  • 注册表：https://hol.org/registry
  • API 文档：https://hol.org/docs/registry-broker/
  • SDK：https://npmjs.com/package/@hashgraphonline/standards-sdk
  • OpenAPI：https://hol.org/registry/api/v1/openapi.json
  • MCP 服务器：https://github.com/hashgraph-online/hashnet-mcp-js
技能包地址：https://github.com/openclaw/skills/tree/main/skills/kantorcodes/registry-broker-skills/SKILL.md
3 次点击  ∙  0 人收藏  
登录后收藏  
目前尚无回复
0 条回复
About   ·   Help   ·    
OA0 - Omni AI 0 一个探索 AI 的社区
沪ICP备2024103595号-2
Developed with Cursor