Automatische Registrierung verwenden

Agent Registry kann Agenten, die auf unterstützten Google Cloud Runtimes gehostet werden, erkennen und registrieren, ohne dass Sie die Agent Registry API manuell aufrufen müssen. Je nach Runtime erfolgt diese Registrierung automatisch oder erfordert einen Opt-in-Konfigurationsschritt während der Bereitstellung.

In diesem Dokument wird erläutert, wie Sie die Erkennung für Agenten auf unterstützten Runtimes aktivieren. Wenn Sie einen Agenten extern oder auf einer nicht unterstützten Runtime hosten, siehe Manuelle Registrierung verwenden.

Die Metadaten und Skills, die während der Registrierung aus einem Agenten extrahiert werden, hängen vom Protokoll des Agenten ab. Weitere Informationen finden Sie unter Agenten registrieren.

Agenten aus Vertex AI Agent Engine registrieren

Wenn Sie Agenten mit Vertex AI Agent Engine entwickeln und sie mit dem Vertex AI SDK bereitstellen, erfolgt die Registrierung in Agent Registry automatisch.

Das Agent2Agent-Protokoll (A2A) ist ein offener Standard, mit dem Agenten ihre Fähigkeiten und Identität deklarieren können. Das folgende Beispiel zeigt, wie Sie einen Agenten, der das A2A-Protokoll implementiert, in Vertex AI Agent Engine bereitstellen. Weitere Informationen finden Sie unter Agenten bereitstellen.

# 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]"],
    },
)

Wenn Sie Ihren Agenten in Vertex AI Agent Engine aktualisieren oder löschen, synchronisiert Agent Registry diese Änderungen automatisch.

Integrierte Google-Agenten registrieren

Integrierte Google-Agenten wie Google Workspace und Gemini Enterprise-Agenten werden automatisch in Agent Registry eingebunden. Sie müssen keine Konfigurations- oder Bereitstellungsschritte ausführen. Diese Agenten werden aufgenommen und können in Ihrer Registry erkannt werden.

Agenten aus GKE registrieren

Sie können Agenten, die in Google Kubernetes Engine bereitgestellt wurden, registrieren, indem Sie Ihren Bereitstellungen die apphub.cloud.google.com/functional-type: "AGENT" Annotation hinzufügen. Diese Annotation kennzeichnet die Bereitstellung als KI-Agenten, sodass Agent Registry einen Introspektionsscan durchführen kann.

Das folgende Beispiel zeigt ein GKE-Agentenbereitstellungsmanifest. Weitere Informationen finden Sie unter KI-Agenten bereitstellen und orchestrieren.

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

Wenn die Bereitstellung angewendet wird, versucht der GKE-Cluster automatisch, Metadaten vom Agenten abzurufen und sie direkt mit dem Agent Registry-Datenmodell zu synchronisieren.

Registrierung bestätigen

Sie können prüfen, ob Agent Registry Ihre Agenten erfolgreich registriert hat, indem Sie sie auflisten:

Console

  1. Rufen Sie in der Google Cloud Console Agent Registry auf:

    Zu Agent Registry

  2. Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agenten aus.

    Auf der Seite wird eine Liste aller registrierten Agenten mit Details wie Name, ID, Beschreibung, Runtime und Standort angezeigt.

  4. Filtern Sie die Liste nach dem Standort des Agenten oder seiner Runtime-Ressource:

    • Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort , wählen Sie die Standorte aus, nach denen Sie filtern möchten, und klicken Sie auf Anwenden.
    • Wenn Sie nach Runtime filtern möchten, klicken Sie auf das Menü Runtime , wählen Sie die Runtimes aus, nach denen Sie filtern möchten, und klicken Sie auf Anwenden.

    Auf der Seite wird eine gefilterte Liste der registrierten Agenten für die ausgewählten Bedingungen angezeigt.

gcloud

Wenn Sie mehrere Agenten haben oder die Registrierung eines bestimmten Agenten bestätigen möchten, z. B. eines automatisch registrierten Agenten, können Sie die Liste nach den Metadaten des Agenten filtern.

Dazu müssen Sie Ihre Google Cloud CLI-Umgebung für Agent Registry eingerichtet haben und dann Folgendes ausführen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID
  • REGION: die Registry-Region
  • FILTER_EXPRESSION: der Filterausdruck für die Agenten, nach denen Sie filtern möchten Wenn Sie beispielsweise nach Anzeigenamen filtern möchten, können Sie verwenden displayName='DISPLAY_NAME'. Wenn Sie nach der global eindeutigen ID (URN) filtern möchten, können Sie agentId='urn:agent:AGENT_URN' verwenden.

Integrierte Google-Dienste verwenden ein URN-Format, das davon abhängt, wo der Agent bereitgestellt wird. Sie können beispielsweise integrierte Google Workspace-Agenten finden, indem Sie Ihre Liste nach dem googleapis.com Herausgeber filtern: --filter="agentId:'urn:agent:googleapis.com:*'"