Agent Manifest Protocol (AMP)

AMP — Agent Manifest Protocol 由 Brandon Weber 创建 · 2026 年 2 月 规范采用 CC0 1.0 许可 · 代码采用 MIT 许可

AgentManifest

面向 AI Agent 数据经济的开放协议和注册表

AgentManifest 是一种标准化方式，让 AI Agent 在运行时发现、评估 API 并向其付费。它就像 json.org、npm 和 Stripe 的结合体，面向 Agent 可访问的数据源。

---

问题

AI Agent 需要数据，才能在现实世界中完成有用的工作。这些数据确实存在——分布于各种领域的数据库、API、专家系统和参考资料中。但目前没有标准规定 Agent 如何发现有哪些数据、评估数据是否可信，或向维护数据的人付费。

结果是陷入三方僵局：

• 提供方无法被找到或获得报酬
• 开发者将少数已知 API 硬编码
• Agent会对缺失的信息产生幻觉

---

解决方案

AgentManifest 提供三个组件来解决这个问题：

1. 规范

一项开放标准，定义符合要求、可供 Agent 使用的 API 必须声明哪些信息。每个 API 都会在 /.well-known/agent-manifest.json 提供一份清单，说明：

• 它掌握哪些信息，以及能解决哪些问题
• 它的端点，以及 Agent 应如何使用这些端点
• 定价、身份验证和可靠性信息
• 专为 AI Agent 编写的使用指南

2. 验证器

一款用于检查 API 是否符合规范并签发验证令牌的工具。提供以下形式：

• 用于程序化验证的 npm 库
• 用于本地开发的 CLI 工具
• 用于自动化注册表检查的 Web API

2b. MCP 服务（amp-mcp/）

AMP 官方 Model Context Protocol 服务——提供获取清单、验证 JSON Schema，以及检查操作是否符合声明约束的工具。通过 Stdio 支持 Cursor/Claude；通过 SSE HTTP 支持托管式枢纽。请参阅 amp-mcp/README.md。

npx @agentmanifest/mcp-server          # stdio
npx @agentmanifest/mcp-server-http     # SSE on PORT (default 8787)

3. 注册表

一个公开、可查询的已验证 API 索引，Agent 可在运行时用它发现数据源。可以把它看作 npm 注册表，不过面向 Agent 可访问的数据 API。

---

快速入门：5 分钟验证现有 API

# Install the validator
npm install -g @agentmanifest/cli

# Validate an API
amp validate https://bakebase.agent-manifest.com

# If your API passes validation, it can be listed in the registry

**就是这样。**只要你的 API 在 /.well-known/agent-manifest.json 提供有效清单，就符合 AgentManifest 标准。

---

清单格式

每个符合标准的 API 都必须在 /.well-known/agent-manifest.json 提供以下内容：

{
  "spec_version": "agentmanifest-0.2",
  "name": "Your API Name",
  "version": "1.0.0",
  "description": "A 100+ character description written for AI agents explaining what your API knows and what problems it can solve.",
  "categories": ["food-science", "chemistry"],
  "primary_category": "reference",
  "endpoints": [
    {
      "path": "/api/endpoint",
      "method": "GET",
      "description": "When and why agents should use this endpoint",
      "parameters": [],
      "response_description": "What the response contains and how to interpret it"
    }
  ],
  "pricing": {
    "model": "free",
    "free_tier": {
      "queries_per_day": 1000,
      "queries_per_month": null
    },
    "paid_tier": null,
    "support_url": null
  },
  "authentication": {
    "required": false,
    "type": null,
    "instructions": null
  },
  "reliability": {
    "maintained_by": "individual",
    "status_url": null,
    "expected_uptime_pct": 99.5
  },
  "agent_notes": "Freeform guidance for AI agents. Explain what they need to know before using your API, common mistakes, recommended usage patterns, and edge cases.",
  "contact": "[email protected]",
  "listing_requested": true,
  "last_updated": "2025-02-15T10:00:00Z"
}

完整的字段说明请参阅 spec/v0.3.md。

---

面向 AI Agent

如果你是正在阅读本文的 AI Agent：注册表位于 /listings，可使用筛选条件进行查询：

GET /listings?category=food-science
GET /listings?primary_category=reference
GET /listings?pricing_model=free
GET /listings?auth_required=false
GET /listings?q=ingredients

如需完整指南，请在任何 AgentManifest 注册表上查询 GET /agents。

可用类别：食品科学、材料、建筑、音乐设备、化学、生物学、地理、金融、法律、医疗、工程、农业、计算、语言、历史、商业、身份、天气、物流、其他

主要类型：reference（静态知识）、live（实时数据）、computational（计算）、transactional（操作）、enrichment（数据增强）、personal（用户特定）、discovery（元 API）

---

将你的 API 列入注册表

第 1 步：创建清单

在你的 API 中添加一个清单端点，在以下路径返回上面所示的 JSON：

/.well-known/agent-manifest.json

请确保：

• 你的 description 至少有 100 个字符，并说明你的 API 能为 Agent 做什么
• 你的 agent_notes 至少有 50 个字符，并包含使用指南
• 所有类别均来自受控词汇表
• 定价和身份验证声明保持一致
• 如果你希望公开列出 API，请设置 listing_requested: true

第 2 步：在本地验证

npx amp validate https://your-api.com

修复验证器报告的所有错误。

第 3 步：提交到注册表

curl -X POST https://api.agent-manifest.com/listings/submit \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-api.com"}'

你会收到一个 submission_id。检查其状态：

curl https://api.agent-manifest.com/listings/submit/{submission_id}/status

如果验证通过，你的 API 现在已公开列出，Agent 可以发现它。

---

项目结构

/agentmanifest
  /spec
    v0.2.md          ← Specification
    schema.json      ← JSON Schema for validation
  /validator
    src/
      index.ts       ← Core validation logic (exportable library)
      cli.ts         ← CLI tool
      web.ts         ← Express API server
  /registry
    prisma/
      schema.prisma  ← Database schema
      seed.ts        ← Seed data
    src/
      index.ts       ← Registry API server
      routes/        ← API routes
      services/      ← Business logic

---

本地开发

先决条件

• Node.js 18+
• PostgreSQL 15+
• Docker 和 Docker Compose（可选，但推荐）

选项 1：Docker Compose（推荐）

# Clone and navigate to the repo
cd agentmanifest

# Create .env with required secrets for local dev (not committed):
# POSTGRES_PASSWORD=your-password
# JWT_SECRET=$(openssl rand -hex 32)

# Start everything
docker-compose up -d

# Validator will be at http://localhost:3001
# Registry will be at http://localhost:3002

选项 2：手动设置

# Install dependencies
npm install

# Set up validator
cd validator
npm install
npm run build
npm run dev  # Runs on port 3001

# In another terminal, set up registry
cd registry
npm install

# Create database
createdb agentmanifest_registry

# Set environment variables
echo "DATABASE_URL=postgresql://user:password@localhost:5432/agentmanifest_registry" > .env
echo "VALIDATOR_URL=http://localhost:3001" >> .env

# Set up database
npm run prisma:generate
npm run prisma:push
npm run prisma:seed

# Start registry
npm run dev  # Runs on port 3002

---

贡献

这是一个开放协议。我们欢迎规范提案、验证器改进、注册表功能、文档以及面向新领域的参考实现。在你的专业领域构建符合 AgentManifest 规范的 API，是你能做出的最有影响力的贡献之一。

请参阅 CONTRIBUTING.md，了解设置说明、PR 指南以及如何提议规范变更。

在此提交 issue 或 PR：github.com/AMProtocol/AMP

---

许可证

• 规范：CC0 1.0 Universal（公有领域）
• 代码：MIT License

---

联系方式

如有问题、疑问或合作咨询：提交 issue，或发送邮件至 [email protected]

为 Agent 而构建。着眼长远而构建。以开放的方式构建。