> 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/ai-helper.md). # 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.