Agent-Karte abrufen
Rufen Sie die Agent-Karte für ein Select AI-Agent-Team ab.
Die Agent-Karte definiert die Funktionen und Interaktionsdetails des Agent. Sie können die Agent-Karten-URL direkt in einem A2A-Client verwenden, sofern unterstützt, oder sie mit dieser API abrufen und den Client mit den zurückgegebenen Informationen konfigurieren.
Agent-Karten werden automatisch generiert und vom A2A-Server basierend auf den Metadaten der in der Datenbank definierten Select AI-Agent-Teams veröffentlicht. Der A2A-Server erstellt die Agent-Karte als JSON-Dokument und stellt sie über einen Standardendpunkt, .well-known/agent-card.json, für A2A-Client-Discovery und -Interaktion bereit.
In der folgenden Tabelle wird dargestellt, wie Werte für "AI-Agent auswählen" Agent-Kartenfeldern zugeordnet werden.
| Agent-Kartenfeld | AI-Agent-Zuordnung auswählen |
|---|---|
name |
Wird dem Wert team_name zugeordnet, der in DBMS_CLOUD_AI_AGENT.CREATE_TEAM verwendet wird. |
description |
Wird dem description-Wert zugeordnet, der in DBMS_CLOUD_AI_AGENT.CREATE_TEAM verwendet wird. Wenn diese Option nicht festgelegt ist, wird standardmäßig der Wert team_name verwendet. |
skills[].id |
Wird der über DBMS_CLOUD_AI_AGENT.CREATE_TOOL generierten Tool-ID zugeordnet. |
skills[].name |
Wird dem Wert tool_name zugeordnet, der in DBMS_CLOUD_AI_AGENT.CREATE_TOOL verwendet wird. |
skills[].description |
Ordnet das Attribut instruction zu, das in DBMS_CLOUD_AI_AGENT.CREATE_TOOL verwendet wird. |
Beispiel: Wenn der Teamname REPORT_SUMMARY_AGENT_TEAM lautet und die Beschreibung Summarizes uploaded reports and answers follow-up questions lautet, lautet die Agent-Karte name REPORT_SUMMARY_AGENT_TEAM und die Agent-Karte description Summarizes uploaded reports and answers follow-up questions.
Wenn Sie ein Tool mit tool_name als SUMMARIZE_REPORT und instruction als Summarize uploaded reports and answer follow-up questions erstellen, verwendet der Agent-Kartenskilleintrag die generierte Tool-ID für skills[].id, SUMMARIZE_REPORT für skills[].name und Summarize uploaded reports and answer follow-up questions für skills[].description.
Kunden rufen die Agent-Karte ab, um zu verstehen, wie der Agent angerufen wird und welche Funktionen er bietet.
-
Senden Sie eine
GET-Anforderung an den Agentkartenendpunkt.Endpunkt
GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json -
Schließen Sie die erforderlichen Anforderungsheader ein.
Kopfdaten
Authorization: Bearer <token> Content-Type: application/json Accept: application/jsonErsetzen Sie die Platzhalter durch Ihre spezifischen Werte.
-
region-identifier: Oracle Cloud-Regions-ID. -
token: Bearertoken für den Datenbankbenutzer, der Zugriff auf das Select AI-Agent-Team hat. -
database-ocid: A2A-fähige autonome KI-DatenbankOCID. -
agent-team-name: Wählen Sie den Namen des AI-Agentteams aus der Datenbank aus.
-
-
Prüfen Sie die zurückgegebene Agent-Kartenspezifikation.
Antwort
Gibt die Agent-Kartenspezifikation gemäß der Definition im A2A-Protokoll zurück.
Weitere Informationen finden Sie unter AgentCard-Objektstruktur.
Beispiel
Verwenden Sie das folgende Beispiel, um eine Agent-Karte abzurufen:
curl -X GET 'https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>'