Compartir a través de


Obtén ayuda de codificación con Databricks Assistant

En este artículo se describe cómo puede usar Databricks Assistant para ayudarle a codificar y depurar los cuadernos, y se proporcionan sugerencias sobre cómo sacar el máximo partido del Asistente.

¿Con qué puede ayudar Databricks Assistant?

Databricks Assistant es un asistente de IA consciente del contexto con el que puede interactuar utilizando una interfaz conversacional, haciéndole más productivo dentro de Databricks. Puede describir la tarea en inglés y permitir que el asistente genere código de Python o consultas SQL, explicar código complejo y corregir errores automáticamente. El asistente usa metadatos de Unity Catalog para comprender las tablas, las columnas, las descripciones y los recursos de datos populares de toda la empresa y así proporcionar respuestas personalizadas.

Databricks Assistant puede ayudarle con las siguientes tareas:

  • Generar código.
  • Depurar el código, incluida la identificación y la sugerencia de correcciones de errores.
  • Transformar y optimizar el código.
  • Explicar el código.
  • Encontrar información pertinente en la documentación de Azure Databricks.

Para obtener información sobre cómo habilitar y usar Databricks Assistant, consulte Habilitar e probar Databricks Assistant. Para obtener información general sobre Databricks Assistant, consulta Características con tecnología de DatabricksIQ.

Métodos abreviados de comandos de Assistant para cuadernos

En un cuaderno, Databricks Assistant está disponible en el panel del asistente o insertado en una celda de código.

Para usar Databricks Assistant directamente en una celda de código, presione Cmd+I en MacOS o Ctrl+I en Windows. Aparece un cuadro de texto en la celda. Puede escribir una pregunta o comentario en inglés y, a continuación, presionar Enter (no Shift+Enter, como haría para ejecutar una celda) para que assistant genere una respuesta.

El asistente insertado le ayuda a localizar y agregar datos de enriquecimiento.

Uso de comandos de barra diagonal para indicaciones

Los comandos de barra diagonal son un acceso directo para crear indicaciones comunes.

Texto de la indicación Qué hace el Asistente
/ Muestra comandos comunes
/doc Comenta el código en una vista de diferencias
/explain Proporciona una explicación del código de una celda
/fix Propone una corrección de los errores de código en una vista de diferencias
/findTables Busca tablas pertinentes basadas en metadatos de Unity Catalog. Para buscar características o tablas de características, mencione "características" o "tablas de características" en la consulta. Consulte Búsqueda de características y tablas de características mediante Databricks Assistant.
/findQueries Busca consultas pertinentes basadas en los metadatos de Unity Catalog.
/optimize Mejora las consultas SQL ineficaces.
/prettify Da formato al código para mejorar la legibilidad.
/rename Sugiere nombres actualizados para las celdas del cuaderno y otros elementos, en función del contexto.
/settings Ajusta la configuración del cuaderno directamente desde el Asistente.

Cuando use /fix o /doc, en la ventana de diferencias seleccione Aceptar para aceptar los cambios propuestos o Rechazar para mantener el código original. Si acepta el código propuesto, el código no se ejecuta automáticamente. Puede revisar el código antes de ejecutarlo. Si el código generado no es lo que desea, inténtelo de nuevo agregando más detalles o información al comentario. Consulte Sugerencias para usar Databricks Assistant.

Obtenga explicaciones detalladas de fragmentos de código. Use la indicación /explain e incluya términos como "ser conciso" o "explicar el código línea a línea" para solicitar el nivel de detalle que quiera. También puede pedirle a Databricks Assistant que agregue comentarios al código.

La característica de autocompletar el código, el rendimiento podría ser mejor si usa el panel del Asistente que el de una celda del cuaderno.

El asistente se cierra automáticamente si Acepta o Rechaza el código que generó.

Tablas de referencia en mensajes mediante @

Para hacer referencia rápidamente a las tablas de las indicaciones del Asistente, use el símbolo @ (arroba).

Referencia de tabla en una indicación del Asistente mediante el símbolo @

Obtener ayuda con el código

Databricks Assistant ayuda con el código, tanto SQL como Python:

  • Autocompletar basado en IA en cuadernos de Databricks, el editor de SQL y el editor de archivos.
  • Filtrado de datos con indicaciones en lenguaje natural.
  • Depuración de código con Diagnosticar errores (versión preliminar pública).

Nota

Las sugerencias de código insertado no están disponibles en las regiones o áreas de trabajo de Azure Government en cumplimiento con el FedRAMP.

Obtener sugerencias de código insertadas: Ejemplos de Python y SQL

A medida que escriba, las sugerencias aparecerán automáticamente. Presione Tab para aceptar una sugerencia. Para desencadenar manualmente una sugerencia, presione Option+Shift+Space (en macOS) o Control+Shift+Space (en Windows).

GIF animado de finalización de código para SQL.

GIF animado de finalización de código para Python.

La acción de autocompletar basada en IA también puede generar código a partir de comentarios:

GIF animado de finalización de código a partir de un comentario.

Filtrado de datos con indicaciones en lenguaje natural

Use Databricks Assistant para filtrar las salidas de datos con indicaciones en lenguaje natural.

Para filtrar salidas con lenguaje natural, haga clic en el icono de filtro de la tabla de salida y escriba un mensaje. Por ejemplo, como en el ejemplo animado siguiente, puede pedir "Muéstrame solo hombres mayores de 70".

El GIF animado muestra a Databricks Assistant filtrando en una tabla de supervivientes del Titanic los hombres de más de 70 años.

Depuración de código: ejemplos de Python y SQL

Importante

Esta característica está en versión preliminar pública.

Para usar Databricks Assistant para corregir el código, realice cualquiera de las acciones siguientes:

  • Formule una pregunta en el panel Asistente.
  • Haga clic en el botón Diagnosticar error que aparece en los resultados de la celda cuando se produce un error.
  • Haga clic en Depurar para recorrer interactivamente el código línea a línea, establecer puntos de interrupción, inspeccionar variables y analizar la ejecución de un programa.

En las pestañas siguientes se muestran ejemplos de código de Python y SQL:

Python

Ejemplo de depuración del asistente en Python.

SQL

Ejemplo de depuración del asistente en SQL.

Al hacer clic en Diagnosticar error, el Asistente ejecuta /fixautomáticamente.

Corrección rápida

Cuando el código devuelve errores, la Corrección rápida recomienda automáticamente correcciones para errores básicos que se pueden corregir en un único cambio de línea.

Haga clic en Aceptar y ejecutar para realizar la corrección recomendada y continuar ejecutando el código:

Captura de pantalla de la interfaz de usuario de corrección de errores insertada de Databricks Assistant.

Sugerencias para usar Databricks Assistant

En esta sección se incluyen algunas sugerencias generales y procedimientos recomendados al usar Databricks Assistant.

Databricks Assistant usa el contexto para proporcionar mejores respuestas

Databricks Assistant tiene acceso a los metadatos y esquemas de tabla y columna. Esto le permite usar lenguaje natural y generar consultas más precisas. Por ejemplo, si una tabla tiene una columna denominada Estado, puede pedirle a Databricks Assistant que genere una lista de usuarios que viven en Michigan.

Databricks Assistant usa el siguiente contexto:

  • Código o consultas en la celda del cuaderno actual o en la pestaña Editor de Databricks SQL.
  • Nombres y descripciones de tablas y columnas.
  • Preguntas de solicitud anteriores.
  • Tablas favoritas y activas.
  • Para la característica de diagnóstico de errores, el seguimiento de la pila de la salida del error.

Al seleccionar columnas de un DataFrame, puede obtener resultados más precisos proporcionando una consulta inicial. Por ejemplo, proporcione una instrucción como SELECT * FROM <table_name>. Esto permite que Databricks Assistant obtenga los nombres de columna y no tenga que adivinar.

Dado que Databricks Assistant usa el historial de conversaciones para proporcionar respuestas más adecuadas y precisas, puede pedirle que modifique la salida de una respuesta anterior sin tener que volver a escribir toda la indicación. Use el historial de chats del Asistente para limpiar, explorar, filtrar y segmentar DataFrames de forma iterativa en el panel del Asistente.

Sea específico

La estructura y los detalles que proporciona Databricks Assistant varían de vez en cuando, incluso para la misma indicación. Intente proporcionar al Asistente tantas instrucciones como pueda para ayudarle a devolver la información que desea en el formato deseado, el nivel de detalle, etc. Por ejemplo:

  • "Explica este código en un par de oraciones" o "Explica este código línea por línea".
  • "Crea una visualización mediante MatPlotLib" o "Crea una visualización mediante Seaborn".

Proporcione ejemplos de valores de datos a nivel de fila.

Dado que Databricks Assistant no usa datos de nivel de fila, puede que necesite proporcionar más detalles a las solicitudes para obtener una respuesta lo más precisa posible. Use comentarios de tabla o columna en el Explorador de catálogos para agregar una línea de datos de ejemplo. Por ejemplo, supongamos que su columna de altura tiene el formato feet-inches. Para ayudar al Asistente a interpretar los datos, agregue un comentario como “La columna «altura» está en formato de cadena y está separado por un guión. Ejemplo: '6-2'.” Para obtener información sobre los comentarios de tabla y columna, consulte Agregar comentarios a los recursos de datos e inteligencia artificial.

Si tiene que usar conversiones de tipos de datos de columna para ejecutar una operación, es posible que tenga que proporcionar detalles. Por ejemplo, "Convierte este código de Pandas a PySpark, incluido el código necesario para convertir el DataFrame de Pandas en uno de PySpark y cambiar el tipo de datos del abandono de columnas de booleano a entero".

Usar Mayús+Entrar para agregar una nueva línea en el cuadro de texto del chat

Use Mayús+Entrar para agregar una nueva línea en el cuadro de texto del asistente de chat. Esto facilita el cambio de formato y la organización de los mensajes en Databricks Assistant.

Editar y ejecutar código en el panel de chat de Databricks Assistant

Ejecute código en el panel Asistente para validarlo o usarlo como bloc de dictado. Para ejecutar código, haga clic en icono de ejecutar código en la esquina superior izquierda del cuadro de código en el panel del Asistente.

En las pestañas siguientes se muestran ejemplos de código de Python y SQL:

Python

Ejecute código de Python en el panel del Asistente.

SQL

Ejecute código SQL en el panel del Asistente.

Al ejecutar código en el panel del Asistente, se muestra la salida y las variables se pueden usar en el cuaderno.

También puede editar el código que Databricks Assistant genera directamente en el cuadro de chat del Asistente antes de moverlo al cuaderno.

Información adicional

Los artículos siguientes contienen información adicional sobre el uso de Databricks Assistant: