Enumerar agentes disponibles

Recupere la lista de equipos de agentes Select AI expuestos como agentes A2A para un usuario de base de datos específico, incluidas las URL y descripciones de la tarjeta de agente.

  1. Envíe una solicitud GET al punto final de agentes de A2A.

    Punto final

    GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/
  2. Incluya las cabeceras de solicitud necesarias.

    Cabeceras

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

    Sustituya los marcadores de posición por sus valores específicos.

    • region-identifier: identificador de región de Oracle Cloud.

    • database-ocid: OCID de la base de datos de IA autónoma.

    • token: pegue el valor access_token del token Bearer para el usuario de base de datos cuyos equipos de agentes de AI seleccionados se muestran. Consulte Generar token de portador para obtener más información.

  3. Revise la respuesta devuelta por el servidor A2A.

    Formato de Respuesta

    [
    {
    "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}"
    }
    ]

    Los valores de la respuesta los genera el servidor A2A en función de los equipos de agentes definidos en la base de datos. No es necesario modificar ni sustituir estos valores.

    • agent_card_url: URL para recuperar la tarjeta de agente para el equipo de agente.

    • name: nombre del equipo de agente de Select AI.

    • description: descripción del equipo de agente de Select AI.

    La respuesta devuelve nombres de agente, descripciones y URL de tarjeta de agente, que los clientes utilizan para detectar e interactuar con los agentes disponibles.

Ejemplo

Utilice el siguiente ejemplo para mostrar los agentes disponibles:

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