# AI Helper
### Descripción general
**AI Helper** es un asistente contextual integrado en los flujos de trabajo de consultas, scripts y transformaciones de datos de la plataforma. Permite a los usuarios solicitar ayuda directamente dentro del entorno de trabajo, sin necesidad de cambiar a herramientas externas.
El asistente se accede mediante el botón **AI Helper**, disponible en la barra superior de las pantallas compatibles. Al abrirlo, se muestra un panel lateral en el lado derecho de la interfaz, manteniendo visible el editor, el Builder o el área de configuración.
### Dónde está disponible AI Helper
AI Helper está disponible en los principales entornos de desarrollo y modelado de datos de la plataforma:
| Área | Descripción |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **SQL** | Disponible en el editor SQL para ayudar a crear, explicar, corregir y optimizar consultas. |
| **Python** | Disponible en el editor de scripts Python para explicar código, investigar errores de ejecución y sugerir mejoras. |
| **Builder** | Disponible en el constructor visual de consultas, ayudando a trabajar con columnas, filtros, joins, agrupaciones, ordenamientos y límites. |
| **Computed Field dentro de Builder** | Disponible al crear o editar campos calculados, ayudando a escribir, corregir y explicar expresiones. |
| **Source SQL** | Disponible al definir fuentes SQL, ayudando a crear, validar y comprender la consulta utilizada como fuente de datos. |
### Objetivo
AI Helper está diseñado para apoyar a los usuarios durante el flujo de desarrollo, ayudándoles a:
* Comprender qué hace una consulta, script o configuración;
* Mejorar u optimizar consultas SQL;
* Explicar código Python;
* Investigar errores de ejecución;
* Interpretar resultados inesperados;
* Sugerir próximos pasos;
* Crear campos calculados;
* Construir consultas visuales en Builder;
* Explicar expresiones, funciones y transformaciones;
* Ajustar lógica, filtros, joins, agregaciones, ordenamientos y límites.
### Acceso a AI Helper
Para abrir el asistente:
1. Acceda a una pantalla compatible, como **SQL**, **Python**, **Builder**, **Computed Field** o **Source SQL**.
2. Haga clic en el botón **AI Helper** en la barra superior.
3. El panel del asistente se abrirá en el lado derecho de la interfaz.
4. Escriba una pregunta o seleccione uno de los **Quick Prompts** disponibles.
El panel puede cerrarse mediante el ícono **X** ubicado en la esquina superior derecha.
### Comportamiento contextual
AI Helper detecta el contexto activo y adapta su asistencia según el área que se esté utilizando.
Ejemplos:
```
Active tab: code
```
```
Active tab: builder
```
```
Active tab: computed
```
Este indicador muestra qué área está utilizando el asistente como contexto. Con base en ese contexto, las preguntas y sugerencias pueden dirigirse al código **SQL activo**, al **script Python**, a la configuración de **Builder** o a la expresión de un campo calculado.
### Uso en SQL
En el editor [SQL](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/ROTQdWDD4onGcUzj1hEL/herramientas/tareas/etl/sql), AI Helper puede utilizarse para:
* Explicar el propósito de una consulta;
* Revisar la estructura de la consulta;
* Identificar posibles errores de sintaxis;
* Sugerir mejoras de rendimiento;
* Ajustar filtros, joins, agrupaciones y ordenamientos;
* Investigar resultados incorrectos o inesperados.
Ejemplos de preguntas:
```
¿Qué hace esta consulta?
```
```
¿Cómo puedo mejorar esta consulta?
```
```
¿Por qué esta consulta devuelve un error?
```
```
¿Hay algún problema con este join?
```
### Uso en Python
En el editor de scripts [Python](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/ROTQdWDD4onGcUzj1hEL/herramientas/tareas/analisis/python), AI Helper puede ayudar en el análisis y mantenimiento del código.
Puede utilizarse para:
* Explicar cómo funciona un script;
* Identificar errores de ejecución;
* Sugerir simplificaciones;
* Organizar o refactorizar código;
* Detectar posibles problemas de lógica;
* Apoyar el uso de bibliotecas, funciones y manipulación de datos.
Ejemplos de preguntas:
```
¿Qué hace este script?
```
```
¿Por qué está fallando este código?
```
```
¿Cómo puedo organizar o simplificar este script?
```
```
¿Existe una forma más eficiente de escribir este código?
```
### Uso en Builder
En la interfaz [**Builder**](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/ROTQdWDD4onGcUzj1hEL/herramientas/tareas/etl/constructor), AI Helper apoya la creación visual de consultas. Ayuda a los usuarios a comprender la relación entre las configuraciones visuales y el SQL generado.
El asistente puede utilizarse para:
* Explicar el SQL generado por Builder;
* Orientar sobre cuándo usar filtros;
* Apoyar la configuración de joins;
* Sugerir agrupaciones;
* Explicar ordenamientos;
* Orientar sobre límites de filas y paginación;
* Explicar la diferencia entre usar Builder visual y escribir SQL directamente.
Ejemplos de preguntas:
```
¿Qué significa el SQL generado?
```
```
¿Cómo agrego un filtro a esta consulta?
```
```
¿Cuándo debo usar un join en Builder?
```
```
¿Cuál es la diferencia entre Builder y Query task?
```
### Uso en Computed Field dentro de Builder
Al crear o editar un **Computed Field** dentro de Builder, AI Helper está disponible para ayudar a escribir la expresión.
Este contexto es útil para:
* Crear expresiones calculadas;
* Corregir expresiones inválidas;
* Explicar expresiones existentes;
* Sugerir funciones compatibles;
* Apoyar el uso de funciones de ClickHouse;
* Validar los tipos de datos esperados;
* Transformar valores de columnas existentes.
Ejemplos de preguntas:
```
Crea una expresión para este campo calculado.
```
```
Corrige esta expresión.
```
```
Explica esta expresión.
```
```
¿Qué función de ClickHouse puedo usar aquí?
```
### Uso en Source SQL
En el contexto de [**Source SQL**](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/ROTQdWDD4onGcUzj1hEL/herramientas/tareas/etl/source-sql), AI Helper ayuda a crear y mantener la consulta SQL utilizada como fuente de datos.
Puede utilizarse para:
* Explicar la consulta de origen;
* Validar la estructura del SQL;
* Sugerir mejoras;
* Identificar problemas de sintaxis;
* Ajustar las columnas seleccionadas;
* Revisar los filtros aplicados a nivel de origen;
* Preparar los datos antes de utilizarlos en etapas posteriores.
Ejemplos de preguntas:
```
¿Esta consulta es adecuada como fuente de datos?
```
```
Explica esta Source SQL.
```
```
¿Cómo puedo mejorar la consulta de origen?
```
```
¿Hay algún filtro incorrecto en esta Source SQL?
```
### Quick Prompts
AI Helper ofrece accesos rápidos con preguntas frecuentes según el contexto activo.
Ejemplos de prompts por contexto:
| Contexto | Ejemplos de Quick Prompts |
| ------------------ | ----------------------------------------------------------------------------------- |
| **SQL** | `What does this query do?`, `How can I improve this query?`, `Error or odd result?` |
| **Python** | `What does this script do?`, `Execution error`, `Organize or simplify` |
| **Builder** | `What does generated SQL mean?`, `Builder vs Query task`, `Where to work?` |
| **Computed Field** | `Create expression`, `Fix expression`, `ClickHouse function`, `Explain expression` |
| **Source SQL** | Prompts relacionados con explicar, validar y mejorar la consulta de origen. |
### Estructura de la interfaz
| Elemento | Descripción |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Botón AI Helper** | Abre el panel lateral del asistente. |
| **Panel lateral** | Área donde el usuario interactúa con el asistente. |
| **Active tab** | Indica la pestaña o el contexto actualmente activo, como `code`, `builder` o `computed`. |
| **Área de orientación** | Muestra un mensaje indicando que el usuario puede preguntar sobre código, errores, resultados o próximos pasos. |
| **Quick Prompts** | Sugerencias rápidas para preguntas comunes, adaptadas al contexto activo. |
| **Campo de mensaje** | Campo donde el usuario escribe su solicitud. |
| **Botón Send** | Envía el mensaje al asistente. |
| **Ícono X** | Cierra el panel de AI Helper. |
### Flujo de uso recomendado
1. Abra un área compatible: **SQL**, **Python**, **Builder**, **Computed Field** o **Source SQL**.
2. Cree o edite la consulta, script, configuración o expresión.
3. Abra **AI Helper**.
4. Verifique el contexto mostrado en **Active tab**.
5. Use un **Quick Prompt** o escriba una pregunta específica.
6. Revise la respuesta del asistente.
7. Aplique los ajustes necesarios.
8. Ejecute, guarde o valide nuevamente el resultado.
### Buenas prácticas
Para obtener respuestas más precisas, se recomienda:
* Hacer preguntas claras y específicas;
* Describir el comportamiento esperado;
* Mencionar si el problema está relacionado con un error, rendimiento, lógica o resultado incorrecto;
* Revisar la respuesta antes de aplicar cambios;
* Validar manualmente cualquier sugerencia utilizando datos reales;
* Ejecutar pruebas después de modificar consultas, scripts o expresiones.
### Notas técnicas
AI Helper actúa como una capa de apoyo para el desarrollo en SQL, Python y Builder. También está disponible en contextos específicos como **Computed Field dentro de Builder** y **Source SQL**.
Las sugerencias proporcionadas por el asistente deben ser revisadas por el usuario antes de guardarse, ejecutarse o utilizarse en entornos de producción.
---
# Agent Instructions: 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/ai-helper.md?ask=
```
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.