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.
Para una cuenta: Deshabilite o habilite las características de Databricks Assistant.
Las características del Databricks Assistant con tecnología de IA están habilitadas de manera predeterminada. Sin embargo, los administradores de cuentas pueden deshabilitar las características de Azure Assistant con tecnología de IA para todas las áreas de trabajo de una cuenta. Los administradores de cuentas también pueden aplicar la habilitación de Databricks Assistant para toda la cuenta:
Sugerencia
El acto de habilitar o deshabilitar las características de Databricks Assistant de Azure con tecnología de IA para su cuenta se captura como un evento de cuenta en sus registros de auditoría, consulte Eventos de cuenta.
Como administrador de la cuenta, inicie sesión en la consola de la cuenta.
Importante
Si ningún usuario del inquilino de Microsoft Entra ID no ha iniciado sesión todavía en la consola de la cuenta, usted u otro usuario del inquilino deben iniciar sesión como primer administrador de la cuenta. Para ello, debe ser administrador global de Microsoft Entra ID, pero solo la primera vez que inicie sesión en la consola de cuenta de Azure Databricks. Tras el primer inicio de sesión, se convertirá en administrador de cuentas de Azure Databricks, por lo que dejará de necesitar el rol de administrador global de Microsoft Entra ID para acceder a la cuenta de Azure Databricks. Como primer administrador de la cuenta, puede asignar usuarios del inquilino de Microsoft Entra ID como administradores de cuenta adicionales (que a su vez pueden asignar más administradores de cuentas). Los administradores de cuentas adicionales no requieren roles específicos en Microsoft Entra ID. Consulte Administración de usuarios, entidades de servicio y grupos.
Haga clic en Configuración.
Haga clic en la pestaña Habilitación de funcionalidades.
En la opción Habilitar características de Azure con tecnología de IA, seleccione Desactivar o Activado.
Impedir invalidaciones del área de trabajo con la configuración Aplicar :
Para obtener información sobre los servicios usados para las características de Databricks Assistant con tecnología de IA de Azure, consulte Características reguladas por la configuración de características de asistencia de IA con tecnología de asociado.
Para un área de trabajo: Deshabilitar o habilitar las características del Asistente
Si el administrador de la cuenta habilita Assistant, está habilitado de forma predeterminada en áreas de trabajo. A menos que el administrador de la cuenta decida aplicar la configuración, los administradores del área de trabajo pueden deshabilitarla para sus áreas de trabajo.
Para deshabilitar Databricks Assistant en un área de trabajo:
- Haga clic en su nombre de usuario en la barra superior del área de trabajo de Databricks >Configuración.
- En el panel izquierdo de Administrador del área de trabajo, haga clic en la pestaña Avanzadas.
- Para deshabilitar Assistant, haga clic en el botón de alternancia Desactivado para Características de asistencia de Azure con tecnología de IA.
Paseo por el panel 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.
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 |
/findTables |
Busca tablas pertinentes basadas en los metadatos de Unity Catalog. |
/findQueries |
Busca consultas pertinentes basadas en los metadatos de Unity Catalog. |
/prettify |
Da formato al código para facilitar la lectura. |
/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 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.
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ó.
Tablas de referencia en consultas mediante @
Para hacer referencia rápidamente a tablas en consultas de Asistente, use el símbolo @ (arroba).
Obtener ayuda con 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 avisos en lenguaje natural.
- Depuración de código con error de diagnóstico (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 con el cumplimiento de FedRAMP.
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".
Obtener sugerencias de código insertadas: 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
Importante
Esta característica está en versión preliminar pública.
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 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
SQL
Al hacer clic en Diagnosticar error, Assistant ejecuta /fixautomáticamente.
Corrección rápida
Cuando el código devuelve errores, 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:
Diagnosticar errores en trabajos (versión preliminar pública)
Importante
Esta característica está en versión preliminar pública.
Databricks Assistant ayuda a diagnosticar errores en los trabajos.
Para diagnosticar un trabajo con Asistente:
- Abra el trabajo con errores desde la interfaz de usuario trabajos.
- Seleccione Diagnosticar error.
Obtención de respuestas 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: