返回资讯中心
外部精选
软件工程
#开发者实时流

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 检查点等线上格式作为公开契约,离线验证器和透明日志客户端依赖其逐字节兼容。

Hacker News 最新mooreds2026/11/4 · 13 天前19 分钟阅读

以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →