Kurzanleitung: Agent registrieren

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

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

Hinweis

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

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 Registrieren von 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-Agenten registrieren

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

So registrieren Sie den Agenten:

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

    Zu Agent Registry

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

  4. Klicken Sie auf Agent hinzufügen.

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

    • Display name (Anzeigename): Mock Travel Agent
    • Description (Beschreibung): A mock agent that plans travel itineraries.
    • Location (Standort): Wählen Sie global aus.
    • Agent type (Agententyp): Wählen Sie A2A aus.

  6. Wählen Sie im Abschnitt Agent specification (Agentenspezifikation) den Tab Paste JSON (JSON einfügen) aus.

  7. Kopieren Sie den folgenden Beispielinhalt der Agentenkarte 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 bestätigen Sie, dass Ihr Mock-Agent erfolgreich registriert wurde:

  1. Suchen Sie auf dem Tab Agenten in der Liste nach Mock Travel Agent.
  2. Klicken Sie auf Mock Travel Agent , 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 Agenten:

  1. Suchen Sie auf dem Tab Agenten in der Liste nach Mock Travel Agent.
  2. Klicken Sie neben Mock Travel Agent auf das Weitere Optionen -Menü und wählen Sie Löschen aus.
  3. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

Nächste Schritte

  • Informationen zum Verwalten registrierter Agenten .
  • Informationen zu automatischer Registrierung, der empfohlenen Methode zum Registrieren von Agenten, die in verwalteten Laufzeiten bereitgestellt werden
  • Wichtige Konzepte von Agent Registry