Kurzanleitung: Agent kennenlernen

Discovery ist der zentrale Mechanismus, um die Entwicklung mit agentischen Arbeitslasten zu beschleunigen. Wenn Sie in Agent Registry suchen, können Sie vorhandene KI-Agenten mit den benötigten Fähigkeiten finden, z. B. einen „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. Außerdem benötigen Sie 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 einrichten.

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 nach 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 KI-Agenten 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 die Agent Registry auf:

    Zur 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, Kennung, Beschreibung, Laufzeit und Speicherort.

  4. Wenn Sie alle Details zu einem Agent ansehen 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-Agentenkarte, 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 die Agent Registry auf:

    Zur 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, Kennung, Beschreibung, Laufzeit und Speicherort.

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

    • Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort, wählen Sie die gewünschten Standorte aus und klicken Sie auf Übernehmen.
    • Wenn Sie nach Laufzeit filtern möchten, klicken Sie auf das Menü Laufzeit, wählen Sie die gewünschten Laufzeiten aus und klicken Sie auf Übernehmen.

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

gcloud

Filtern Sie Ihre Agentenliste, 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 Agenten, die Sie filtern möchten. Wenn Sie beispielsweise nach dem Anzeigenamen filtern möchten, können Sie displayName='DISPLAY_NAME' verwenden. Wenn Sie nach der global eindeutigen Kennung (URN) filtern möchten, können Sie agentId='urn:agent:AGENT_URN' verwenden.

Agentendetails ansehen

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

Console

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

    Zur 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, Kennung, Beschreibung, Laufzeit und Speicherort.

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

    Die Detailseite enthält Tabs für die Agentendetails.

  5. Klicken Sie auf den entsprechenden Tab, um bestimmte Agentendetails aufzurufen.

    Die Verfügbarkeit der Funktion hängt von Ihrer Laufzeit ab. Tabs wie Sitzungen, Playground, Arbeitsspeicher und Bewertung sind spezifische Funktionen, die für KI-Agenten angezeigt werden, die auf verwalteten Laufzeitumgebungen wie der Vertex AI Agent Engine basieren:

    • Übersicht: Wichtige Details zum Agenten, einschließlich Name, Kennung, Speicherort, Beschreibung und Laufzeit. In der Übersicht werden auch Fähigkeiten und der Ressourcen-URI angezeigt, die Sie zum Erstellen von Abfragen im Topologie-Diagramm benötigen.
    • Beobachtbarkeit: Anwendungsorientierte Statistiken wie Latenz, Traffic, Fehler und Token-Ausgaben. Auf diesem Tab sind Google Cloud Observability-Tools integriert, um Leistungsstatistiken in Echtzeit und die Auslastung auf Systemebene anzuzeigen. So können Sie Kosten und Nutzerfreundlichkeit besser verwalten. Weitere Informationen finden Sie in der Übersicht zur Beobachtbarkeit.
    • Traces: Der genaue Pfad eines Gesprächs Schritt für Schritt, einschließlich detaillierter Formatierung von Eingabe- und Assistentennachrichten, um komplexe Multi-Agent-Reasoning Loops oder Tool-Aufruffehler 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 Inhaltsrichtlinien, Risiken von 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, seinem zugewiesenen Agent Gateway und den MCP-Servern, mit denen er interagiert. Weitere Informationen zum KI-Agenten-Gateway finden Sie unter KI-Agenten-Gateway – Übersicht. Weitere Informationen zur Topologie finden Sie unter Diagramme für einen registrierten Agent ansehen.
    • Identität: Der Agent-Principal, der für die Richtliniendurchsetzung verwendet wird. Sie verwenden diese Identität beispielsweise, um Bindungen für Authentifizierungsanbieter für die Authentifizierung bei Tools und Ressourcen zu konfigurieren.
    • Sitzungen: Nichtflüchtiger Unterhaltungsverlauf und Tracking aktiver Interaktionen mit dem Agenten.
    • Playground: Eine direkte Chat-Oberfläche zum Testen des Verhaltens des Agenten.
    • Gemerkt: Langfristige Personalisierungsfunktionen, die Details aus früheren Unterhaltungen mit dem Agent generieren oder abrufen, um den Kontext über Interaktionen hinweg beizubehalten.
    • Bewertung: Details zu allen Bewertungsaufgaben für Agenten. Auf diesem Tab können Sie neue Bewertungsaufgaben erstellen, Messwerte hochladen und die kognitive Leistung des Agents und die Zuverlässigkeit des Modells anhand von Live-Traffic oder synthetischen Simulationen bewerten.

gcloud

Wenn Sie die detaillierten Metadaten eines bestimmten Agents aufrufen möchten, verwenden Sie den Befehl agents describe:

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

Ersetzen Sie Folgendes:

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

Mit dem Endpunkt des Agents, den Skill-Definitionen und den reinen Ausgabemetadaten wie dem zugrunde liegenden Framework, der Laufzeitidentität und der vollständigen A2A-Agentenkarte können Sie Ihren Agenten sicher an Ihre Orchestrator-Workflows binden. Verwenden Sie dazu das Agent Development Kit (ADK) oder Standard-API-Anfragen.

Nächste Schritte