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.

  1. 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
  2. Schließen Sie die erforderlichen Anforderungsheader ein.

    Kopfdaten

    Authorization: Bearer <token>
    Content-Type: application/json
    Accept: application/json

    Ersetzen 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-Datenbank OCID.

    • agent-team-name: Wählen Sie den Namen des AI-Agentteams aus der Datenbank aus.

  3. 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>'