Kurzanleitung: Agent registrieren

Wenn Sie einen KI-Agenten in Agent Registry registrieren, können Sie eine isolierte Komponente in einen auffindbaren Teil Ihres KI-Ökosystems verwandeln. Wenn Sie die A2A-Fähigkeiten Ihres KI-Agenten veröffentlichen, können andere Entwickler und Orchestrator-Agenten in Ihrer Organisation Ihre Arbeit finden und wiederverwenden.

In dieser Kurzanleitung registrieren Sie einen simulierten Agenten manuell in der Agent Registry über die Google Cloud Console. Weitere Informationen zu den Mechanismen für die Agent-Registrierung in der Agent Registry finden Sie unter Agents registrieren.

Hinweis

  1. Agent Registry einrichten
  2. Rufen Sie die Projekt-ID für das Governance-Projekt ab, in dem die Agent Registry aktiviert ist.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist. So erhalten Sie die Berechtigungen, 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-Agenten registrieren

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

So registrieren Sie den Agenten:

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

    Zur Agent Registry

    Klicken Sie bei entsprechender 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 KI-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. Fügen Sie den folgenden Beispielinhalt für die Agentenkarte 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 Agent Card und registriert den KI-Agenten.

Registrierung bestätigen

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

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

Bereinigen

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

  1. Suchen Sie auf dem Tab Agenten in der Liste nach dem Mock-Agenten.
  2. Klicken Sie in der Spalte Aktionen des Mock-Agenten 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