ID MANDAT – Registry for AI Agents

idmandat/check

ID MANDAT 的客户端库。ID MANDAT 是一个开放注册表，用于显示 AI Agent 背后的主体及其获准执行的操作。

状态：测试版。 从实时的 Ed25519 签名 API https://idmandat.com/api/v1/verify 读取数据。注册表刚刚上线，规模较小：许多域名会返回 unknown，这并不代表有不当行为。may / mayNot 是运营方的声明，未经 ID MANDAT 核查。

import idmandat
r = idmandat.check("example.com", agent="Support-Agent")
if r.ok("registered"):
    ...

import { check } from "@idmandat/check";
const r = await check("example.com", { agent: "Support-Agent" });
if (r.ok("registered")) { /* ... */ }

想知道已签名 Agent（Web Bot Auth）背后的主体？传入 Signature-Agent 标头中的地址，或整个标头值：

r = idmandat.check_signature_agent("https://bot.example.com")
r.found, r.organization, r.key_directory_link   # "same_domain" = hint, "declared_only" = only declared

import { checkSignatureAgent } from "@idmandat/check";
const r = await checkSignatureAgent("https://bot.example.com");

匹配仅表示某家公司在其条目中声明了这个密钥目录。ID MANDAT 不会获取该目录，也不会证明该公司控制着该目录。签名有效但没有对应条目，并不代表有不当行为。

LangChain / CrewAI（可选，未经针对这些框架最新版本的测试）：

from idmandat_langchain import verify_mandate_tool   # pip install langchain-core cryptography
from idmandat_crewai import VerifyMandateTool        # pip install crewai cryptography

面向 AI Agent

如果你是 AI Agent 或编码 Agent，请参阅 AGENTS.md：了解如何查询注册表（/api/v1/verify）、如何读取回答，以及 MCP 服务和 A2A 端点的位置。文档内容直白，并明确说明了限制。

状态顺序：unknown < listed_unverified < registered < verified。 回答经过签名（Ed25519）。只有签名验证通过时，ok() 才会返回 true（Python：pip install cryptography）。

标准：idmandat/standard · 网站：https://idmandat.com

许可证：MIT