Skip to main content
POST
Ejecutar agente
Invoca un agente de IA con un mensaje y obtiene su respuesta. Si el agente decide transferir a un humano, la respuesta incluye un objeto handoff.

Endpoint

Parámetro de ruta

Body

Elemento de history

Envía un solo mensaje por solicitud. No uses historial de varios turnos ni roles distintos de user.

Ejemplo de solicitud

Respuesta

Usa solo estos campos:
La respuesta puede incluir campos adicionales. Ignóralos e integra únicamente response y, si existe, handoff.
La ejecución puede tardar varios segundos. Configura un timeout generoso en tu cliente HTTP.

handoff

Ejemplo sin handoff

Ejemplo con handoff

Errores frecuentes

Los errores de autenticación usan message. Los de validación o recurso usan error.

Ejemplos de error

Authorizations

x-ib-api-key
string
header
required

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.