Usa el registro automático

Agent Registry puede descubrir y registrar agentes alojados en entornos de ejecución compatibles Google Cloud sin que tengas que llamar manualmente a la API de Agent Registry. Según el entorno 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 de agentes en entornos de ejecución compatibles. Si alojas un agente de forma externa o en un entorno de ejecución no compatible, consulta Cómo usar el registro manual.

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

Registra agentes desde Vertex AI Agent Engine

Si desarrollas agentes con Vertex AI Agent Engine y los implementas con el SDK de Vertex AI, 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 e identidad. En el siguiente ejemplo, se muestra cómo implementar un agente que implementa el protocolo A2A en Vertex AI Agent Engine. Para obtener más información, consulta Cómo implementar 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 Vertex AI Agent Engine, Agent Registry sincroniza automáticamente esos cambios.

Registra agentes integrados de Google

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

Registra agentes desde GKE

Puedes registrar agentes implementados en Google Kubernetes Engine agregando la apphub.cloud.google.com/functional-type: "AGENT" anotación 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 de agente de GKE. Para obtener más información, consulta Cómo implementar y organizar agentes de IA.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the workload 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 recuperar automáticamente los metadatos del agente y los sincroniza directamente en el modelo de datos de Agent Registry.

Verifica el registro

Para verificar que Agent Registry haya registrado correctamente tus agentes, enuméralos:

Console

  1. En la Google Cloud consola, ve a Agent Registry:

    Ir a Agent Registry

  2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste Agent Registry.

  3. 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 entorno de ejecución y la ubicación.

  4. Filtra la lista por la ubicación del agente o su recurso de entorno de ejecución:

    • Para filtrar por ubicación, haz clic en el menú Ubicación , selecciona las ubicaciones que deseas filtrar y haz clic en Aplicar.
    • Para filtrar por entorno de ejecución, haz clic en el menú Entorno de ejecución , selecciona los entornos de ejecución que deseas filtrar y haz clic en Aplicar.

    En la página, se muestra una lista filtrada de los agentes registrados para las condiciones seleccionadas.

gcloud

Si tienes varios agentes o deseas confirmar el registro de un agente específico, como un agente registrado automáticamente, puedes filtrar la lista por los metadatos del agente.

Para ello, asegúrate de haber configurado tu entorno de Google Cloud CLI para Agent Registry y, luego, ejecuta lo siguiente:

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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro
  • FILTER_EXPRESSION: 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 único global (URN), puedes usar agentId='urn:agent:AGENT_URN'.

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