Inferencia de Agente
POST/v1/agents/:agentId/inference
Ejecuta inferencia usando un agente específico sin autenticación de usuario.
Este es un endpoint público que permite interacción directa con agentes de IA usando sus tokens de acceso.
Uso:
- Primer mensaje: Envía sin
sessionId - Mensajes subsiguientes: Incluye el
sessionIddevuelto de la primera respuesta
Ejemplo cURL:
curl --location --request POST 'https://api.ko-ia.com/v1/agents/:agentId/inference' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TU_TOKEN_DEL_AGENTE' \
--data '{
"message": "¡Hola! ¿Cómo puedes ayudarme hoy?"
}'
Ejemplo con sesión:
curl --location --request POST 'https://api.ko-ia.com/v1/agents/:agentId/inference' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TU_TOKEN_DEL_AGENTE' \
--data '{
"sessionId": "session_abc123def456",
"message": "Continúa nuestra conversación anterior"
}'
Solicitud
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Respuesta de inferencia exitosa
Error de validación - Formato de solicitud inválido o campos requeridos faltantes
Error de autenticación - Token de autorización inválido o faltante
Error de autorización - El usuario no está autorizado para acceder a este recurso
Agente no encontrado - El ID del agente especificado no existe o está inactivo
Límite de velocidad excedido
Error interno del servidor