Skip to main content
POST
Ejecutar agente
Envía un mensaje a un agente personalizado y recibe su respuesta. Antes de empezar, necesitas:
  • Una API key.
  • El agentId, disponible en la URL del agente dentro de la plataforma.

Enviar un mensaje

Llama a POST /agents/{agentId}/execute con exactamente un mensaje de rol user. Sustituye {agentId}, TU_API_KEY y <mensaje>:

Ver la ejecución en LLM Traces

El ejemplo anterior usa mi-sesion-123 como identificador de la ejecución.
  1. Envía un valor único en x-agent-session-id.
  2. Espera la respuesta del agente.
  3. En la misma cuenta, abre /pas/llm-traces/mi-sesion-123.
La ruta usa el valor exacto de x-agent-session-id. No uses el ID de la solicitud ni el ID de un registro individual.
El header es opcional, pero recomendado. Si lo omites, execute no devuelve el identificador generado y no podrás abrir la traza directamente. Los registros pueden tardar unos segundos en aparecer.
Vista ilustrativa de LLM Traces con métricas y registros de una ejecución

La vista LLM Traces muestra llamadas al modelo, herramientas, tiempos y consumo de tokens.

Respuesta

Configura un timeout generoso: la ejecución puede tardar varios segundos.

handoff

Ejemplo sin handoff

Ejemplo con handoff

Errores frecuentes

Authorizations

x-ib-api-key
string
header
required

Headers

x-agent-session-id
string

Identificador único de la ejecución. Usa el mismo valor en /pas/llm-traces/{sessionId} para consultar sus trazas.

Example:

"mi-sesion-123"

Path Parameters

agentId
string
required

Identificador del agente. Solicítalo con tu ejecutivo de cuenta.

Body

application/json
history
object[]
required

Lista con exactamente un mensaje del usuario. Cada solicitud es independiente; no envíes historial de varios turnos.

Required array length: 1 element

Response

Respuesta del agente. Usa solo response y, si existe, handoff.

response
string
required

Respuesta textual del agente para el usuario final.

handoff
object

Presente solo cuando el agente decide transferir la conversación a un agente humano.