Kurzanleitung: Agent kennenlernen

Die Suche ist der wichtigste Mechanismus, um die Entwicklung mit agentischen Arbeitslasten zu beschleunigen. Wenn Sie in der Agent Registry suchen, können Sie vorhandene Agents mit den benötigten Fähigkeiten finden, z. B. einen vorhandenen „Corporate Policy Agent“ oder einen „Flight Booking Agent“, anstatt doppelte Integrationen von Grund auf neu zu erstellen.

In dieser Kurzanleitung erfahren Sie, wie Sie in der Agent Registry registrierte Agents finden.

Hinweis

Bevor Sie mit dieser Kurzanleitung beginnen, registrieren Sie einen Agent in der Agent Registry. Sie benötigen außerdem Ihre Projekt-ID um diese Aufgaben auszuführen.

Wenn Sie die gcloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre Google Cloud CLI-Umgebung eingerichtet haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Viewer (roles/agentregistry.viewer) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen von Agents in der Agent Registry benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Verfügbare Agents auflisten

So rufen Sie eine vollständige Liste aller in der Registry registrierten und indexierten Agents auf:

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 die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agents aus.

    Auf der Seite wird eine Liste aller registrierten Agents und ihrer Details angezeigt, z. B. Name, ID, Beschreibung, Laufzeit und Standort.

  4. Wenn Sie die vollständigen Details eines Agents aufrufen möchten, klicken Sie auf den Namen des Agents.

gcloud

Verwenden Sie den Befehl agents list, um alle Agents an einem bestimmten Standort aufzulisten:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID
  • REGION: die Registry-Region

Die Ausgabe sieht so aus:

- name: projects/1234567890/locations/us-central1/agents/my-travel-agent
  displayName: Travel Orchestrator Agent
  description: 'Decomposes natural language travel requests into sub-tasks.'
  version: 1.0.0
  protocols:
    - type: A2A_AGENT
      protocolVersion: "0.3"
      interfaces:
        - url: https://api.example.com/.well-known/agent-card.json
          protocolBinding: HTTP_JSON
  attributes:
    agentregistry.googleapis.com/system/Framework:
      framework: "google-adk"
    agentregistry.googleapis.com/system/RuntimeIdentity:
      identity: "principal://..."
  card:
    type: A2A_AGENT_CARD
    content: {...}

Das Feld card enthält den vollständigen Inhalt der A2A-Agent-Karte, sofern verfügbar.

Registrierte Agents filtern

Wenn Sie mehrere Agents haben oder die Registrierung eines bestimmten Agents bestätigen möchten, können Sie die Liste nach den Metadaten des Agents filtern:

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 die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agents aus.

    Auf der Seite wird eine Liste aller registrierten Agents und ihrer Details angezeigt, z. B. Name, ID, Beschreibung, Laufzeit und Standort.

  4. Filtern Sie die Liste nach dem Standort des Agents oder seiner Laufzeitressource:

    • 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 Laufzeit filtern möchten, klicken Sie auf das Menü Laufzeit , wählen Sie die Laufzeiten aus, nach denen Sie filtern möchten, und klicken Sie auf Anwenden.

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

gcloud

Filtern Sie die Agent-Liste, um nur Ressourcen zurückzugeben, die bestimmten Schlüssel-Wert-Paaren entsprechen. Verwenden Sie dazu das Flag --filter:

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 Agents, die 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.

Agent-Details ansehen

Wenn Sie einen Agenten identifiziert haben, den Sie verwenden möchten, können Sie die vollständigen Metadaten abrufen, einschließlich des Laufzeitendpunkts und einer vollständigen Liste der Skills:

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 die Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab Agents aus.

    Auf der Seite wird eine Liste aller registrierten Agents und ihrer Details angezeigt, z. B. Name, ID, Beschreibung, Laufzeit und Standort.

  4. Klicken Sie auf den Namen des Agents, den Sie aufrufen möchten.

    Auf der Detailseite gibt es Tabs für die Agent-Details.

  5. Klicken Sie auf den entsprechenden Tab, um bestimmte Agent-Details aufzurufen.

    Die Verfügbarkeit der Funktion hängt von Ihrer Laufzeit ab. Die Tabs Sessions, Playground, Memories und Evaluation sind spezifische Funktionen, die für Agents angezeigt werden, die auf verwalteten Laufzeiten wie Vertex AI Agent Engine basieren:

    • Übersicht: Wichtige Details zum Agent, einschließlich Name, ID, Standort, Beschreibung und Laufzeit. In der Übersicht werden auch Fähigkeiten und der Ressourcen-URI angezeigt, die Sie zum Erstellen von Abfragen im Topologiediagramm benötigen.
    • Beobachtbarkeit: Anwendungsbezogene Statistiken wie Latenz, Traffic, Fehler und Token-Ausgaben. Dieser Tab ist in Google Cloud Observability-Tools eingebunden, um Leistungsstatistiken in Echtzeit und die Auslastung auf Systemebene anzuzeigen. So können Sie Kosten und Nutzerfreundlichkeit verwalten. Weitere Informationen finden Sie unter Übersicht zur Beobachtbarkeit.
    • Traces: Der genaue Pfad eines Unterhaltungsschritts, einschließlich detaillierter Formatierung von Eingabe- und Assistentennachrichten, um komplexe Reasoning-Loops mit mehreren Agents oder Fehler bei der Tool-Aufrufung in Echtzeit zu debuggen. Weitere Informationen finden Sie unter Agent-Traces ansehen.
    • Sicherheit: Ergebnisse von Model Armor und Security Command Center, einschließlich Verstößen gegen die Content-Richtlinie, Risiken für Datenlecks und Compliance-Bewertungen. Weitere Informationen zur Sicherheit finden Sie unter Sicherheitsergebnisse ansehen.
    • Topologie: Eine visuelle Karte der Beziehungen und Traffic-Flüsse zwischen einem Agent, dem zugewiesenen Agent Gateway und den MCP Servern, mit denen er interagiert. Weitere Informationen zu Agent Gateway finden Sie unter der Übersicht zu Agent Gateway. Weitere Informationen zur Topologie finden Sie unter Diagramme für einen registrierten Agent ansehen.
    • Identität: Das Agent-Hauptkonto , das für die Richtlinienerzwingung verwendet wird. Mit dieser Identität können Sie beispielsweise Bindungen für Authentifizierungsanbieter für die Authentifizierung bei Tools und Ressourcen konfigurieren.
    • Sitzungen: Permanenter Unterhaltungsverlauf und Tracking aktiver Interaktionen mit dem Agent.
    • Playground: Eine direkte Chat-Oberfläche zum Testen des Verhaltens des Agents.
    • Memories: Langfristige Personalisierungsfunktionen, die Details aus früheren Unterhaltungen mit dem Agent generieren oder abrufen, um den Kontext über Interaktionen hinweg zu erhalten.
    • Evaluation: Details zu allen Agent-Bewertungsaufgaben. Auf diesem Tab können Sie neue Bewertungsaufgaben erstellen, Messwerte hochladen und die kognitive Leistung und Modellzuverlässigkeit des Agents anhand von Live-Traffic oder synthetischen Simulationen bewerten.

gcloud

Verwenden Sie den Befehl agents describe, um die detaillierten Metadaten eines bestimmten Agents aufzurufen:

gcloud alpha agent-registry agents describe AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Ersetzen Sie Folgendes:

  • AGENT_NAME: der Name Ihres Agents, z. B. my-travel-agent
  • PROJECT_ID: die Projekt-ID
  • REGION: die Registry-Region

Mit dem Endpunkt des Agents, den Fähigkeitsdefinitionen und den Metadaten, die nur in der Ausgabe enthalten sind, z. B. dem zugrunde liegenden Framework, der Laufzeitidentität und der vollständigen A2A-Agent-Karten-Nutzlast, können Sie Ihren Agent mit dem Agent Development Kit (ADK) oder Standard-API-Anfragen sicher an Ihre Orchestrator-Workflows binden.

Nächste Schritte