Kurzanleitung: Agent registrieren

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

In dieser Kurzanleitung wird gezeigt, wie Sie einen Mock-Agenten manuell in der Agent Registry über die Google Cloud Console registrieren. Weitere Informationen zu den Agent-Registrierungsmechanismen in der Agent Registry finden Sie unter Agenten registrieren.

Hinweis

Richten Sie die Agent Registry ein, bevor Sie beginnen. Für diese Aufgaben benötigen Sie die 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 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.

Mock-Agent registrieren

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

So registrieren Sie den Agent:

  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 global (Global) aus.

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

  7. Kopieren Sie den folgenden Beispielinhalt für die Agent-Karte und fügen Sie ihn ein:

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Klicken Sie auf Speichern.

Agent Registry verarbeitet die Agentenkarte und registriert den Agenten.

Registrierung bestätigen

So prüfen Sie, ob Ihr Mock-Agent erfolgreich registriert wurde:

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

Bereinigen

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

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

Nächste Schritte