KI-Agenten verwalten

Vorschau

Dieses Produkt oder Feature unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Für eine effektive Verwaltung Ihrer Agent-Flotte ist es erforderlich, das Registry auf dem neuesten Stand zu halten. Dazu müssen Sie die Dienstdetails ansehen und aktualisieren, wenn sich Ihre Arbeitslasten ändern, Metadaten überschreiben oder nicht mehr verwendete Agents entfernen.

In diesem Dokument wird beschrieben, wie Sie die Details und die Konfiguration Ihres registrierten Agents aufrufen und ändern.

Hinweis

Bevor Sie Agenten verwalten, müssen Sie Ihre Agenten in der Agent Registry registrieren. 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 Editor (roles/agentregistry.editor) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten registrierter 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 Agenten entdecken

Nach der Registrierung von Agents können Sie sie in Ihrer Umgebung finden und ihre detaillierten Konfigurationen ansehen, z. B. Endpunkte, Skills und zugehörige Metadaten.

KI-Agenten auflisten und ansehen

Sie können alle in Ihrer Umgebung registrierten Agents auflisten und ihre detaillierten Konfigurationen ansehen, z. B. ihre Endpunkte, Skills und zugehörigen Metadaten:

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 angezeigt. Die Liste enthält den Namen des Agents, die Kennung, den Typ, die Beschreibung, die Version, die Laufzeit und den Speicherort.

4. Wenn Sie alle Details eines Agenten ansehen möchten, klicken Sie auf den Namen des Agenten.

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.

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 angezeigt. Die Liste enthält den Namen des Agents, die Kennung, den Typ, die Beschreibung, die Version, die Laufzeit und den 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 Metadaten entsprechen. Verwenden Sie dazu das Flag --filter:

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

Ersetzen Sie FILTER_EXPRESSION durch den Filterausdruck für die Agents, die Sie filtern möchten. Sie können beispielsweise die folgenden Filter verwenden:

• Wenn Sie nach Anzeigenamen filtern möchten, verwenden Sie displayName='DISPLAY_NAME'.
• Wenn Sie nach der global eindeutigen Kennung (URN) suchen möchten, verwenden Sie agentId='urn:agent:AGENT_URN'.

Details eines Agenten ansehen

Details zu einem bestimmten Agent ansehen, einschließlich seiner Protokolle, Skills und Identität:

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 angezeigt. Die Liste enthält den Namen des Agents, die Kennung, den Typ, die Beschreibung, die Version, die Laufzeit und den 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, Memories 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: Anwendungsbezogene 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 unter Übersicht über die Beobachtbarkeit.
   • Traces: Der genaue Pfad eines Gesprächs Schritt für Schritt, einschließlich der detaillierten 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 Agent Gateway finden Sie unter Agent 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: Persistenter Unterhaltungsverlauf und Tracking aktiver Interaktionen mit dem Agenten.
   • Playground: Eine direkte Chat-Benutzeroberfläche zum Testen des Verhaltens des Agenten.
   • Erinnerungen: 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 AGENT_NAME durch den Namen Ihres Agents, z. B. my-custom-agent.

Agent-Metadaten und ‑Endpunkte aktualisieren

Wenn sich die Laufzeit-URL Ihres Agents ändert oder Sie den Anzeigenamen, die Beschreibung oder die Spezifikation überschreiben möchten, können Sie die Agent-Metadaten aktualisieren.

Für die Agent Registry API werden Agent-Ressourcen für die Ermittlung verwendet. Daher müssen Sie die registrierte Service-Ressource direkt aktualisieren.

Verwenden Sie die Google Cloud CLI mit bestimmten Flags, um die Parameter des Agents zu ändern:

• Anzeigenamen und Beschreibung aktualisieren: Verwenden Sie die Flags --display-name und --description, z. B.:

  gcloud alpha agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="New display name" \
    --description="Updated description of the agent's purpose."
  

  Ersetzen Sie Folgendes:

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

• Endpunkt-URL aktualisieren: Verwenden Sie das Flag --interfaces, um den neuen Endpunkt anzugeben, z. B.:

  gcloud alpha agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
  

  Ersetzen Sie Folgendes:

  • ENDPOINT_URL: Die neue Endpunkt-URL des Agent-Dienstes, z. B. https://new-api.example.com/agent.
  • PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC und JSONRPC.

• Spezifikation des Agenten aktualisieren: Verwenden Sie das Flag --agent-spec-content, z. B. wenn Sie eine neue Agentenkarte haben:

  gcloud alpha agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --agent-spec-content=@AGENT_SPEC
  

  Hinweis :Die von Ihnen hochgeladene Agentspezifikationsdatei darf nicht größer als 10 KB sein.

  Ersetzen Sie AGENT_SPEC durch den Namen der neuen Agentspezifikation, z. B. new-agent-card.json.

Agent entfernen

Wenn Sie Agents löschen möchten, die automatisch in der Agent Registry registriert wurden, müssen Sie den zugrunde liegenden Agent in der entsprechenden Google Cloud Laufzeit löschen. Der Agent wird dann automatisch aus der Registry entfernt.

Wenn Sie einen manuell registrierten Agent aus der Registry entfernen möchten, müssen Sie die zugrunde liegende Service-Ressource löschen. Durch diese Aktion wird der KI-Agent aus den Suchergebnissen entfernt und ist für andere Tools nicht mehr auffindbar:

gcloud alpha agent-registry services delete AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Ersetzen Sie Folgendes:

• AGENT_NAME: Der Name des KI-Agents, den Sie entfernen möchten, z. B. my-support-agent.
• PROJECT_ID: die Projekt-ID
• REGION: Die Registry-Region.

Nächste Schritte

• Informationen zum Anzeigen von Agentbeziehungen in einem Topologiediagramm
• Informationen zum Suchen nach Agents und Tools mit Abfragen in natürlicher Sprache