Benutzerdefinierten ADK-Agenten registrieren

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 Agentenkarte bereitstellen und den Endpunkt manuell registrieren.

In diesem Dokument wird erläutert, wie Sie sicherstellen, dass Ihr ADK-Agent dem Agent2Agent-Protokoll (A2A) entspricht, damit die Registry seine A2A-Fähigkeiten indexieren kann.

Der Endpunkt der Agentenkarte

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

Die A2A-Spezifikation erfordert, dass Agenten an einem bestimmten Endpunkt, in der Regel /.well-known/agent-card.json, eine Agentenkarte bereitstellen. Dabei handelt es sich um 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 verwenden, um Ihren Agenten zu registrieren, kann das Framework diese Agentenkarte automatisch auf Grundlage der Agent-Definition und der tools generieren und bereitstellen, die Sie in Ihrem Code angeben.

Den bereitgestellten Agenten registrieren

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

Da für benutzerdefinierte Bereitstellungen eine manuelle Registrierungerforderlich ist, erstellen Sie eine Service Ressource in der Registry. Speichern Sie die generierte Agentenkarte Ihres Agenten als lokale JSON-Datei, z. B. agent-card.json.

Registrieren Sie den Agenten mit der Google Cloud CLI. Geben Sie dabei den Spezifikationstyp a2a-agent-card an und laden Sie Ihre lokale Datei mit dem Flag --agent-spec-content hoch:

gcloud 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

Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.

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 Registrierungsstandort oder die Registrierungsregion.
  • DISPLAY_NAME: Der für Menschen lesbare Name Ihres Agenten.

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