Explain SQL results
Explain SQL results toma el resultado de una consulta a una base de datos (una tabla de filas y columnas, o un número) y lo convierte, con un modelo de IA, en una explicación breve y clara que responde a la pregunta que se hizo. Así, quien preguntó recibe una respuesta comprensible en lugar de una tabla.
Suele ir al final de una cadena que empieza con SQL Query Constructor, que escribe la consulta, y sigue con un componente que la ejecuta, como SQL Executor.
Cuándo usarlo
- Responder en un chat a preguntas sobre ventas, pedidos o stock con una frase clara en lugar de una tabla.
- Enviar por correo un resumen comprensible del resultado de una consulta.
- Contestar en el idioma de cada usuario aunque la base de datos esté en otro idioma.
Configuración
| Campo | Qué hace |
|---|---|
| Result from the execution of SQL query (obligatorio) | El resultado de la consulta. Conéctalo desde el componente que la ha ejecutado. |
| User request (obligatorio) | La pregunta original, para que la explicación responda a lo que se preguntó. |
| User Language (obligatorio) | El idioma de la explicación, por ejemplo español o English. |
| Conexión | Qué conectar |
|---|---|
| LLM (obligatorio) | Un componente de modelo de IA, por ejemplo OpenAI. |
Resultado
La salida Explanation results devuelve la explicación como un mensaje de texto. Conéctala a un componente de salida del chat, a un correo o a cualquier componente que reciba texto.
Ejemplo
En el asistente de ventas de Distribuciones Norte, un comercial pregunta: «¿Cuántos pedidos ha hecho Talleres Ruiz este año?». La consulta devuelve una sola fila con el número 14.
Explain SQL results recibe ese resultado en Result from the execution of SQL query, la pregunta en User request y español en User Language, y responde algo como: «Talleres Ruiz ha realizado 14 pedidos en lo que va de año».
Buenas prácticas
- Pasa siempre la pregunta original en User request: sin ella, el modelo no sabe qué parte del resultado es importante.
- Limita el tamaño del resultado desde la consulta (por ejemplo con Top K en SQL Query Constructor): una explicación de cientos de filas pierde claridad.
Componentes relacionados
- SQL Query Constructor: escribe la consulta a partir de la pregunta.
- SQL Executor: ejecuta la consulta.