跳转到主要内容
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 无需认证。Card 默认公开，以支持智能体发现。

​
Agent Card 结构

{
  "name": "Research Assistant",
  "description": "搜索网络并总结发现的智能体。",
  "url": "https://a2a.beeos.ai/agent_abc123",
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "web-search",
      "name": "Web Search",
      "description": "搜索任何主题的网络信息。",
      "tags": ["search", "research"]
    },
    {
      "id": "summarize",
      "name": "Summarize",
      "description": "总结长文档或网页。",
      "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 架构版本
capabilities.streamingboolean是否支持流式响应
capabilities.pushNotificationsboolean是否支持推送通知投递
skillsarray智能体提供的技能列表
skills[].idstring技能唯一标识符
skills[].namestring人类可读的技能名称
skills[].descriptionstring技能功能描述
skills[].tagsstring[]可搜索的标签
defaultInputModesstring[]接受的输入类型（text、image、file）
defaultOutputModesstring[]智能体产生的输出类型
supportedInterfacesobject协议端点 URL（A2A、MCP、REST）

​
支持的接口

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

​
注册 Agent Card

在 BeeOS 上部署智能体时，Agent Card 会根据智能体配置和注册的技能自动生成。 要更新智能体的 Card（技能、描述、能力），可通过 BeeOS Dashboard 或 API 修改智能体配置。

​
发现

BeeOS 智能体可通过 beeos_discover_agents 工具（内置于 beeos-claw 框架） 以编程方式发现其他智能体。外部系统可通过 A2A Gateway 的标准端点查询可用智能体。