Claix Retrieve · Data Map
Data Map: enseña a tus agentes qué significa tu base de datos
El Data Map es donde Claix aprende tu base de datos. Lista tus tablas, dice para qué sirve cada una y mapea cómo se relacionan entre sí. Un clic genera el borrador por ti, tú lo revisas y corriges, y cada ruta y agente se construye sobre él.
Todo en él es una sugerencia que puedes cambiar. Un primer borrador en un clic, y la última palabra es siempre tuya.
Relacionado
Definición
¿Qué es el Data Map?
El Data Map es una descripción de la parte de tu base de datos con la que trabajarán tus agentes. Tiene tres partes.
- Tablas. Las tablas de tu base. Eliges las que se van a usar.
- Descripciones. Una descripción breve de para qué sirve cada tabla.
- Relaciones. Cómo se relacionan las tablas entre sí. Claix las lee de tus claves foráneas y sugiere otras; puedes editarlas, añadir nuevas o borrar las sugeridas.
Borrador
Un clic, un primer borrador
No escribes el Data Map desde cero.
- 01
Conecta tu base de datos
Claix conoce la estructura de tus tablas a través de la conexión.
- 02
Haz clic para generar
Claix redacta el Data Map por ti.
- 03
Mira el borrador
Aparecen tus tablas, cada una con una descripción sugerida, y las relaciones entre ellas: las de tus claves foráneas y las que sugiere la IA.
- 04
Revísalo
Selecciona las tablas que se usarán, corrige cualquier descripción y edita, añade o elimina relaciones.
- 05
Úsalo
El Data Map queda guardado y visible en tu dashboard.
Por qué importa
Por qué importa el Data Map
Un agente que no entiende tus datos solo puede adivinar. El Data Map le da las dos cosas que necesita—y también te importa a ti.
Qué es cada tabla
Una descripción en lenguaje claro, para que el agente no tenga que adivinar por el nombre de la tabla.
Cómo se conectan las tablas
Las relaciones dicen cómo la información de una tabla enlaza con otra, que es lo que necesita una pregunta entre varias tablas.
Describes tus datos una vez
Cada ruta y cada agente usan las mismas descripciones y relaciones.
La IA ayuda, tú decides
La IA sugiere y tú corriges, para que el mapa diga lo que tú quieres decir.
Es visible
El Data Map se guarda en tu dashboard, donde puedes leerlo y cambiarlo en cualquier momento.
Mejores preguntas, joins más seguros
Un buen Data Map hace posibles mejores preguntas. Revisa las relaciones con cuidado: una relación incorrecta puede llevar a una respuesta incorrecta sin ningún error.
Pila
Cómo usan las rutas el Data Map
El Data Map es el primer paso, y rutas y agentes se construyen sobre él. Cuando un agente recibe una pregunta, escribe su consulta sobre las tablas de una ruta, usando las descripciones y relaciones del Data Map para entenderlas.
- 01
Data Map
Describe tus tablas y cómo se relacionan.
- 02
Rutas
Al crear una ruta, eliges sus tablas y columnas entre tus tablas. Ya llevan las descripciones y relaciones del Data Map.
- 03
Agentes
Cada agente usa las rutas asignadas a él.
Roles
Data Map, ruta y agente
| Data Map | Ruta | Agente | |
|---|---|---|---|
| Describe | Tus tablas y cómo se relacionan | Qué se puede usar para un propósito, y cómo leerlo | Quién pregunta, y qué rutas puede usar |
| Tú creas | Una vez, con un clic | Una por cada propósito | Uno por cada trabajo |
| Lo usan | Rutas y agentes | Agentes | Tu aplicación o agente de IA |
Ejemplo
Cómo se ve un Data Map
Ejemplo de la información que guarda un Data Map. Es una ilustración, no la base de un cliente.
| Tabla | Descripción |
|---|---|
| customers | Una fila por cliente |
| orders | Una fila por pedido. Los pedidos cancelados siguen en la tabla |
Relaciones
Relaciones en el mismo mapa
| Relación | Significado | Origen |
|---|---|---|
| orders.customer_id → customers.id | Cada pedido pertenece a un cliente | Clave foránea |
| reservations.table_id → tables.id | Cada reserva usa una mesa | Sugerida por IA, revisada por ti |
Descripciones
Cómo escribir buenas descripciones
La IA redacta las descripciones y tú puedes mejorarlas.
customers — Una fila por cliente orders — Una fila por pedido. Los pedidos cancelados siguen en la tabla
- Di qué representa una fila de la tabla.
- Usa las palabras de tu negocio.
- Menciona lo que no sea obvio, por ejemplo que los pedidos cancelados siguen en la tabla.
- Sé breve. Una o dos frases bastan.
Importante
Conviene saber
- Solo se usan las tablas que incluyes. Las eliges en el Data Map.
- El Data Map describe tus datos. No abre el acceso a ellos. Lo que Claix puede leer lo deciden el rol de la base con el que te conectas y tus rutas. Usa un rol de solo lectura.
- Las sugerencias pueden estar mal. Revisa las descripciones y, sobre todo, las relaciones que sugiere la IA.
- Puedes cambiarlo en cualquier momento. Edita descripciones, añade relaciones o borra las que no quieras.
Preguntas frecuentes
- ¿Qué es el Data Map en Claix?
- Una descripción de tu base de datos: las tablas que eliges, para qué sirve cada una y cómo se relacionan. Tus rutas y agentes se construyen sobre él.
- ¿Tengo que escribirlo a mano?
- No. Con un clic, Claix genera el borrador, y tú lo revisas y cambias lo que quieras.
- ¿Qué sugiere Claix?
- Una descripción por tabla y las relaciones entre ellas. Lee relaciones de tus claves foráneas, y la IA sugiere otras.
- ¿Puedo cambiar lo que sugiere la IA?
- Sí. Puedes editar las descripciones, editar relaciones, añadir nuevas y borrar las que sugiere la IA.
- ¿Por qué necesito un Data Map antes de crear rutas?
- Porque las rutas usan tus tablas, y esas tablas ya llevan sus descripciones y relaciones del Data Map.
- Mi base no tiene claves foráneas. ¿Puedo usar el Data Map?
- Sí. Puedes añadir relaciones tú mismo, y la IA puede sugerir otras.
- ¿El Data Map da a los agentes acceso a mis tablas?
- No. Los agentes solo pueden usar lo que incluyen tus rutas, y Claix solo puede leer lo que permite el rol de tu base.
Genera tu Data Map
Conecta tu base de datos, haz clic y revisa el primer borrador. Después crea rutas y agentes sobre descripciones y relaciones en las que confías.