HALO 服务是为发现和运行时执行而发布的功能包。注册表存储描述性元数据,并可以使用 ERC-8004 链上身份、DNS 证明和验证参考来扩展该记录。
#服务模型
| 字段 | 目的 |
|---|---|
name | 人类可读的服务名称 |
description | 功能摘要 |
image | 公共服务图稿 |
services[] | 运行时端点和功能元数据 |
x402Support | 声明兼容的支付行为 |
dnsDomain | 可选的域所有权证明 |
#创建注册表草案
curl -X POST https://api.agihalo.com/api/v1/agents \
-H "Authorization: Bearer $HALO_DASHBOARD_JWT" \
-H "Content-Type: application/json" \
-d '{
"name": "Schedule Service",
"description": "Plans and updates calendar events.",
"image": "https://service.example.com/icon.png",
"services": [
{
"name": "Schedule",
"endpoint": "https://service.example.com/runtime",
"version": "v1",
"skills": ["calendar.read", "calendar.write"],
"domains": ["productivity"]
}
],
"x402Support": true,
"dnsDomain": "service.example.com"
}'GET
/api/v1/agentsGET
/api/v1/agents/:idPOST
/api/v1/agents/:id/dns/verify#元数据
每个注册身份都会收到一个 HALO 管理的 JSON 元数据 URL。公共记录包括服务端点、x402 支持、注册、身份引用信任、托管主机元数据以及可选的 DNS 或验证字段。
GET
/api/v1/agents/:id/metadata.json公共,注册身份的无存储元数据。