Kurzanleitung: Agent registrieren

Durch die Registrierung eines KI-Agenten wird er von einer isolierten Komponente zu einem auffindbaren, integrierten Teil Ihres KI-Ökosystems in Agent Registry. Wenn Sie die Fähigkeiten Ihres KI-Agenten veröffentlichen, können andere Entwickler und Orchestrator-KI-Agenten in Ihrer Organisation Ihre Arbeit finden und wiederverwenden, was die KI-Entwicklung insgesamt beschleunigt.

In dieser Kurzanleitung wird gezeigt, wie Sie einen Mock-KI-Agenten manuell in Agent Registry mit der Google Cloud console registrieren. Weitere Informationen zu den Registrierungsmechanismen für KI-Agenten in Agent Registry finden Sie unter KI-Agenten registrieren.

Hinweis

Richten Sie Agent Registry ein, bevor Sie beginnen. Sie benötigen die Projekt-ID um diese Aufgaben auszuführen.

Aktivieren Sie die Agent Registry API:

Console

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen.

API aktivieren

gcloud

Aktivieren Sie die Agent Registry API in Ihrem Projekt:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

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 Registrieren von KI-Agenten in 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.

Mock-KI-Agenten registrieren

Wenn Sie Agent Registry ausprobieren möchten, können Sie einen Mock-KI-Agenten manuell registrieren, indem Sie eine Beispiel-Agentenkarte für Agent-to-Agent (A2A) einfügen.

So registrieren Sie den KI-Agenten:

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

    Zu Agent Registry

    Klicken Sie bei Aufforderung auf Aktivieren, um die Agent Registry API zu aktivieren.

  2. Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie Agent Registry eingerichtet haben.

  3. Wählen Sie den Tab KI-Agenten aus.

  4. Klicken Sie auf Agent hinzufügen.

  5. Geben Sie im Bereich Agentendetails die folgenden Details ein:

    • Typ: Wählen Sie A2A aus.
    • Region: Wählen Sie global (Global) aus.

  6. Wählen Sie den Tab JSON einfügen aus.

  7. Kopieren Sie den folgenden Beispielinhalt der Agentenkarte und fügen Sie ihn ein:

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. Klicken Sie auf Speichern.

Agent Registry verarbeitet die Agentenkarte und registriert den KI-Agenten.

Registrierung bestätigen

So bestätigen Sie, dass Ihr Mock-KI-Agent erfolgreich registriert wurde:

  1. Suchen Sie auf dem Tab KI-Agenten in der Liste nach dem Mock-KI-Agenten.
  2. Klicken Sie auf den Namen des KI-Agenten, um die Details aufzurufen.
  3. Prüfen Sie, ob die Fähigkeiten BookFlight und SearchHotels auf dem Tab Übersicht angezeigt werden.

Bereinigen

Damit keine Mock-Ressourcen in Ihrem Projekt verbleiben, löschen Sie den registrierten KI-Agenten:

  1. Suchen Sie auf dem Tab KI-Agenten in der Liste nach dem Mock-KI-Agenten.
  2. Klicken Sie in der Spalte Aktionen des Mock-KI-Agenten auf das Menü „ Weitere Optionen “ und wählen Sie Löschen aus.
  3. Geben Sie im Bestätigungsdialogfeld LÖSCHEN ein, um die Aktion zu bestätigen.
  4. Klicken Sie auf Löschen.

Nächste Schritte