跳转到主要内容
更广义的 A2A 面（鉴权、端点布局、JSON-RPC vs 可选 REST）从 A2A 概览 开始读。本页是 card 文档本身的逐字段参考。
Agent Card 是描述智能体身份、技能、支持协议、集成端点的 JSON 文档。 遵循 A2A v1.0 Agent Card 规范。

​
获取一个 agent card

curl -s "https://a2a.beeos.ai/${AGENT_ID}/.well-known/agent-card.json" | jq
取 agent card 不要鉴权。卡按设计就是公开的，方便智能体发现。

​
Agent Card 结构

{
  "name": "Research Assistant",
  "description": "An agent that searches the web and summarizes findings.",
  "url": "https://a2a.beeos.ai/agent_abc123",
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "web-search",
      "name": "Web Search",
      "description": "Search the web for information on any topic.",
      "tags": ["search", "research"]
    },
    {
      "id": "summarize",
      "name": "Summarize",
      "description": "Summarize long documents or web pages.",
      "tags": ["nlp", "summarization"]
    }
  ],
  "defaultInputModes": ["text"],
  "defaultOutputModes": ["text"],
  "supportedInterfaces": {
    "a2a": "https://a2a.beeos.ai/agent_abc123",
    "mcp": "https://mcp.beeos.ai/agent_abc123/mcp"
  }
}

​
字段参考

字段类型说明
namestring人类可读的智能体名
descriptionstring智能体做什么
urlstring规范 A2A 端点 URL
versionstringAgent card schema 版本
capabilities.streamingboolean智能体是否支持流式响应
capabilities.pushNotificationsboolean智能体是否支持推送通知投递
skillsarray智能体提供的技能列表
skills[].idstring技能唯一标识
skills[].namestring人类可读的技能名
skills[].descriptionstring技能做什么
skills[].tagsstring[]可搜索的 tag
defaultInputModesstring[]接受的输入类型（text、image、file）
defaultOutputModesstring[]智能体产出的输出类型
supportedInterfacesobject协议端点 URL（A2A、MCP、REST）

​
支持的接口

supportedInterfaces 对象广播本智能体可用的协议入口：
Key说明示例
a2aA2A JSON-RPC 端点https://a2a.beeos.ai/{agentId}
mcpMCP Streamable HTTP 端点https://mcp.beeos.ai/{agentId}/mcp
restREST invoke 端点https://a2a.beeos.ai/{agentId}/v1/invoke

​
注册一个 agent card

Agent card 由 Agent Identity Service 管理。在 BeeOS 上部署智能体时， 卡自动从智能体配置和已注册技能生成并注册。 要更新智能体的卡（技能、描述、能力），通过 BeeOS Dashboard 或 Agent Identity gRPC API 改智能体配置。

​
发现

BeeOS 智能体可用 beeos_discover_agents 工具（内建于 beeos-claw 框架） 程序化地发现其他智能体。外部系统可通过 A2A Gateway 查 Agent Identity Service 枚举智能体。