# Diagrama (Esquema)

<figure><img src="https://content.gitbook.com/content/7nKJZNWmfvaqAyIRrGi4/blobs/n2l44AZmbxGzqJvrbZjt/chrome_PbfIujXjS0.png" alt=""><figcaption></figcaption></figure>

La herramienta **Diagrama (Esquema)** proporciona una **representación visual de los modelos de datos y de las relaciones entre tablas**. Ayuda a los desarrolladores y a los agentes de IA a comprender cómo están estructurados y conectados los conjuntos de datos, haciendo que la exploración, el análisis y el razonamiento sobre los datos sean más precisos.

Esta herramienta también puede habilitarse para agentes de IA, permitiéndoles interpretar las relaciones entre tablas al responder preguntas o generar insights.

La herramienta Diagrama está diseñada para:

* Visualizar relaciones entre tablas
* Aclarar relaciones uno a uno, uno a muchos y muchos a muchos
* Servir como referencia para modelado de datos y análisis
* Proporcionar contexto estructural a los agentes de IA

## Cómo Configurar Diagramas

<figure><img src="https://content.gitbook.com/content/7nKJZNWmfvaqAyIRrGi4/blobs/1hxUtHkTzzWK6DfSbaKU/chrome_w70ZLMonPP.png" alt=""><figcaption></figcaption></figure>

1. Accede al diagrama mediante el ícono en el menú lateral.
2. Dentro de **Configuración**, es posible definir un nombre claro para el esquema o diagrama.
3. Describe el propósito y el alcance de este esquema.
4. Define la columna utilizada para filtrar datos relacionados con el usuario.
5. En la pestaña **Tablas**, los usuarios pueden seleccionar y filtrar las tablas que desean arrastrar al lienzo.
6. Después de arrastrar las tablas deseadas, el usuario puede crear relaciones entre las tablas utilizando las claves correspondientes de cada una.
7. Una vez relacionadas las tablas, es posible definir la cardinalidad de la relación.
8. Haz clic en el botón **Guardar** para persistir la configuración del esquema.
9. Accede al diagrama configurado en la pestaña **Diagramas** dentro del panel.

Estas relaciones permiten que tanto usuarios como agentes comprendan:

* Cómo fluyen los datos
* Qué tablas deben unirse
* Dónde tiene sentido aplicar agregaciones
* Cómo está estructurada la información

## Cómo los Agentes de IA Utilizan el Diagrama

Cuando está habilitado para un agente de IA, el Diagrama permite al agente:

* Comprender las relaciones entre tablas antes de ejecutar consultas
* Elegir correctamente las rutas de unión
* Evitar suposiciones incorrectas sobre la estructura de los datos
* Explicar los resultados con contexto estructural

## Buenas Prácticas

* Mantener los esquemas enfocados y específicos por dominio
* Utilizar nombres claros y consistentes
* Definir columnas de filtro por usuario cuando sea aplicable
* Evitar diagramas excesivamente complejos dentro de un mismo esquema
* Habilitar diagramas solo para agentes que necesiten comprensión estructural

{% hint style="success" %}
Un esquema limpio mejora tanto la comprensión humana como la de los agentes de IA.
{% endhint %}