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:
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:
Acceda a una pantalla compatible, como SQL, Python, Builder, Computed Field o Source SQL.
Haga clic en el botón AI Helper en la barra superior.
El panel del asistente se abrirá en el lado derecho de la interfaz.
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:
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, 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:
Uso en Python
En el editor de scripts 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:
Uso en Builder
En la interfaz Builder, 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:
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:
Uso en Source SQL
En el contexto de 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:
Quick Prompts
AI Helper ofrece accesos rápidos con preguntas frecuentes según el contexto activo.
Ejemplos de prompts por contexto:
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
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
Abra un área compatible: SQL, Python, Builder, Computed Field o Source SQL.
Cree o edite la consulta, script, configuración o expresión.
Abra AI Helper.
Verifique el contexto mostrado en Active tab.
Use un Quick Prompt o escriba una pregunta específica.
Revise la respuesta del asistente.
Aplique los ajustes necesarios.
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.
Última actualización