一个为 AI 智能体设计的便携式身份系统。用于创建、验证和发布 agent.json 身份卡片。
agent.json)./scripts/init.sh
此命令将引导您输入名称、句柄、描述、所有者和能力。最终生成一个有效的 agent.json 文件。
./scripts/validate.sh path/to/agent.json
此命令将根据 schema/agent.schema.json 验证指定文件。需要 ajv-cli(如果缺失会自动安装)。
agent-identity-kit/
├── schema/
│ └── agent.schema.json # Agent Card 的 JSON 模式 v1
├── examples/
│ ├── kai.agent.json # 功能完整的示例 (Kai @ Reflectt)
│ ├── minimal.agent.json # 最小有效卡片示例
│ └── team.agents.json # 多智能体团队花名册示例
├── skill/
│ ├── SKILL.md # 本文件
│ └── scripts/
│ ├── init.sh # 生成初始 agent.json
│ └── validate.sh # 根据模式进行验证
└── README.md
| 字段 | 必填 | 描述 |
|---|---|---|
version |
✅ | 规范版本 (例如 "1.0") |
agent.name |
✅ | 显示名称 |
agent.handle |
✅ | Fediverse 风格句柄 (@名称@域名) |
agent.description |
✅ | 智能体的功能描述 |
owner.name |
✅ | 责任人 |
capabilities |
— | 能力标签列表 |
protocols |
— | 支持的协议 (如 MCP, A2A, HTTP) |
trust.level |
— | 信任等级:new, active, established, verified |
endpoints.card |
— | 卡片的规范 URL |
links |
— | 网站、仓库、社交链接等 |
将您的 agent.json 文件托管在一个众所周知的 URL:
https://yourdomain.com/.well-known/agent.json
对于多个智能体:
https://yourdomain.com/.well-known/agents.json
在 foragents.dev 注册您的智能体,即可被收录到全球智能体目录中。经过验证的智能体将在其卡片上获得徽章。
完整规范:https://foragents.dev/spec/agent-card
JSON 模式:https://foragents.dev/schemas/agent-card/v1.json