libSQL

libSQL guarda datos en una tabla de tu base libSQL o Turso, la consulta con SQL y, si conectas un componente de embeddings, permite buscar por significado en sus textos.

Hay dos componentes con el nombre libSQL. Este sirve para guardar y buscar. El otro libSQL trabaja fila a fila: inserta, lee, actualiza y borra.

Cuándo usarlo

• Guardar en Turso los textos que procesa un flujo para buscarlos después.
• Dar a un agente un buscador sobre tus documentos guardados en libSQL.
• Consultar tu base con SQL desde un flujo.

Configuración

Si conectas datos a Ingest Data, se guardan en la tabla, que se crea si no existe. Si escribes una consulta en Search Query, se ejecuta y devuelve su resultado. La salida Retriever ofrece la tabla como buscador por significado.

Necesitas una credencial libSQL / Turso con la dirección y el token de tu base. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial libSQL / Turso.
Operation	Add (por defecto), SQL, Retriever o DatabaseInfo.
Table Name	La tabla. Por defecto, nappai.
Search Query	La consulta SQL que se ejecuta.
Ingest Data	Los datos que se guardan.
Embedding	Conector para un componente de embeddings. Si los datos tienen un campo text, se guarda también su representación para buscar por significado.

Opciones avanzadas

Campo	Qué hace
Drop Table	Borra la tabla, si existe, antes de guardar. Desactivado por defecto.
Number Of Results	Cuántos resultados devuelve el buscador. Por defecto, 10.
Search Score Threshold	Si es distinto de 0, el buscador descarta los resultados poco parecidos.

Búsqueda por significado

La columna donde se guarda la representación de los textos tiene un tamaño fijo de 1536 valores. Usa un componente de embeddings que genere ese tamaño, como OpenAI Embeddings con su modelo por defecto.

Resultado

Data trae los datos guardados o el resultado de la consulta. Retriever es el buscador por significado. Database Info y Database Schema describen la base y la tabla.

Ejemplo

Un equipo de soporte guarda en Turso las respuestas que ya ha dado.

1. Conecta las respuestas a Ingest Data de libSQL, con la tabla respuestas y un componente de embeddings.
2. Ejecuta el flujo.
3. En el asistente, conecta la salida Retriever a un componente que use un buscador.

Componentes relacionados

• libSQL: inserta, lee, actualiza y borra filas.