Claix Retrieve · Rutas
Rutas: decide exactamente qué pueden recuperar tus agentes
Una ruta es un conjunto de tablas y columnas que un agente puede usar, más una guía breve, escrita en lenguaje claro, con tus reglas. Creas la ruta una vez, la asignas a un agente y el agente solo puede responder con lo que incluye la ruta.
Sin SQL y sin archivos de configuración. Marcas lo permitido, escribes la guía y Claix se queda dentro de ese límite—siempre.
Definición
¿Qué es una ruta?
Una ruta describe una forma en que tus agentes pueden recuperar información de tu base de datos. Toda ruta tiene tres partes.
- Un nombre y una descripción. Para qué sirve la ruta, en una o dos frases.
- Tablas y columnas. Eliges las tablas de tu Data Map y, en cada tabla, solo las columnas que la ruta puede usar. Las que no marques no forman parte de la ruta.
- Una guía. Un texto breve con explicaciones y reglas de uso, como un pequeño manual: qué significa el dato, qué son los códigos y cómo debe usarse.
En ejecución
Qué hace una ruta cuando tu agente pregunta
La ruta es el límite. La pregunta puede pedir cualquier cosa, pero la consulta solo puede usar lo que contiene la ruta.
- 01
Tu agente pregunta en lenguaje natural
Por ejemplo: ¿Este cliente ha aceptado el consentimiento de marketing?
- 02
Claix elige la ruta que encaja
Entre las rutas asignadas a ese agente. Si ninguna encaja, Claix no improvisa y la pregunta no se responde con tus datos.
- 03
Una consulta de solo lectura
Claix escribe un único SELECT usando solo las tablas y columnas de esa ruta.
- 04
Vuelve una respuesta tipada
Verdadero o falso, un número, un texto, una lista o un objeto—listo para tu app o flujo.
Por qué rutas
Por qué usar rutas
Control a nivel de tabla y columna
Decides qué puede ver cada ruta, columna a columna.
Una ruta por propósito
Directorio de personal, reservas, pedidos, consentimientos. Cada una con sus tablas, columnas y guía.
Reglas en lenguaje claro
La guía es texto que puedes leer y cambiar, sin aprender un framework ni un formato de configuración.
Los agentes solo usan lo que les asignas
Un agente solo puede usar las rutas asociadas a él.
Solo lectura
Una ruta sirve para leer. Nunca cambia tus datos.
Prueba antes de conectar
Prueba tus rutas con preguntas reales en el Sandbox y revisa las peticiones en Traces.
Configuración
Cómo crear una ruta
- 01
Conecta tu base de datos y publica tu Data Map
Las rutas usan las tablas y relaciones descritas ahí.
- 02
Crea la ruta
Una ventana solo pide un nombre y una descripción.
- 03
Elige las tablas
Ves la lista de tablas, cada una con un checkbox.
- 04
Elige las columnas
Haz clic en el nombre de una tabla para ver sus columnas y marca solo las que la ruta puede usar. Un resumen muestra, en tiempo real, tablas y columnas incluidas.
- 05
Escribe la guía
Explica para qué sirve la ruta, qué significan los códigos y cualquier regla de uso.
- 06
Asigna la ruta a un agente
El prompt de negocio del agente dice cuándo usar cada ruta.
Límites
Qué puede ocurrir dentro de una ruta
Dentro de las tablas y columnas de una ruta, Claix puede:
Permitido
Filtros, joins entre las tablas de la ruta, agrupación y ordenación. Conteos, sumas, medias, mínimos y máximos. Texto, fechas, números y window functions. Listas y valores JSON.
Nunca permitido
Nada que no sea un SELECT de solo lectura: sin inserts, updates, deletes ni cambios de esquema. Más de una sentencia. Tablas o columnas fuera de la ruta. SELECT *. Funciones fuera de la lista que Claix permite.
- Si una consulta rompe estas reglas, se rechaza y Claix vuelve a intentarlo con una consulta corregida.
Guía
Cómo escribir una buena guía
La guía ayuda al agente a entender tus datos. Lo que el agente puede alcanzar de verdad lo deciden las tablas y columnas que marcas.
Conviene incluir: para qué sirve la ruta (y para qué no), qué significa cada código o estado, cualquier regla de lectura y cómo llama tu negocio a las cosas si los nombres de columna son distintos.
Esta ruta responde preguntas sobre reservas de restaurante. El estado C significa confirmada, P pendiente y X cancelada. Las reservas canceladas siguen en la tabla. Los depósitos están en euros.
Roles
Rutas y agentes
Rutas y agentes tienen trabajos distintos. Un agente se asocia a una o más rutas, y su prompt de negocio dice cuándo usar cada una. Un agente de soporte y un asistente interno pueden trabajar sobre la misma base y ver datos distintos, porque cada uno tiene rutas distintas.
| Ruta | Agente |
|---|---|
| Decide qué datos se pueden usar y cómo leerlos | Decide quién pregunta y qué rutas puede usar |
| Contiene nombre, descripción, tablas, columnas y una guía | Contiene nombre, descripción, prompt de negocio, rutas y modo de respuesta |
Ejemplos
Cómo podrías montar rutas
Son ejemplos de configuración. No son historias de clientes.
Directorio de personal
Una ruta con la tabla employees y las columnas name y job title. Pregunta: ¿Cuál es el puesto de Marta? Si la columna phone no está marcada, una pregunta sobre el teléfono no se responde con tus datos.
Consentimiento de marketing
Una ruta con la tabla customers y dos columnas: name y marketing consent. Pregunta: ¿El cliente Javier Pérez ha aceptado el consentimiento de marketing? Respuesta: true o false, lista para un workflow.
Reservas de restaurante
Una ruta con reservations y tables, con date, party size, table y deposit. Pregunta: ¿Cuál es la próxima reserva de Javier Pérez? Respuesta: un objeto con fecha, comensales, mesa y depósito.
Estado de pedidos
Una ruta con orders y customers, y las columnas status y total. Pregunta: ¿Cuántos pedidos se han enviado este mes? Respuesta: un número.
Importante
Conviene saber
- Las rutas limitan lo que un agente puede usar, y el rol de la base limita lo que Claix puede leer. Usa ambos. Conecta Claix con un rol de solo lectura que vea solo lo que quieres compartir.
- El acceso es por agente, no por usuario final. Un agente puede leer todo lo que incluyen sus rutas, para quien le pregunte.
- Si el dato no está en la ruta, la respuesta queda vacía. Claix no inventa un valor para rellenar el hueco.
- Una ruta no es un dashboard. Le dice a un agente qué puede recuperar.
Preguntas frecuentes
- ¿Qué es una ruta en Claix?
- Un conjunto de tablas y columnas que un agente puede usar, con una guía breve de reglas, que Claix usa para responder preguntas desde tu base de datos.
- ¿Necesito escribir SQL?
- No. Eliges tablas y columnas y escribes la guía. Claix escribe la consulta de solo lectura.
- ¿Una ruta puede usar más de una tabla?
- Sí. Una ruta puede incluir varias tablas, y las consultas pueden unirlas si todas pertenecen a la ruta.
- ¿Una ruta puede cambiar mis datos?
- No. Las rutas solo se usan para leer datos.
- ¿Qué pasa si una pregunta necesita datos que no están en la ruta?
- Claix no la responde con tus datos. Si ninguna ruta encaja, no se ejecuta ninguna consulta para esa pregunta.
- ¿Cómo pruebo una ruta?
- Usa el Sandbox para hacer preguntas reales y revisa las peticiones en Traces.
Crea tu primera ruta
Conecta tu base de datos, revisa tu Data Map y decide qué pueden recuperar tus agentes. Una ruta por propósito. Límites claros. Respuestas tipadas.