> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/diagrama-esquema.md).

# Diagrama (Esquema)

<figure><img src="/files/OegushrixeiXAYTqXM3U" 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="/files/WLNOwsj6EhbhyGYYpdOa" 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/diagrama-esquema.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
