En esta página de documentación, se describe cómo usar la asistencia de Gemini para generar opciones de formato JSON a partir de instrucciones basadas en texto para acelerar la personalización de las visualizaciones de Looker. La personalización de visualizaciones con el Asistente de visualización es una función de Gemini en Looker que está disponible en las instancias de Looker (original) y Looker (Google Cloud Core).
El Asistente de visualización está disponible para las visualizaciones que usan la API de HighCharts, que incluye la mayoría de los gráficos cartesianos, como el gráfico de columnas, el gráfico de barras y el gráfico de líneas, entre otros.
Gemini en Looker es un producto de la cartera de Gemini para Google Cloud que proporciona asistencia generativa potenciada por IA para ayudarte a analizar tus datos y obtener estadísticas valiosas.
Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.
Esta página está dirigida a usuarios que exploran datos en una instancia de Looker.
Antes de comenzar
Para crear visualizaciones con la asistencia de Gemini, ten en cuenta los siguientes requisitos:
- Gemini en Looker debe estar habilitado para tu instancia de Looker:
- En el caso de Looker (original), la instancia debe ejecutar Looker 25.2 o una versión posterior, y la instancia debe estar habilitada para Gemini en Looker en la configuración de administrador. Para obtener instrucciones detalladas sobre la habilitación, consulta la página de documentación Configuración del administrador: Gemini en Looker.
- Para Looker (Google Cloud Core), la instancia debe estar habilitada para Gemini en Looker en la consola de Google Cloud . Para obtener instrucciones detalladas sobre la habilitación, consulta la página de documentación Administra Gemini en tu instancia de Looker (Google Cloud Core).
- Se te debe asignar un rol de observador que contenga el permiso
can_override_vis_config. - Se te debe asignar el rol de Gemini en Looker.
Cómo usar el Asistente de visualización
Para personalizar una visualización con el Asistente de visualización, sigue estos pasos:
- Visualiza una visualización compatible en una exploración o edita una visualización en una vista o un panel.
- Abre el menú Editar en la visualización.
- Haz clic en pen_spark Visualization Assistant para abrir el menú de instrucciones.
En el menú de instrucciones Visualization Assistant pen_spark, puedes hacer lo siguiente:
- Escribe una instrucción de texto sin formato de los cambios que quieres realizar en la visualización en el campo Ask anything. Para enviar send_spark tu instrucción, presiona Intro (Mac) o Enter (PC).
- Aplica las sugerencias generadas a la visualización.
- Abre Editar configuración del gráfico para escribir y editar manualmente las opciones de formato JSON.
- Borrar anulaciones de gráficos para borrar todos los cambios personalizados aplicados a la visualización. Se te pedirá que confirmes que quieres quitar todos los cambios antes de continuar. Si borraste los cambios por accidente, puedes recuperarlos navegando hacia atrás en el historial del navegador.
Una vez que se ejecute la instrucción, se abrirá una ventana de vista previa con las siguientes opciones:
- Escribe y edita manualmente las opciones de formato JSON generadas: Haz clic en Editar configuración del gráfico para abrir el editor de configuración del gráfico. Haz clic en Visualization Assistant para volver al menú de instrucciones.
- Comenzar una nueva instrucción: Haz clic en Comenzar de nuevo para comenzar una nueva instrucción desde el menú Visualization Assistant pen_spark. Se perderán todos los cambios que no se hayan aplicado.
- Aplica los cambios que se vieron en la vista previa a la visualización: Haz clic en Aplicar. Si se realizan cambios en el menú Configuración de gráficos, esta opción cambiará a Volver a validar y aplicar.
- Proporciona comentarios sobre la utilidad de la respuesta a la instrucción: Selecciona thumb_up para indicar que la respuesta a la instrucción fue útil o selecciona thumb_down para indicar que la respuesta no fue la esperada.
Aparecerá un mensaje de error Invalid JSON detected si intentas obtener una vista previa del código que contiene JSON no válido. Puedes limpiar el JSON no válido con la opción Código de corrección automática edit_fix_auto en la parte inferior del panel Configuración del gráfico.
Cómo crear instrucciones eficaces
Para escribir instrucciones eficaces, es necesario practicar. Prueba algunas de las siguientes sugerencias para escribir instrucciones que cumplan con tu objetivo.
Divide las instrucciones en varias partes
Las instrucciones tienen más éxito cuando se enfocan en un cambio a la vez. Por ejemplo, si quieres cambiar la familia de fuentes y el tipo de visualización, es mejor que hagas estas indicaciones por separado. Una vez que apruebes los cambios generados, aplícalos y, luego, comienza a escribir la siguiente instrucción.
Consigna: Cambia la última serie a una línea.
Consigna: Cambia la fuente a Arial y hazla negrita.
Intenta escribir una instrucción de varias maneras
Si no ves los resultados que esperas de la instrucción, intenta reformularla. Cuando apliques el formato condicional, intenta que la instrucción sea lo más clara posible. Establecer rangos de valores específicos y proporcionar códigos hexadecimales puede generar un resultado más exitoso. Consulta los ejemplos siguientes:
Buena instrucción: Haz que la primera serie sea #F4B400 si es superior a 350,000.
Consigna deficiente: Destaca los valores más altos en amarillo.
Si tienes varias series en una visualización, intenta hacer referencia a ellas por nombre en lugar de por su posición en el gráfico.
Consigna: Haz que la serie del medio sea una columna.
Mejor instrucción: Haz que la serie de usuarios sea una columna
Usa las indicaciones como punto de partida
Es posible que las personalizaciones particularmente complejas requieran realizar modificaciones directamente en el archivo JSON. Usa las indicaciones del Asistente de visualización para crear plantillas y patrones para personalizaciones complejas y, luego, usa Editar configuración del gráfico para escribir y editar manualmente las opciones de formato JSON. Consulta la documentación Cómo personalizar visualizaciones con el editor de configuración de gráficos para obtener más información sobre el uso de JSON de HighCharts.
Ejemplos de instrucciones
Prueba las siguientes indicaciones de muestra para obtener ideas sobre cómo el Asistente de visualización puede ayudarte a comenzar a personalizar tus visualizaciones:
- "Cambia este gráfico a uno de columnas"
- "Agregar etiquetas de datos al gráfico"
- "Establece el margen del gráfico en 100 px"
- "Establece el color de la línea como rojo"
- "Establece el color de fondo del gráfico como rosa"
- "Establece la forma del marcador de la serie de líneas como triángulo"
Proporcionar comentarios
Puedes enviar comentarios sobre la vista previa de la visualización en el menú de instrucciones del Asistente de visualización. Si la vista previa generada parece correcta, haz clic en el ícono de me gusta thumb_up. Si la vista previa generada parece incorrecta o no es lo que esperabas, haz clic en el ícono de pulgar hacia abajo thumb_down.