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 Fähigkeiten indexieren kann.
Der Endpunkt für die 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 auf Grundlage der Agent-Definition und tools, die Sie in Ihrem Code angeben, generieren und bereitstellen.
Offengelegten Agenten registrieren
Nachdem Sie den ADK-Agenten in Ihrer Hostingumgebung bereitgestellt haben und die REST-Endpunkte erfolgreich bereitgestellt wurden, weisen Sie die Agent Registry an, ihn 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 Ihre lokale Datei mit dem Flag --agent-spec-content hochzuladen:
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-IDLOCATION: 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.