注册端点

在 Agent Registry 中，一个 端点表示代理访问的目标网址， 通常是 REST API。通过在 Agent Registry 中将这些目标注册为受管的代理组件，您可以集中管理代理舰队可以连接到的外部端点。

本文档介绍如何在注册表中显式注册外部端点。

准备工作

在开始之前，请设置 Agent Registry。您需要 项目 ID 才能 执行这些任务。

如需使用本文档中的 Google Cloud CLI 命令，请确保您已 设置 gcloud CLI 环境。

所需角色

如需获得在 Agent Registry 中注册端点所需的权限，请让您的管理员为您授予项目的 Agent Registry API Editor (roles/agentregistry.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

注册端点

由于端点是自定义的外部目标，因此请使用 手动注册将其添加到 Agent Registry：

控制台

  1. 在 Google Cloud 控制台中，前往 Agent Registry：

    前往 Agent Registry

  2. 在项目选择器中，选择您在其中 设置 Agent Registry的 Google Cloud 项目。

  3. 选择端点 标签页。

  4. 点击添加端点 。

  5. 在端点详细信息 面板中，输入显示名称、说明、地理区域和目标网址。

    （可选）点击此面板中的测试连接 ，以测试与目标网址的连接。

  6. 点击保存 。

gcloud

您可以使用 endpoint-spec-type 为 no-spec 创建 Service 资源。

注册端点并定义其接口连接详细信息：

gcloud alpha agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

替换以下内容：

  • ENDPOINT_NAME：您要为端点指定的名称，例如 my-external-api。
  • PROJECT_ID：项目 ID。
  • REGION：注册表区域。
  • DISPLAY_NAME：端点的直观易懂的名称。
  • ENDPOINT_URL：目标网址，例如 https://api.example.com/v1/data。
  • PROTOCOL：接口的协议绑定。 有效值为 HTTP_JSON、GRPC 或 JSONRPC。

创建 Service 资源后，Agent Registry 会在消费者端自动 生成只读 Endpoint 资源，代理和 编排器可以发现并使用该资源。