查看技能发布商详细信息

在 Agent Registry 中,发布商是指发布代理技能的经过验证 的权威机构。发布商会规定技能可以使用的前缀,以防止抢注名称并强制执行身份验证。例如,google- 前缀专供经过验证的 Google 技能使用。

本文档介绍了如何查看和检查已注册技能的经过验证的发布商详细信息。

只有 Google 内部管理员才能创建、更新或删除发布商,以及管理经过验证的前缀分配。您或其他用户创建的技能会自动分配给默认的 private 发布商,因此特定技能的已发布 ID 会以 private-为前缀。您无法注册自定义发布商资源。

准备工作

开始之前,请先设置 Agent Registry注册独立技能。您需要 项目 ID 才能执行 这些任务。

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

所需的角色

如需获得在 Agent Registry 中查看技能发布商详细信息所需的权限,请让您的管理员为您授予项目的Agent Registry User (roles/agentregistry.user) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

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

发布商层级

发布商分为多个层级,这些层级反映了发布商的验证级别:

  • 第一方 (FIRST_PARTY): 经过验证的 Google 精选全球发布商。 例如,publishers/cloud.google.compublishers/discoveryengine.googleapis.com
  • 私有 (PRIVATE): 系统会自动将默认的 private 发布商分配给您或其他用户在项目中创建的技能。

列出发布商

您可以列出在您的位置配置的所有发布商:

控制台

  1. 在 Google Cloud 控制台中,前往 Agent Registry 页面:

    前往 Agent Registry

  2. 选择技能 标签页。该页面会显示您所有 已注册技能的列表。
  3. 在所有已注册技能的发布商 列中,您可以浏览与每个技能关联的所有可用的经过验证的发布商。

gcloud

gcloud alpha agent-registry publishers list \
  --project=PROJECT_ID \
  --location=LOCATION

替换以下内容:

  • PROJECT_ID:项目 ID。
  • LOCATION:注册表位置。

REST

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"

替换以下内容:

  • PROJECT_ID:项目 ID。
  • LOCATION:注册表位置。

查看发布商详细信息

您可以检查特定发布商的详细信息:

控制台

  1. 在 Google Cloud 控制台中,前往 Agent Registry 页面:

    前往 Agent Registry

  2. 选择技能 标签页。
  3. 点击技能的名称以打开其详细信息页面。
  4. 技能详细信息 部分中,找到技能的统一资源名称 (URN)。

    使用此技能 URN 字段查找特定发布商的资产。例如,Google 创建的技能的格式为 urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID

gcloud

gcloud alpha agent-registry publishers describe PUBLISHER_ID \
  --project=PROJECT_ID \
  --location=LOCATION

替换以下内容:

  • PUBLISHER_ID:您要查看的发布商的 ID。
  • PROJECT_ID:项目 ID。
  • LOCATION:注册表位置。

REST

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"

替换以下内容:

  • PROJECT_ID:项目 ID。
  • LOCATION:注册表位置。
  • PUBLISHER_ID:您要查看的发布商的 ID。

后续步骤