Manuelle Registrierung verwenden

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 Agenten, die außerhalb vonGoogle Cloud gehostet werden oder auf nicht unterstützten Runtimes ausgeführt 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 Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre gcloud 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 Agentenregistrierung direkt an die agent-card.json-Nutzlast des Agenten weiter. Die Registrierung synchronisiert automatisch die Agentenkarte und indexiert die verfügbaren Skills des Agenten für die Suche.

So registrieren Sie den Agent:

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.

4. Klicken Sie auf Agent hinzufügen.

5. Geben Sie im Bereich Agent details (Agentendetails) die folgenden Details ein:

   • Typ: Wählen Sie A2A aus.
   • Region: Wählen Sie den geografischen Standort aus, an dem Sie den Agent registrieren möchten.

6. Wählen Sie eine der folgenden Optionen aus:

   • Wenn Sie den Agenten über seinen Ressourcen-URI registrieren möchten, wählen Sie den Tab Über URI aus und geben Sie eine gültige URL in das Feld URI ein. Klicken Sie dann auf Importieren, um die Agentenkarte über die URL abzurufen.
   • Wenn Sie den Inhalt der Agentenkarte kopieren und einfügen möchten, wählen Sie den Tab JSON einfügen aus und fügen Sie den gesamten Inhalt Ihrer agent-card.json-Datei ein.

7. 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

Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.

Ersetzen Sie Folgendes:

• AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B. my-support-agent.
• PROJECT_ID: die Projekt-ID
• REGION: Die Region, in der Sie den Agenten registrieren möchten. Wenn Sie keine bestimmte Region verwenden möchten, verwenden Sie den Wert global.
• 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, erstellt die Agent Registry API eine Service-Ressource ohne Agent-Protokollspezifikation.

So registrieren Sie den Agent:

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.

4. Klicken Sie auf Agent hinzufügen.

5. Geben Sie im Bereich Agent details (Agentendetails) die folgenden Details ein:

   • Typ: Wählen Sie Nicht-A2A aus.
   • Name: Geben Sie einen für Menschen lesbaren Anzeigenamen für Ihren Agent ein, z. B. Travel Agent.
   • Beschreibung: Geben Sie eine Beschreibung der Funktionen des Agents ein, z. B. A test agent that plans travel itineraries..
   • Region: Wählen Sie den geografischen Standort aus, an dem Sie den Agent registrieren möchten.
   • Endpunkt: Geben Sie den Endpunkt ein, auf dem der Agent gehostet wird.

6. 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-ID
• REGION: 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 API-Endpunkt-URL des Agents, z. B. https://api.remote-service.com/v1/agents/1234.
• PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC und JSONRPC.

Registrierung bestätigen

Prüfen Sie nach der Registrierung Ihres Agents, ob die Agent Registry Service erfolgreich verarbeitet und die entsprechende Agent-Ressource erstellt hat:

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 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-ID
• REGION: Die Region, in der Sie den Agenten registrieren möchten. Wenn Sie keine bestimmte Region verwenden möchten, verwenden Sie den Wert global.
• FILTER_EXPRESSION: Der Filterausdruck für die Agents, 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.

Nächste Schritte

• Registrierte Vertreter verwalten
• Weitere Informationen zur automatischen Registrierung, der empfohlenen Methode zum Registrieren von Agents, die in verwalteten Runtimes bereitgestellt werden.