Revisa los detalles del publicador de la skill

En el Registro de agentes, los publicadores te permiten verificar la autoridad detrás de las habilidades independientes registradas para ayudar a evitar el uso no autorizado de los nombres de los publicadores. Cada publicador establece el dominio verificado o el prefijo de ID para los identificadores de habilidades, como cloud.google.com para las habilidades administradas por Google o private- para las habilidades registradas de forma manual.

Google controla la creación, las actualizaciones y las eliminaciones de publicadores. Las habilidades que creas se asignan automáticamente al publicador predeterminado private, que usa el prefijo private-. Puedes enumerar e inspeccionar los detalles del publicador en el Registro de agentes para verificar la propiedad de las habilidades registradas.

Antes de comenzar

  1. Configura el Registro de agentes.

  2. Para una configuración de un solo proyecto, obtén el ID del proyecto del proyecto de administración en el que está habilitado el Registro de agentes. Si configuraste un límite de administración para varios proyectos, usa el ID de tu proyecto de administración para el descubrimiento y el registro en todo el límite, o especifica un ID del proyecto miembro para las operaciones de un solo proyecto.

  3. Registra una habilidad independiente.

  4. Para usar los comandos de Google Cloud CLI en este documento, configura tu entorno de gcloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para revisar los detalles del publicador de habilidades en el Registro de agentes, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de la API de Agent Registry (roles/agentregistry.viewer) en el proyecto de administración en el que está habilitado el Registro de agentes. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Otros roles de Agent Registry también podrían incluir los permisos necesarios para ver los detalles del publicador de habilidades. Para obtener más información, consulta Roles y permisos de Agent Registry.

Niveles de publicador

Los publicadores se clasifican en niveles que reflejan su nivel de verificación:

  • Administrados por Google (FIRST_PARTY): Son publicadores verificados que administra Google, como cloud.google.com y discoveryengine.googleapis.com.
  • Privado (PRIVATE): Es el publicador de private predeterminado que se asigna automáticamente a las habilidades que tú o los demás usuarios crean en el proyecto.

Enumera publicadores

Puedes enumerar todos los publicadores configurados en tu ubicación:

Console

  1. En la consola de Google Cloud , ve a la página Registro de agentes:

    Ir al registro de agentes

  2. Selecciona la pestaña Habilidades. En la página, se muestra una lista de todas tus habilidades registradas.
  3. En la columna Publicador de todas las habilidades registradas, puedes explorar todos los publicadores verificados disponibles que asociaste con cada una de tus habilidades.

gcloud

Para enumerar todos los publicadores verificados en una ubicación, ejecuta el comando gcloud alpha agent-registry publishers list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación del registro.

REST 

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación del registro.

Ver detalles del publicador

Puedes inspeccionar los detalles de un publicador específico:

Console

  1. En la consola de Google Cloud , ve a la página Registro de agentes:

    Ir al registro de agentes

  2. Selecciona la pestaña Habilidades.
  3. Haz clic en el nombre de una habilidad para abrir su página de detalles.

  4. En la sección Detalles de la habilidad, busca el identificador de la habilidad.

    Usa este campo de identificador de habilidad para encontrar los recursos de un publicador específico. Por ejemplo, el formato de las habilidades administradas por Google es urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.

gcloud

Para ver los detalles de un publicador específico, ejecuta el comando gcloud alpha agent-registry publishers describe:

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

Reemplaza lo siguiente:

  • PUBLISHER_ID: Es el ID del publicador que deseas revisar.
  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación del registro.

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"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación del registro.
  • PUBLISHER_ID: Es el ID del publicador que deseas revisar.

¿Qué sigue?