
Agent Name Service 开源参考实现发布
来源标题:Agent Name Service
ans 是 Agent Name Service(ANS)的开源实现,为 AI agent 提供按名称发现和验证的注册表与透明日志。产品包含注册机构 ans-ra、透明日志 ans-tl、离线验证器 ans-verify 和仅限开发用的 DNS 服务器 ans-dns,两个守护进程均提供 Swagger UI。事件信封、SCITT COSE 收据、sumdb-note 检查点等线上格式作为公开契约,离线验证器和透明日志客户端依赖其逐字节兼容。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
ans 是 Agent Name Service(ANS)的开源实现,ANS 是一个注册表 + 透明日志,用于按名称发现和验证 AI agent。每个注册的 agent 都会获得: 线路格式——事件信封、SCITT COSE 收据、sumdb-note 检查点、/root-keys 格式——是公开契约。离线验证器和 TL 客户端逐字节依赖它。
二进制 端口 角色 ans-ra 18080 注册机构——接受注册、签发身份证书、跟踪生命周期 ans-tl 18081 透明日志——持久化 Merkle 树追加日志,提供徽章 + 收据 ans-verify — 用于 SCITT COSE 收据和状态令牌的离线 CLI 验证器 ans-dns 15353 仅开发用的权威 DNS 服务器,带有 install / clear 子命令,用于本地端到端 verify-dns 测试
两个守护进程(ans-ra、ans-tl)都在 /docs 提供 Swagger UI——执行 make build && scripts/demo/start.sh 后,可浏览 http://localhost:18080/docs(RA)和 http://localhost:18081/docs(TL)。原始 OpenAPI 字节位于每个主机的 /docs/openapi.yaml。
要从 Swagger UI 的“Try it out”按钮调用受保护的端点:点击右上角的 Authorize 并粘贴静态 API key。快速启动的默认值是:
RA 写入签名事件;TL 验证、摄取并发布它们。操作员可以只运行 TL(用于只读验证),或两者一起运行(完整注册表)。
对于使用 systemd、Caddy、OIDC 和 Let's Encrypt 的原生 Ubuntu 主机,请参阅 RA/TL 部署指南。
前置条件:Go 1.26+、openssl、curl、jq
git clone https://github.com/agentnameservice/ans cd ans make build # 构建 bin/ans-ra、bin/ans-tl、bin/ans-verify、bin/ans-dns scripts/demo/start.sh # 针对 ./data/demo 启动两个守护进程 scripts/demo/run-lifecycle.sh # 注册一个 agent,端到端验证收据
预期输出(最后几行): ━━━ 13. Offline verify (bin/ans-verify) ━━━ ✓ Fetched 2 verification key(s) from /root-keys ✓ 1602 bytes (Content-Type: application/scitt-receipt+cose) ✓ VERIFIED (kid <8-char-hex> matched key directly)
使用 scripts/demo/stop.sh 或 scripts/demo/stop.sh --clean 进行拆卸,以清空数据目录。
config/ra-local.yaml 中的默认 DNS 验证器是 noop,它接受任何 DNS 状态。要在不触碰公共 DNS 的情况下端到端地测试真实查找验证器,请运行捆绑的权威服务器:
在一个终端中:启动开发 DNS 服务器(提供 ./data/demo/dns)
bin/ans-dns serve --addr 127.0.0.1:15353
在另一个终端中:安装 RA 在 verify-acme 之后期望的记录
bin/ans-dns install --api-key <api-key> http://localhost:18080 <agentId>
将 ra-local.yaml 切换为 dns.type=lookup 并指向 127.0.0.1:15353
然后重新运行 verify-dns;ans-tl 会观察到 AGENT_REGISTERED 事件。
拆卸:
bin/ans-dns clear <agentId>
ans-dns 仅用于开发。生产部署使用查找验证器,针对操作员现有的权威 DNS。
为长期运行的守护进程构建镜像
make docker-build
或者使用 compose 启动整个栈(RA + TL,带健康检查)
docker compose up --build
Compose 会持久化 ra-data、ra-keys 和 tl-data 卷,因此重启成本很低;docker compose down -v 会清空它们。ans-verify 和 ans-dns 是本地开发二进制文件,仅通过 make build 发布——它们不在 compose 栈中。
六边形 / 端口与适配器。领域模型(internal/domain)零框架或存储依赖。服务依赖端口接口(internal/port),internal/adapter/ 中的适配器针对真实驱动实现这些接口。
cmd/ans-ra/main.go ───────┐ ├─► internal/ra/service ─► port.AgentStore ─► internal/adapter/store/sqlite cmd/ans-tl/main.go ───────┤ port.KeyManager ─► internal/adapter/keymanager │ port.DNSVerifier ─► internal/adapter/dns └─► internal/tl/service ─► port.RenewalStore ─► … cmd/ans-verify/main.go ─► internal/tl/receipt (Verify, ExtractKID, ComputeLeafHash) cmd/ans-dns/main.go ─► miekg/dns authoritative server + RA-driven record install/clear
有关权威 OpenAPI 契约,请参阅 spec/api-spec-v2.yaml + spec/api-spec-tl-v2.yaml。
"payload": { "logId": "<uuid>
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。