查看技能发布商详细信息

在 Agent Registry 中,发布商可让您验证已注册的独立技能背后的授权,以帮助防止未经授权使用发布商名称。每个发布商都会为技能标识符建立经过验证的网域或 ID 前缀,例如 Google 管理的技能为 cloud.google.com,手动注册的技能为 private-。

Google 控制发布商的创建、更新和删除。您创建的技能会自动分配给默认的 private 发布商,该发布商使用 private- 前缀。您可以在智能体注册表中列出并检查发布商详细信息,以验证已注册技能的所有权。

准备工作

  1. 设置 Agent Registry。
  2. 对于单项目设置,请获取已启用 Agent Registry 的治理项目的项目 ID。如果您为多个项目配置了管理边界,请使用管理项目的 ID 进行边界范围内的发现和注册,或指定成员项目 ID 进行单项目操作。

  3. 注册独立技能。

  4. 如需使用本文档中的 Google Cloud CLI 命令,请设置 gcloud CLI 环境。

所需的角色

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

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

其他 Agent Registry 角色也可能包含查看技能发布者详细信息所需的权限。如需了解详情,请参阅 Agent Registry 角色和权限。

发布商层级

发布商会根据其验证级别进行分级:

  • Google 管理 (FIRST_PARTY):由 Google 管理的经过验证的发布商,例如 cloud.google.com 和 discoveryengine.googleapis.com。
  • 私有 (PRIVATE):默认的 private 发布者,会自动分配给您或其他用户在项目中创建的技能。

列出发布商

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

控制台

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

    前往 Agent Registry

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

gcloud

如需列出某个位置的所有经过验证的发布商,请运行 gcloud alpha agent-registry publishers list 命令:

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. 在技能详情部分中,找到技能的技能标识符。

    使用此技能标识符字段可查找特定发布商的素材资源。例如,Google 管理的 skill 的格式为 urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID。

gcloud

如需查看特定发布商的详细信息,请运行 gcloud alpha agent-registry publishers describe 命令:

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。

后续步骤