Verfügbare Agents auflisten

Rufen Sie die Liste der Select AI-Agent-Teams ab, die als A2A-Agents für einen bestimmten Datenbankbenutzer angezeigt werden, einschließlich der zugehörigen Agent-Karten-URLs und Beschreibungen.

  1. Senden Sie eine GET-Anforderung an den A2A-Agent-Endpunkt.

    Endpunkt

    GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/
  2. Schließen Sie die erforderlichen Anforderungsheader ein.

    Kopfdaten

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

    Ersetzen Sie die Platzhalter durch Ihre spezifischen Werte.

    • region-identifier: Oracle Cloud-Regions-ID.

    • database-ocid: OCID der autonomen KI-Datenbank.

    • token: Fügen Sie den Wert access_token aus dem Bearer-Token für den Datenbankbenutzer ein, dessen Select AI-Agent-Teams aufgelistet sind. Weitere Informationen finden Sie unter Bearertoken generieren.

  3. Prüfen Sie die vom A2A-Server zurückgegebene Antwort.

    Antwortformat

    [
    {
    "agent_card_url": "https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json",
    "name": "{agent-team-name}",
    "description": "{agent-team-description}"
    }
    ]

    Die Werte in der Antwort werden vom A2A-Server basierend auf den Agent-Teams generiert, die in Ihrer Datenbank definiert sind. Sie müssen diese Werte nicht ändern oder ersetzen.

    • agent_card_url: URL zum Abrufen der Agent-Karte für das Agent-Team.

    • name: Name des Select AI-Agent-Teams.

    • description: Beschreibung des Select AI-Agent-Teams.

    Die Antwort gibt Agent-Namen, Beschreibungen und Agent-Karten-URLs zurück, mit denen Clients die verfügbaren Agents ermitteln und mit ihnen interagieren.

Beispiel

Verwenden Sie das folgende Beispiel, um verfügbare Agents aufzulisten:

curl -X GET 'https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>'