Agent Card 应该放在哪里？

通常放在 /.well-known/agent-card.json，并确保返回 application/json 或可解析 JSON，不要返回 HTML。

Agent Card 要写价格吗？

如果服务有明确价格，建议写入套餐、币种、金额、下单入口和付款限制，并与页面可见价格保持一致。

Agent Card 是强制标准吗？

不是通用强制标准，但对 Agent-to-Agent 服务发现、价格读取、下单路径描述和机器可理解性很实用。

Agent Card 示例模板 - /.well-known/agent-card.json 怎么写

可复制 JSON 模板

把下面内容替换成你的真实信息，保存为 /.well-known/agent-card.json。部署后要用 JSON 校验工具检查可解析性，并确认金额、交付物和限制与网站页面一致。

{
  "schema_version": "1.0",
  "name": "你的品牌名",
  "description": "一句话说明你提供什么服务，适合谁，解决什么问题。",
  "url": "https://example.com/",
  "provider": {
    "name": "你的品牌名",
    "url": "https://example.com/"
  },
  "service": {
    "id": "your_service_id",
    "type": "ai_agent_readable_service",
    "languages": ["zh-CN", "en"],
    "best_for": [
      "需要让 AI 搜索读懂官网的站长",
      "需要让其他 Agent 读取价格和下单入口的服务商",
      "SaaS、AI 工具、API 平台和个人服务页"
    ],
    "inputs": [
      {
        "name": "website_url",
        "type": "url",
        "required": true,
        "description": "需要检测或修复的网站 URL"
      },
      {
        "name": "target_systems",
        "type": "array",
        "required": false,
        "description": "关注的 AI 搜索或 Agent 系统，例如 Doubao、Kimi、DeepSeek"
      }
    ],
    "outputs": [
      "AI 搜索可见性诊断摘要",
      "robots.txt 和 sitemap.xml 建议",
      "llms.txt 和 llms-full.txt 草稿",
      "Agent Card JSON 草稿",
      "Service / Offer / FAQPage JSON-LD 建议",
      "首页文案和复测提示词"
    ]
  },
  "offers": [
    {
      "id": "entry_scan_9_9",
      "name": "入门扫描",
      "price": "9.9",
      "priceCurrency": "CNY",
      "url": "https://example.com/pay/",
      "deliverables": ["一个网站快扫", "前三个风险点", "复测提示词"]
    },
    {
      "id": "standard_fix_59_9",
      "name": "标准修复包",
      "price": "59.9",
      "priceCurrency": "CNY",
      "url": "https://example.com/pay/",
      "deliverables": ["诊断摘要", "核心机器可读文件", "首页文案建议", "复测提示词"]
    },
    {
      "id": "advanced_fix_99_9",
      "name": "高级当天修复包",
      "price": "99.9",
      "priceCurrency": "CNY",
      "url": "https://example.com/pay/",
      "deliverables": ["完整诊断", "llms-full.txt", "Agent Card", "JSON-LD", "FAQ", "复测材料"]
    }
  ],
  "order": {
    "human_checkout": "https://example.com/pay/",
    "post_payment_contact": "https://example.com/pay/#paid-contact",
    "payment_note": "请备注订单号或网站域名"
  },
  "limitations": [
    "不承诺第三方平台排名、收录、引用、流量或收入",
    "只交付网站侧可读性、可抓取性、机器可理解度和转化路径相关修复",
    "付款或订单通知需要人工核验真实到账后才开始交付"
  ]
}

打开免费生成器直接选择三档套餐

字段为什么要这样写

service.inputs 告诉其他 Agent 需要收集哪些信息。service.outputs 告诉用户会得到什么交付物。offers 把价格和下单入口结构化。limitations 明确边界，避免模型把网站侧优化误说成排名保证。

部署后检查

/.well-known/agent-card.json 能被公开访问。
JSON 能被解析，没有注释、尾逗号或 BOM 问题。
价格、套餐名、交付物和 /pay/ 页面一致。
和 /llms.txt、结构化数据、首页文案没有冲突。
复测时让 AI 同时读取官网、llms.txt 和 Agent Card。

Agent Card 示例模板：让其他 Agent 读懂你的服务和下单路径

可复制 JSON 模板

字段为什么要这样写

部署后检查