Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Usa el registro automático

Agent Registry puede registrar agentes alojados en tiempos de ejecución Google Cloud compatibles sin que tengas que llamar manualmente a la API de Agent Registry. Según el tiempo de ejecución, este proceso de registro se realiza automáticamente o requiere un paso de configuración de aceptación durante la implementación.

En este documento, se explica cómo habilitar el descubrimiento para los agentes en los tiempos de ejecución compatibles. Si alojas un agente de forma externa o en un tiempo de ejecución no compatible, consulta Cómo usar el registro manual.

Los metadatos y las habilidades que se extraen de un agente durante su registro dependen del protocolo del agente. Para obtener más información, consulta Cómo registrar agentes.

Antes de comenzar

Antes de registrar agentes, configura el Registro de agentes. Necesitas el ID de tu proyecto para verificar el registro.

Para usar los comandos de Google Cloud CLI en este documento, asegúrate de configurar tu entorno de gcloud CLI.

Registra agentes desde Agent Runtime

Si desarrollas e implementas agentes con Agent Runtime en Gemini Enterprise Agent Platform, el registro en Agent Registry es automático.

El protocolo Agent2Agent (A2A) es un estándar abierto que permite que los agentes declaren sus capacidades y su identidad. En el siguiente ejemplo, se muestra cómo implementar un agente que implementa el protocolo A2A en Agent Runtime. Para obtener más información, consulta Implementa un agente.

# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
    agent=my_a2a_agent, # Your defined A2A object
    config={
        "display_name": "my-support-agent",
        "description": "An agent that handles support tickets.",
        "requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
    },
)

A medida que actualizas o borras tu agente en Agent Runtime, Agent Registry sincroniza automáticamente esos cambios.

Registra agentes integrados de Google

Los agentes integrados de Google, como los agentes de Google Workspace y Gemini Enterprise, se registran automáticamente en Agent Registry. No es necesario que realices ningún paso de configuración o implementación. Estos agentes se incorporan y están disponibles para el descubrimiento en tu registro.

Registra agentes desde GKE

Puedes registrar los agentes implementados en Google Kubernetes Engine (GKE) agregando la anotación apphub.cloud.google.com/functional-type: "AGENT" a tus implementaciones. Esta anotación identifica la implementación como un agente de IA, lo que permite que Agent Registry realice un análisis de introspección.

En el siguiente ejemplo, se muestra un manifiesto de implementación del agente de GKE. Para obtener más información, consulta Implementa y coordina agentes de IA.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the deployment as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

Cuando se aplica la implementación, el clúster de GKE intenta automáticamente recuperar metadatos del agente y los sincroniza directamente en el modelo de datos del Registro de agentes.

Verifica el registro

Para verificar que Agent Registry haya registrado tus agentes correctamente, haz lo siguiente:

Console

En la consola de Google Cloud , ve a Agent Registry:

Ir a Agent Registry
En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud
Selecciona la pestaña Agentes.

En la página, se muestra una lista de todos los agentes registrados y sus detalles, como el nombre, el identificador, la descripción, el tiempo de ejecución y la ubicación.
Filtra la lista por la ubicación del agente o su recurso de tiempo de ejecución:
- Para filtrar por ubicación, haz clic en el menú Ubicación, selecciona las ubicaciones por las que deseas filtrar y haz clic en Aplicar.
- Para filtrar por tiempo de ejecución, haz clic en el menú Tiempo de ejecución, selecciona los tiempos de ejecución por los que deseas filtrar y haz clic en Aplicar.
En la página, se muestra una lista filtrada de los agentes registrados para las condiciones que seleccionaste.

gcloud

Puedes filtrar la lista por los metadatos del agente. Asegúrate de configurar tu entorno de Google Cloud CLI para Agent Registry y, luego, ejecuta el siguiente comando:

gcloud agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto
REGION: Es la región del registro.
FILTER_EXPRESSION: Es la expresión de filtro para los agentes que deseas filtrar. Por ejemplo, para filtrar por nombre visible, puedes usar displayName='DISPLAY_NAME'. Para filtrar por el identificador (URN) único a nivel global, puedes usar agentId='urn:agent:AGENT_URN'.

Los agentes integrados de Google usan un formato de URN que depende de dónde se implemente el agente. Por ejemplo, puedes descubrir agentes integrados de Google Workspace filtrando tu lista por el publicador googleapis.com con --filter="agentId:'urn:agent:googleapis.com:*'".

Terraform

Haz referencia a tu agente registrado en otras configuraciones de Terraform con la fuente de datos google_agent_registry_agent:

data "google_agent_registry_agent" "my_agent" {
  location = "REGION"
  filter = "displayName=\"DISPLAY_NAME\""
}

output "agent_urn" {
  value = data.google_agent_registry_agent.my_agent.urn
}