Review skill publisher details

In Agent Registry, a publisher represents a verified authority that publishes agent skills. Publishers dictate the prefixes that skills can use to prevent name squatting and enforce identity verification. For example, the google- prefix is reserved for verified Google skills.

This document explains how to review and inspect verified publisher details for your registered skills.

Creating, updating, or deleting publishers, and managing verified prefix allocations, is restricted to Google-internal administrators. The skills that you or other users create are automatically assigned to the default private publisher, so the published ID of a particular skill is prefixed with private-. You can't register custom publisher resources.

Before you begin

Before you start, set up Agent Registry and register a standalone skill. You need the project ID to perform these tasks.

To use the Google Cloud CLI commands in this document, make sure you have set up your gcloud CLI environment.

Required roles

To get the permissions that you need to review skill publisher details in Agent Registry, ask your administrator to grant you the Agent Registry User (roles/agentregistry.user) IAM role on the project. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Publisher tiers

Publishers are categorized into tiers that reflect their level of verification:

  • First-party (FIRST_PARTY): Verified Google-curated global publishers. For example, publishers/cloud.google.com and publishers/discoveryengine.googleapis.com.
  • Private (PRIVATE): The default private publisher automatically assigned to the skills you or other users create within the project.

List publishers

You can list all publishers configured in your location:

Console

  1. In the Google Cloud console, go to the Agent Registry page:

    Go to Agent Registry

  2. Select the Skills tab. The page displays a list of all your registered skills.
  3. In the Publisher column of all registered skills, you can browse all available verified publishers that you associated with each of your skills.

gcloud 

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

Replace the following:

  • PROJECT_ID: The project ID.
  • LOCATION: The registry location.

REST 

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

Replace the following:

  • PROJECT_ID: The project ID.
  • LOCATION: The registry location.

View publisher details

You can inspect details for a specific publisher:

Console

  1. In the Google Cloud console, go to the Agent Registry page:

    Go to Agent Registry

  2. Select the Skills tab.
  3. Click the name of a skill to open its details page.

  4. In the Skill details section, locate the Uniform Resource Name (URN) of the skill.

    Use this skill URN field to find a specific publisher's assets. For example, the format for Google-created skills is urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID

gcloud 

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

Replace the following:

  • PUBLISHER_ID: The ID of the publisher you want to review.
  • PROJECT_ID: The project ID.
  • LOCATION: The registry 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"

Replace the following:

  • PROJECT_ID: The project ID.
  • LOCATION: The registry location.
  • PUBLISHER_ID: The ID of the publisher you want to review.

What's next