Für eine effektive Verwaltung Ihrer Agentenflotte muss die Registrierung korrekt sein. Dazu müssen Sie die Agentendetails im Laufe der Entwicklung Ihres KI-Ökosystems aufrufen und aktualisieren, Metadaten überschreiben oder nicht mehr verwendete Agenten entfernen.
In diesem Dokument wird beschrieben, wie Sie die Details und die Konfiguration Ihres registrierten Agenten aufrufen und ändern.
Hinweis
Bevor Sie Agenten verwalten, müssen sie in der Agent Registry registriert sein. Außerdem benötigen Sie Ihre Projekt-ID , um diese Aufgaben auszuführen.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre gcloud CLI-Umgebung eingerichtet haben.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die
Agent Registry API Editor (roles/agentregistry.editor) IAM-Rolle für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die
Sie zum Verwalten registrierter Agenten 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 finden
Nach der Registrierung von Agenten können Sie sie in Ihrer Umgebung finden und ihre detaillierten Konfigurationen aufrufen, z. B. ihre Endpunkte, Fähigkeiten und zugehörigen Metadaten.
Agenten auflisten und ansehen
Sie können alle in Ihrer Umgebung registrierten Agenten auflisten und ihre detaillierten Konfigurationen aufrufen, z. B. ihre Endpunkte, Fähigkeiten und zugehörigen Metadaten:
Console
Rufen Sie in der Google Cloud Console Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen eines Agenten, um alle Details aufzurufen.
gcloud
Verwenden Sie den Befehl agents list, um alle Agenten an einem bestimmten Standort aufzulisten:
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
PROJECT_ID: Die Projekt-IDREGION: Die Region der Registrierung
Registrierte Agenten filtern
Wenn Sie mehrere Agenten haben oder die Registrierung eines bestimmten Agenten bestätigen möchten, können Sie die Liste nach den Metadaten des Agenten filtern:
Console
Rufen Sie in der Google Cloud Console Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Filtern Sie die Liste nach dem Standort des Agenten 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 Agenten 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 Agenten, die Sie filtern möchten. Sie können beispielsweise die folgenden Filter verwenden:
- Verwenden Sie
displayName='DISPLAY_NAME', um nach Anzeigenamen zu filtern. - Verwenden Sie
agentId='urn:agent:AGENT_URN', um nach der global eindeutigen ID (URN) zu suchen.
Details eines Agenten ansehen
Rufen Sie Details eines bestimmten Agenten auf, einschließlich seiner Protokolle, Fähigkeiten und Identität:
Console
Rufen Sie in der Google Cloud Console Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie aufrufen möchten.
Die Detailseite enthält Tabs für die Agentendetails.
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 Agenten angezeigt werden, die auf verwalteten Laufzeiten basieren, wie z. B. Agent Runtime on Gemini Enterprise Agent Platform:
- Übersicht: Wichtige Details des Agenten, 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 Informationen wie Latenz, Traffic, Fehler und Token-Ausgaben. Dieser Tab ist in Google Cloud Observability-Tools eingebunden, um Leistungsmesswerte in Echtzeit und die Auslastung auf Systemebene anzuzeigen. So können Sie Kosten und Nutzerfreundlichkeit verwalten. Weitere Informationen finden Sie in der Übersicht zur Beobachtbarkeit.
- Traces: Der genaue Pfad eines Gesprächsschritts, einschließlich detaillierter Formatierung von Eingabe- und Assistentennachrichten, um komplexe Reasoning-Schleifen mit mehreren Agenten oder Fehler bei der Tool-Aufrufung in Echtzeit zu beheben. Weitere Informationen finden Sie unter Agent-Traces ansehen.
- Sicherheit: Ergebnisse von Model Armor und Security Command Center, einschließlich Verstößen gegen die Inhaltsrichtlinie, Risiken von Datenlecks und Compliance-Bewertungen. Weitere Informationen zur Sicherheit finden Sie unter Sicherheitsergebnisse ansehen.
- Topologie: Eine visuelle Darstellung der Beziehungen und Trafficflüsse zwischen einem Agenten, seinem zugewiesenen Agent Gateway und den MCP Servern, mit denen er interagiert. Weitere Informationen zum Agent Gateway finden Sie in der Übersicht zum Agent Gateway. Weitere Informationen zur Topologie finden Sie unter Diagramme für einen registrierten Agenten ansehen.
- Identität: Das Agenten-Principal 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 Agenten.
- Playground: Eine direkte Chat-Oberfläche zum Testen des Verhaltens des Agenten.
- Memories: Langfristige Personalisierungsfunktionen, die Details aus früheren Unterhaltungen mit dem Agenten generieren oder abrufen, um den Kontext über Interaktionen hinweg zu erhalten.
- Bewertung: Details zu allen Aufgaben zur Agentenbewertung. Auf diesem Tab können Sie neue Bewertungsaufgaben erstellen, Messwerte hochladen und die kognitive Leistung und Modellzuverlässigkeit des Agenten anhand von Live-Traffic oder synthetischen Simulationen bewerten.
gcloud
Verwenden Sie den Befehl agents describe, um die detaillierten Metadaten eines bestimmten Agenten aufzurufen:
gcloud alpha agent-registry agents describe AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie AGENT_NAME durch den Namen Ihres Agenten, z. B. my-custom-agent.
Agentenmetadaten und -endpunkte aktualisieren
Wenn sich die Laufzeit-URL Ihres Agenten ändert oder Sie den Anzeigenamen, die Beschreibung oder die Spezifikation überschreiben möchten, können Sie die Agentenmetadaten aktualisieren.
Für die Agent Registry API werden Agent-Ressourcen für die Suche verwendet. Daher müssen Sie die registrierte Service-Ressource direkt aktualisieren.
Console
Aktualisieren Sie die verfügbaren Agentendetails in der Google Cloud Console:
Rufen Sie in der Google Cloud Console Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie aktualisieren möchten.
Klicken Sie auf dem Tab Übersicht des Agenten auf Bearbeiten.
Geben Sie im Bereich Dienst bearbeiten die aktualisierten Informationen zu Ihrem Agenten ein, z. B. den neuen Namen oder die neue Beschreibung.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie die gcloud CLI mit bestimmten Flags, um die Parameter des Agenten zu ändern:
Anzeigenamen und Beschreibung aktualisieren: Verwenden Sie die
--display-nameund--descriptionFlags, 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 Agenten, z. B.my-support-agent.PROJECT_ID: Die Projekt-IDREGION: Die Region der Registrierung
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=PROTOCOLErsetzen Sie Folgendes:
ENDPOINT_URL: Die neue Endpunkt-URL des Agenten, z. B.https://new-api.example.com/agent.PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sindHTTP_JSON,GRPCoderJSONRPC.
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_SPECErsetzen Sie
AGENT_SPECdurch den Namen der neuen Spezifikationsdatei des Agenten, z. B.new-agent-card.json. Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.
Agent entfernen
Wenn Sie Agenten löschen möchten, die automatisch in der Agent Registry registriert wurden, müssen Sie den zugrunde liegenden Agenten in seiner spezifischen Laufzeit löschen. Google Cloud Der Agent wird dann automatisch aus der Registrierung entfernt.
Wenn Sie einen manuell registrierten Agenten aus der Registrierung entfernen möchten, müssen Sie die zugrunde liegende Service-Ressource löschen. Durch diese Aktion wird der Agent aus den Suchergebnissen entfernt und ist für andere Tools nicht mehr auffindbar:
Console
Rufen Sie in der Google Cloud Console Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie entfernen möchten.
Klicken Sie auf dem Tab Übersicht des Agenten auf Löschen.
Geben Sie im Bestätigungsdialogfeld LÖSCHEN ein, um die Aktion zu bestätigen.
Klicken Sie auf Löschen.
gcloud
gcloud alpha agent-registry services delete AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
AGENT_NAME: Der Name des Agenten, den Sie entfernen möchten, z. B.my-support-agent.PROJECT_ID: Die Projekt-IDREGION: Die Region der Registrierung
Nächste Schritte
- Informationen zum Anzeigen von Agentenbeziehungen mit einem Topologiediagramm
- Informationen zum Suchen nach Agenten und Tools mit Abfragen in natürlicher Sprache