Für Agenten, die außerhalb vonGoogle Cloudgehostet werden, ist eine manuelle Registrierung in der Agent Registry erforderlich. In diesem Dokument wird beschrieben, wie Sie Agenten manuell in der Agent Registry registrieren.
Hinweis
Richten Sie die Agent Registry ein, bevor Sie beginnen. Für diese Aufgaben benötigen Sie die Projekt-ID.
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 manuellen Registrieren 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.
A2A-konformen Agenten registrieren
Wenn Ihr Remote-Agent die Agent2Agent-Spezifikation (A2A) implementiert, leiten Sie die Agent Registry an die agent-card.json-Nutzlast des Agents weiter. Die Registrierung synchronisiert automatisch die Agentenkarte und indexiert die verfügbaren Skills des Agenten für die Erkennung.
So registrieren Sie den Agent:
Console
Rufen Sie in der Google Cloud Console die 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 Agents aus.
Klicken Sie auf Agent hinzufügen.
Geben Sie im Bereich Agent details (Agent-Details) einen Anzeigenamen und eine Beschreibung ein und wählen Sie die geografische Region aus.
Wählen Sie als Agenttyp A2A aus.
Wählen Sie im Bereich „Agentspezifikation“ den Tab JSON einfügen aus und fügen Sie den gesamten Inhalt Ihrer
agent-card.json-Datei ein.Klicken Sie auf Speichern.
gcloud
Wenn Sie einen A2A-Agenten registrieren möchten, speichern Sie die Agentenkarte des Agenten als lokale JSON-Datei, z. B. agent-card.json, und gehen Sie so vor:
gcloud alpha agent-registry services create AGENT_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--agent-spec-type=a2a-agent-card \
--agent-spec-content=@agent-card.json
Ersetzen Sie Folgendes:
AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B.my-support-agent.PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.DISPLAY_NAME: Der für Menschen lesbare Name, den Sie Ihrem Agenten geben möchten, z. B.Support Agent.
Standard-REST-Agent registrieren
Standard-REST-Agents sind anhand von Name und Beschreibung auffindbar, haben aber keine durchsuchbaren Skills, sofern sie nicht das A2A-Protokoll verwenden.
Wenn Sie einen Remote-Agent registrieren möchten, der die A2A-Spezifikation nicht implementiert, z. B. einen standardmäßigen REST- oder SaaS-API-Endpunkt, wird mit der Agent Registry API eine Service-Ressource ohne Agent-Protokollspezifikation erstellt.
So registrieren Sie den Agent:
Console
Rufen Sie in der Google Cloud Console die 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 Agents aus.
Klicken Sie auf Agent hinzufügen.
Geben Sie im Bereich Agent details (Agent-Details) einen Anzeigenamen und eine Beschreibung ein und wählen Sie die geografische Region aus.
Wählen Sie für den Agenttyp die Option aus, die keine Spezifikation angibt, z. B. Non-A2A.
Geben Sie den Endpunkt ein, auf dem der Agent gehostet wird, und wählen Sie bei Bedarf die Protokollbindung aus, z. B.
HTTP_JSON.Klicken Sie auf Speichern.
gcloud
Optional können Sie die definierte HTTP/JSON-Endpunktschnittstelle mit dem Flag --interfaces angeben, damit die Registry eine Verbindung zum Agent herstellt.
So registrieren Sie einen Standard-REST-Agenten:
gcloud alpha agent-registry services create AGENT_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--agent-spec-type=no-spec \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Ersetzen Sie Folgendes:
AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B.my-remote-rest-agent.PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.DISPLAY_NAME: Der für Menschen lesbare Name, den Sie Ihrem Agenten geben möchten, z. B.Remote REST Agent.ENDPOINT_URL: Die Endpunkt-URL des Agent-Dienstes, z. B.https://api.remote-service.com/v1/agents/1234.PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sindHTTP_JSON,GRPCundJSONRPC.
Registrierung bestätigen
Prüfen Sie nach der Registrierung Ihres Agents, ob die Agent Registry die Service erfolgreich verarbeitet und die entsprechende Agent-Ressource erstellt hat:
Console
Rufen Sie in der Google Cloud Console die 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 Agents aus.
Auf der Seite muss eine Liste aller registrierten Agenten und ihrer Details angezeigt werden.
gcloud
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION
Wenn Sie mehrere Agents haben oder die Registrierung eines einzelnen Agents bestätigen möchten, können Sie die Liste nach den Metadaten des Agents filtern:
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: 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 SiedisplayName='DISPLAY_NAME'verwenden. Wenn Sie nach der global eindeutigen Kennung (URN) filtern möchten, können SieagentId='urn:agent:AGENT_URN'verwenden.