让你的智能体可被发现
一份清晰的 Agent Card 为 A2A 客户端提供了可靠的起点：智能体归属于谁、部署在哪里，以及它支持哪些协议绑定和版本。
Agent Card 生成器为你的 AI 智能体创建了什么
Agent Card 是 A2A 智能体的公开接口说明。在另一个智能体决定是否调用你的服务之前，它需要的不只是一个 URL：它需要一份关于该智能体用途、技术契约、技能和访问要求的可靠说明。
这个 Agent Card 生成器把这些实现细节转化为可读、符合 A2A v1.0 结构的 JSON，同时让决策始终贴近表单。请在完成智能体核心逻辑之后、部署或上架之前使用它——这正是手写 JSON 文件通常会出错的环节。
描述一个可用的接口
记录另一个智能体在发起调用之前需要知道的首选接口、内容模式、流式行为以及推送通知支持情况。
设定访问预期
说明该服务是公开的、使用 API 密钥，还是需要 OAuth 2.0，让集成方能够选择正确的身份验证流程——同时绝不在 Agent Card 中放入任何凭据。
把技能变成清晰的契约
为智能体能完成的工作命名，添加 v1.0 要求的标签和有用的示例，让其边界对人类、市场和 AI 客户端都清晰可懂。
Agent Card 生成器如何工作
从服务详情到可发布的 Agent Card
Agent Card 生成器将服务详情转化为清晰、可发布的 JSON 文档。在把 Agent Card 投入生产之前，请遵循这个简短的工作流程。
- 1
从真实服务开始
添加公开的 A2A 端点、协议绑定、提供方信息、智能体版本，以及你的服务器接受和返回的内容类型。
- 2
定义能力与技能边界
只选择你的实现所支持的能力，然后用简明、具体的语言描述一个具有代表性的技能。
- 3
审查生成的 JSON
使用实时预览发现缺失的字段、占位符 URL，或与实际部署服务不符的描述。
- 4
校验并发布
让 Agent Card 通过校验器检查，然后将审核后的文档放在你服务域名下的 /.well-known/agent-card.json。
谁在使用 Agent Card 生成器
为每一位创建、发布或审核 Agent Card 的人而生
Agent Card 生成器帮助构建者、平台团队和审核人员在不从空白 JSON 文件开始的情况下，创建一致的 A2A 智能体元数据。
AI 与独立开发者
在发布兼容 A2A 的智能体时，用一个完整、符合规范的起点取代手写的 agent-card.json。
提示工程师与产品经理
无需接触 JSON 语法，即可从服务描述起草一份可信的发现文档，然后交给工程团队审核。
平台与 DevOps 团队
在内部智能体进入公司智能体目录或 CI 流水线之前，统一它们描述端点、身份验证和技能的方式。
市场发布方
准备好审核方和排名系统能够真正解析的提供方元数据、技能标签和安全声明。
常见问题
Agent Card 生成器常见问题
在 A2A 客户端找到你的端点之前，先把要点做对。
什么是 A2A Agent Card？
A2A Agent Card 是一份面向 AI 智能体的 JSON 发现文档。它向潜在客户端传达身份、提供方信息、支持的接口、能力、技能、可接受的内容模式以及安全要求——相当于智能体对智能体版本的 README 加 API 概览。
为什么要用 Agent Card 生成器而不是手写 JSON？
手写的 Agent Card 经常会遗漏必填字段、使用 v1.0 之前的字段名，或者存在语法错误。生成器产出当前的 A2A v1.0 结构——supportedInterfaces、provider.organization、必填的技能标签——并在你输入时实时校验，因此结构性错误永远不会进入生产环境。
生成的 Agent Card 针对哪个 A2A 版本？
生成器输出 A2A v1.0 结构：一个有序的 supportedInterfaces 数组，每个接口都有自己的 protocolBinding 和 protocolVersion，一个顶层的智能体 version，以及包含 extendedAgentCard 的能力声明。带有顶层 url 或 preferredTransport 字段的 Agent Card 属于 v1.0 之前的版本。
生成的 JSON 在投入生产前需要审查吗？
需要。生成器创建的是一份实用的起始文档，而不是你已部署契约的替代品。请确认端点、协议绑定、技能和身份验证与用户实际会访问的服务相符。
我应该在哪里发布 Agent Card？
在与你的 A2A 服务相同的域名下，将审核后的 JSON 发布到 https://your-domain/.well-known/agent-card.json，这是 A2A 规范注册的 well-known 路径。许多较旧的集成也会检查 /.well-known/agent.json，因此同时提供两者是一种安全的过渡策略。