Kurzanleitung: Agent registrieren

Durch die Registrierung eines Agenten wird er von einer isolierten Arbeitslast zu einer auffindbaren Komponente 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, was die KI Entwicklung beschleunigt.

In dieser Kurzanleitung erfahren Sie, wie Sie einen Mock-Agenten manuell in Agent Registry mit der 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.

Führen Sie die folgenden Schritte aus, um den Agenten zu registrieren:

  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