Uso de Databricks Assistant

Databricks Assistant es un asistente de inteligencia artificial compatible con el contexto que puede ayudarle con cuadernos de Databricks, editor de SQL, trabajos, paneles de IA/BI y editor de archivos. El Asistente de Databricks le ayuda con los datos y el código cuando le pide ayuda mediante una interfaz de conversación.

Qué puede hacer con el Asistente de Databricks

El Asistente de Databricks puede ayudarle con las siguientes tareas:

• Generar, depurar, optimizar y explicar el código.
• Crear visualizaciones a partir de los datos. Consulte Creación de visualizaciones con el Asistente de Databricks.
• Depuración de trabajos (característica en vista previa).
• Codificar y editar consultas SQL.
• Encontrar información pertinente en la documentación de Azure Databricks.

El Asistente usa metadatos de Unity Catalog para comprender las tablas, columnas, descripciones y recursos de datos populares en toda la empresa para proporcionar respuestas personalizadas.

Habilitación del Asistente de Databricks

Databricks Assistant está habilitado de forma predeterminada. Consulte Para obtener una cuenta: Habilitación o deshabilitación de las características de Databricks Assistant.

Uso de Databricks Assistant en una celda del cuaderno

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

Para usar el Asistente de Databricks 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 Entrar (no Mayús+Entrar, como haría para ejecutar una celda) para que el Asistente genere una respuesta.

Uso de comandos de barra diagonal para mensajes

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

Texto de solicitud	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

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.

La característica de autocompletar el código funciona mejor en el panel del asistente que en una celda del cuaderno.

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

Diagnóstico automático de errores

El asistente se puede ejecutar /fix automáticamente siempre que detecte un mensaje de error en los cuadernos.

Habilite o deshabilite el /fix automático alternando el selector deErrores de corrección automática en el panel de errores del cuaderno.

Filtrado de datos con indicaciones en lenguaje natural

Use el Asistente de Databricks para filtrar las salidas de datos con avisos de 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".

Uso del panel del asistente

En esta sección se describe la experiencia predeterminada del panel Asistente.

Para abrir el panel del asistente, haga clic en en la barra lateral izquierda.

Escriba preguntas en el cuadro de texto situado en la parte inferior del panel del asistente y presione Entrar o haga clic en a la derecha del cuadro de texto. El Asistente muestra su respuesta. En el recorte de pantalla siguiente se muestran las acciones que puede realizar después de que el Asistente haya generado código en el panel Asistente.

Puede volver a ejecutar la misma consulta para generar otra respuesta. Para ello, mantenga el cursor sobre la respuesta y haga clic en .

Para cerrar el panel, haga clic de nuevo en el icono o haga clic en en la esquina superior derecha de la celda. Puede expandir el panel a todo lo ancho clic en ; haga clic en para devolver el panel al ancho predeterminado.

El panel del asistente realiza un seguimiento de las conversaciones incluso si cierra el panel o el cuaderno. Para borrar las conversaciones anteriores, haga clic en en la esquina superior derecha del panel del asistente.

Historial de subprocesos y mensajes

Los subprocesos de conversación persisten en los distintos contextos en los que Databricks Assistant está disponible. En el panel Asistente, puede crear nuevos subprocesos de conversación, ver el historial de preguntas y avisos y administrar la experiencia del Asistente de Databricks.

El asistente de Databricks pone un título a los subprocesos en función del contexto de las indicaciones, por lo que puede navegar por el historial de la conversación del Asistente. El ejemplo siguiente es de una pregunta sobre un cuaderno.

Autocompletado basado en IA

Importante

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

El autocompletado basado en IA le proporciona sugerencias de código insertado a medida que escribe en cuadernos de Databricks, el editor de SQL y el editor de archivos. Las sugerencias de código insertado están disponibles para Python y SQL.

Nota:

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

Obtención de sugerencias de código insertado: ejemplos de Python y SQL

A medida que escriba, las sugerencias aparecerán automáticamente. Presione el tabulador para aceptar una sugerencia. Para desencadenar manualmente una sugerencia, presione Opción + Mayús + Espacio (en macOS) o Control + Mayús + Espacio (en Windows).

El autocompletado basado en IA también puede generar código a partir de comentarios:

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

A fin de usar el Asistente de Databricks 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 de forma interactiva el código línea a línea, establecer puntos de interrupción, inspeccionar variables y analizar la ejecución del programa.

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

Python

SQL

Explicar el código

Databricks Assistant puede proporcionar explicaciones detalladas de los fragmentos de código. Use el mensaje /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 al Asistente para Databricks que agregue comentarios al código.

Obtención de información de la documentación de Azure Databricks

En el editor de cuadernos, Databricks Assistant puede responder a preguntas basadas en la documentación de Databricks. Escriba su pregunta o mensaje en el cuadro de solicitud.

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

El Asistente de Databricks tiene acceso a los metadatos y esquemas de tabla y columna. Esto le permite usar lenguaje natural y generar consultas bastante precisas. Por ejemplo, si una tabla tiene una columna Estado, puede pedirle al Asistente de Databricks 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 solicitud, como se muestra a continuación. Use el historial de chats del Asistente para limpiar, explorar, filtrar y segmentar DataFrames de forma iterativa en el panel Asistente.

Sea específico

La estructura y los detalles que proporciona Databricks Assistant varían de vez en cuando, incluso para la misma solicitud. 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 height 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 de la rotación 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 panel temporal. Para ejecutar código, haga clic en 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

SQL

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:

• ¿Qué es Databricks Assistant?
• Confianza y seguridad de DatabricksIQ