Benutzerdefinierten ADK-Agenten registrieren

Vorschau

Dieses Produkt oder Feature unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie einen benutzerdefinierten Agenten mit dem Agent Development Kit (ADK) erstellen und auf Ihrer eigenen Infrastruktur hosten, können Sie ihn in der Agent Registry auffindbar machen, indem Sie eine Agent Card bereitstellen und den Endpunkt manuell registrieren.

In diesem Dokument wird erläutert, wie Sie dafür sorgen, dass Ihr ADK-Agent dem Agent2Agent-Protokoll (A2A) entspricht, damit die Registrierung seine Skills indexieren kann.

Der Endpunkt „Agentenkarte“

Damit die Agent Registry die Funktionen Ihres benutzerdefinierten Agenten erkennen kann, muss der Agent seine Metadaten und verfügbaren Skills über das Agent2Agent-Protokoll (A2A) bereitstellen.

Gemäß der A2A-Spezifikation müssen Agenten an einem bestimmten Endpunkt, in der Regel /.well-known/agent-card.json, eine Agentenkarte bereitstellen. Das ist ein JSON-Dokument, in dem die Identität und die Tools des Agenten beschrieben werden.

Wenn Sie die spezifischen A2A-Server-Plug-ins oder -Module des ADK zum Registrieren Ihres Agents verwenden, kann das Framework diese Agent-Karte automatisch basierend auf der Agent-Definition und tools generieren und bereitstellen, die Sie in Ihrem Code angeben.

Offengelegten Agent registrieren

Nachdem Sie den ADK-Agenten in Ihrer Hostingumgebung bereitgestellt haben und die REST-Endpunkte erfolgreich bereitgestellt wurden, weisen Sie die Agent Registry an, den Agenten zu erkennen.

Da für benutzerdefinierte Bereitstellungen eine manuelle Registrierung erforderlich ist, erstellen Sie eine Service-Ressource in der Registrierung. Speichern Sie die generierte Agent Card Ihres Agents als lokale JSON-Datei, z. B. agent-card.json.

Registrieren Sie den Agent mit der Google Cloud CLI. Achten Sie darauf, den Spezifikationstyp a2a-agent-card anzugeben, und laden Sie Ihre lokale Datei mit dem Flag --agent-spec-content hoch:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=agent-card.json

Hinweis :Die von Ihnen hochgeladene Agentspezifikationsdatei darf nicht größer als 10 KB sein.

Ersetzen Sie Folgendes:

• AGENT_NAME: Der Name, den Sie Ihrem Agenten geben möchten, z. B. my-custom-agent.
• PROJECT_ID: die Projekt-ID
• LOCATION: Der Registrierungsort oder die Registrierungsregion.
• DISPLAY_NAME: Der für Menschen lesbare Name Ihres Agenten.

Nachdem die Service-Ressource erstellt wurde, parst die Agent Registry die Agent Card, erstellt eine auffindbare Agent-Ressource und indexiert die in Ihrem ADK-Python-Code definierten Skills, damit andere Entwickler danach suchen können.