Ir al contenido

Consulta con IA

POST/api/ai/cashbox

Recibe una pregunta, arma un contexto con datos de Caja y se lo envía al modelo de IA configurado. Devuelve el texto de la respuesta. El contexto incluye cajas y sus últimas aperturas, tipos de comisión, aperturas, usuarios, bancos, cuentas con sus saldos, las últimas conciliaciones, los últimos 100 movimientos vigentes y el total de ingresos y egresos. El proveedor y el modelo se resuelven por config/ai.php.

questionstringobligatorio

Pregunta en texto libre. Si falta o no es texto, responde 422.

La ruta lleva el límite de tasa throttle:ai: 15 solicitudes por minuto por usuario; al pasarlo responde 429. El controlador llama a Gate::authorize('viewAny', CashboxMovement::class), pero CashboxMovementPolicy::viewAny devuelve siempre true, de modo que en la práctica cualquier usuario autenticado puede consultar.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/ai/cashbox" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"question": "¿Cuántas cuentas tienen movimientos sin conciliar?"}'
Respuesta del modelo200
{
"message": "Hay 3 cuentas con movimientos sin conciliar: ..."
}
El modelo no respondió200
{
"message": "No hay respuesta"
}
Datos no válidos422
{
"message": "The question field is required.",
"errors": {
"question": ["The question field is required."]
}
}
Límite excedido429
{
"message": "Too Many Attempts."
}