Obtener tarjeta de agente

Recupere la tarjeta de agente para un equipo de agente de Select AI.

La tarjeta de agente define las capacidades y los detalles de interacción del agente. Puede utilizar la URL de la tarjeta de agente directamente en un cliente A2A, si está soportado, o recuperarla mediante esta API y configurar el cliente con la información devuelta.

Las tarjetas de agente las genera y publica automáticamente el servidor A2A en función de los metadatos de los equipos de agentes de Select AI definidos en la base de datos. El servidor A2A construye la tarjeta de agente como documento JSON y la expone a través de un punto final estándar, .well-known/agent-card.json, para la detección e interacción del cliente A2A.

En la siguiente tabla, se muestra cómo se asignan los valores de Seleccionar agente AI a los campos de la tarjeta de agente.

Campo de tarjeta de agente	Seleccionar asignación de agente de IA
`name`	Se asigna al valor `team_name` utilizado en `DBMS_CLOUD_AI_AGENT.CREATE_TEAM`.
`description`	Se asigna al valor `description` utilizado en `DBMS_CLOUD_AI_AGENT.CREATE_TEAM`. Si no se define, el valor por defecto es `team_name`.
`skills[].id`	Se asigna al ID de herramienta generado mediante `DBMS_CLOUD_AI_AGENT.CREATE_TOOL`.
`skills[].name`	Se asigna al valor `tool_name` utilizado en `DBMS_CLOUD_AI_AGENT.CREATE_TOOL`.
`skills[].description`	Se asigna al atributo `instruction` utilizado en `DBMS_CLOUD_AI_AGENT.CREATE_TOOL`.

Por ejemplo, si el nombre del equipo es REPORT_SUMMARY_AGENT_TEAM y la descripción es Summarizes uploaded reports and answers follow-up questions, la tarjeta de agente name es REPORT_SUMMARY_AGENT_TEAM y la tarjeta de agente description es Summarizes uploaded reports and answers follow-up questions.

Si crea una herramienta con tool_name como SUMMARIZE_REPORT y instruction como Summarize uploaded reports and answer follow-up questions, la entrada de aptitud de tarjeta de agente utiliza el ID de herramienta generado para skills[].id, SUMMARIZE_REPORT para skills[].name y Summarize uploaded reports and answer follow-up questions para skills[].description.

Los clientes recuperan la tarjeta de agente para comprender cómo llamar al agente y qué capacidades proporciona.

Envíe una solicitud GET al punto final de la tarjeta de agente.

Punto final

GET https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/databases/{database-ocid}/agents/{agent-team-name}/.well-known/agent-card.json

Incluya las cabeceras de solicitud necesarias.

Cabeceras
```
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json
```
Sustituya los marcadores de posición por sus valores específicos.
- region-identifier: identificador de región de Oracle Cloud.
- token: token de portador para el usuario de base de datos que tiene acceso al equipo de agente de Select AI.
- database-ocid: base de datos de IA autónoma activada para A2A OCID.
- agent-team-name: seleccione el nombre del equipo del agente de AI de la base de datos.
Revise la especificación de la tarjeta de agente devuelta.

Respuesta

Devuelve la especificación de la tarjeta de agente según lo definido por el protocolo A2A.

Consulte Estructura de objetos de AgentCard para obtener más información.

Ejemplo

Utilice el siguiente ejemplo para recuperar una tarjeta de agente:

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

Documentación de Oracle Cloud Infrastructure

Obtener tarjeta de agente