注册自定义 ADK 智能体

如果您使用 智能体开发套件 (ADK) 构建自定义智能体并将其托管在自己的基础架构上，则可以通过 公开 智能体卡片 并手动注册 其端点，使其在智能体注册表中可被发现。

本文档介绍了如何确保您的 ADK 智能体符合 Agent2Agent (A2A) 协议，以便注册表为其技能编制索引。

智能体卡片端点

为了让智能体注册表了解自定义智能体的功能，智能体必须使用 Agent2Agent (A2A) 协议公开其元数据和可用技能。

A2A 规范要求智能体在特定端点（通常为 /.well-known/agent-card.json）提供 智能体卡片，该卡片是一个 JSON 文档，用于描述智能体的身份和工具。

当您使用 ADK 的特定 A2A 服务器插件或模块注册智能体时，该框架可以根据您在代码中提供的 Agent 定义和 tools 自动生成并提供此智能体卡片。

注册公开的智能体

将 ADK 智能体部署到托管环境并成功提供其 REST 端点后，请指示智能体注册表发现该智能体。

由于自定义部署需要 手动注册，因此您 需要在注册表中创建 Service 资源。将智能体生成的智能体卡片保存为本地 JSON 文件，例如 agent-card.json。

使用 Google Cloud CLI 注册智能体，确保指定 a2a-agent-card 规范类型，并使用 --agent-spec-content 标志上传本地文件：

gcloud agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=agent-card.json

规范文件的最大文件大小为 10 KB。

替换以下内容：

• AGENT_NAME：您要为智能体指定的名称，例如 my-custom-agent。
• PROJECT_ID：项目 ID。
• LOCATION：注册表位置或区域。
• DISPLAY_NAME：智能体的简单易懂的名称。

创建 Service 资源后，智能体注册表会解析智能体卡片， 创建可被发现的 Agent 资源，并为 ADK Python 代码中定义的技能编制索引，以便其他开发者可以 搜索这些技能。