Descripción general y configuración de las apps de datos de Looker

Las apps de datos de Looker son paneles de control de formato libre que crean agentes de programación de IA locales, como Gemini CLI, Claude Code o Cursor, a partir de instrucciones en lenguaje natural. A diferencia de los paneles de cuadrícula estándar, las apps de datos te brindan un control visual completo del diseño (incluido el posicionamiento absoluto, los elementos superpuestos y los componentes web personalizados) y, al mismo tiempo, permanecen vinculadas a la capa semántica de LookML gobernada y a los permisos de usuario de Looker.

Cuando compilas una Data App, el agente de codificación de IA se ejecuta en tu máquina local para generar el código de la aplicación. Después de publicar la app de datos en Looker, no se involucra ningún modelo de IA cuando los usuarios abren el panel o interactúan con él.

Descripción general de las aplicaciones de datos de Looker

Una app de datos es una extensión de Looker que funciona con el framework de extensiones de Looker y se ejecuta dentro de un panel definido por el usuario (UDD) de un solo elemento.

Estas son algunas de las capacidades clave:

  • Creación asistida por IA, sin IA en el tiempo de ejecución: Usas un agente de programación de IA en tu computadora para generar el diseño y el código de componentes a partir de instrucciones. Las aplicaciones de datos publicadas se ejecutan como componentes web estándar dentro de Looker sin llamar a ningún modelo de IA cuando los usuarios ven el panel.
  • Zona de pruebas aislada de la red: Debido a que un agente de IA escribe el código de la aplicación, Looker ejecuta cada aplicación de datos dentro de una zona de pruebas aislada del navegador que bloquea las conexiones de red salientes. El código de la aplicación solo puede comunicarse con tu instancia de Looker, por lo que los resultados de las consultas y las credenciales del usuario no se pueden enviar a servidores externos.
  • Acceso a datos administrado: Las Apps de datos consultan los datos exclusivamente a través de la capa semántica de LookML de Looker. Todas las consultas se ejecutan con los permisos de Looker, el acceso al modelo y los filtros de acceso a nivel de las filas del usuario que realiza la consulta.
  • Controles interactivos y entrega programada: Las Apps de datos incluyen filtros interactivos, filtrado cruzado y vistas de desglose integrados en la app, y admiten descargas de PDF de Looker y entrega de correo electrónico programado.

Antes de comenzar

Antes de instalar las herramientas para desarrolladores y crear una app de datos, verifica que cumplas con los siguientes requisitos previos:

Requisitos de la instancia

  • Debes usar una instancia alojada en Looker que ejecute Looker 26.18 o una versión posterior.
  • Un administrador de Looker debe habilitar el botón de activación de vista previa de Apps de datos en el panel Administrador en General > Versiones preliminares. Para obtener más información, consulta la página de documentación de las Funciones en versión preliminar.
  • Los navegadores de los usuarios deben tener acceso a la red de www.gstatic.com para cargar las bibliotecas de tiempo de ejecución de las Apps de datos.

Permisos necesarios

Para crear y publicar una app de datos, debes tener lo siguiente:

Para ver una app de datos publicada, los usuarios deben tener lo siguiente:

  • El nivel de acceso Ver a la carpeta de destino

  • Los permisos de Looker access_data, explore y see_user_dashboards para los modelos de LookML subyacentes

Credenciales de la API de Looker

Tus herramientas para desarrolladores acceden a tu instancia de Looker a través de la API de Looker. Para otorgar acceso a tus herramientas para desarrolladores a la API de Looker, necesitas una clave de API, que consta de un ID de cliente y un secreto del cliente. Proporcionas tu ID de cliente y tu secreto del cliente a las herramientas para desarrolladores cuando configuras las opciones de configuración.

Para recuperar tu clave de API, sigue estos pasos:

  1. Tu administrador de Looker debe habilitar las claves de API para tu cuenta de usuario en la página Administrador > Usuarios.
  2. En Looker, ve a la página de tu cuenta de usuario.
  3. En la sección Autenticación, junto al encabezado Claves de API, haz clic en Administrar.
  4. En la página Claves de API, puedes ver tus claves de API existentes o crear nuevas.
  5. Copia el ID de cliente y el secreto del cliente de la clave de API que seleccionaste.

Identificador de carpeta

Identifica el ID numérico de la carpeta de Looker en la que deseas publicar tus aplicaciones de datos. En Looker, abre la carpeta de destino (como Compartida o Mi carpeta) y anota el número que aparece al final de la URL:

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

Limitaciones

Las apps de datos de Looker tienen las siguientes limitaciones:

  • Incorporación, aplicación de temas y función de impresión: Las Apps de datos no admiten la incorporación, los temas internos del panel ni la función de impresión. Sin embargo, puedes personalizar el diseño visual directamente en la app de datos solicitándole a tu agente de programación de IA.
  • Copia de apps de datos: Evita copiar una app de datos en Looker. Debido a que las copias hacen referencia a la misma aplicación subyacente, los cambios que se realizan en una copia se reflejan en todas las copias.
  • Importación y exportación de LookML: No se admite la exportación de una app de datos como LookML ni la importación de una app de datos desde LookML.
  • Dependencia de www.gstatic.com: Las Apps de datos requieren acceso a la red para www.gstatic.com para cargar bibliotecas de componentes y de tiempo de ejecución. Los navegadores de los usuarios deben poder acceder a www.gstatic.com para renderizar las Apps de datos.

Instala las herramientas para desarrolladores

Para crear Apps de datos, instala las herramientas para desarrolladores en tu entorno de desarrollo local (macOS o Linux).

Ejecuta la secuencia de comandos de instalación

Abre una terminal en una máquina con acceso a tu agente de codificación de IA y ejecuta el siguiente comando:

bash <(curl -fsSL https://dl.google.com/looker-data-apps/install.sh)

Cómo configurar las opciones de instalación

Durante la instalación, responde a las indicaciones interactivas:

  1. Directorio de instalación: Ingresa la ruta de acceso local en la que deseas almacenar tu proyecto de Data Apps o presiona Intro para aceptar la ruta de acceso predeterminada (~/looker-data-apps).
  2. URL de la instancia de Looker: Ingresa la URL de tu instancia de Looker, como https://myinstance.looker.com.
  3. Looker API client_id: Ingresa tu ID de cliente.
  4. API de Looker client_secret: Ingresa tu secreto del cliente (guardado de forma local en data-apps-config.json con permisos de archivo solo para el propietario).
  5. ID de la carpeta de Looker: Ingresa el ID de la carpeta de destino que identificaste en Identificador de carpeta o presiona Intro para aceptar la carpeta predeterminada, que es la carpeta 1, la carpeta Compartida.

Después de completar las indicaciones, el instalador ejecutará automáticamente una verificación de cuatro pasos para confirmar que tus credenciales funcionan y que tu instancia de Looker puede almacenar y entregar Apps de datos.

Crea, obtén una vista previa y publica una app de datos

Sigue este flujo de trabajo para crear una app de datos con tu agente de programación de IA:

Paso 1: Inicia tu agente de programación con IA

En tu terminal, navega al directorio de instalación de Data Apps (~/looker-data-apps) y, luego, inicia tu agente de programación con IA.

Paso 2: Solicita al agente que genere una app de datos

Usa lenguaje natural para escribir tus instrucciones y pídele al agente que cree una aplicación. Tu aplicación debe basarse en Explorar y vistas existentes, pero no es necesario que uses identificadores técnicos. Por ejemplo:

Build a responsive Looker Data App using the faa model and the
large\_flight\_data explore. I want this to be a dynamic, dark-themed operations
center.

Please include the following components:

The Map (Centerpiece): Create a custom visual that visualizes flights moving
from their Origin to Destination. Include a timeline slider (or playback
animation) based on Departure Time and Arrival Time so I can watch the flights
move over time.

KPI Strip: Across the top, include a row of KPI cards showing the total flight
Count, average Delay Mins, total Total Revenue, and average Load Factor.

Trend Chart: Include a line chart showing how Carbon Emissions and Total Revenue change over
the Departure Date periods.

Interactive Filters: Include drop-down filters for Airline, Status, and Origin
that wire into the charts and map to update the data dynamically.

El agente de IA inspecciona tus Exploraciones de LookML, escribe la definición del componente y, luego, inicia el servidor de vista previa local.

Paso 3: Inspecciona la vista previa local

Abre la URL de vista previa local (http://localhost:8765) que proporciona tu agente.

También puedes ejecutar make start (o python3 skills/data-app-previewer/tools/start-preview.py) en tu terminal para ver una galería de todas las apps locales que creaste.

Paso 4: Mejora tu app de forma iterativa

Habla con tu agente de IA para definir el diseño, el estilo y las interacciones:

  • "Alinea las 3 tarjetas de métricas al lado derecho del lienzo".
  • "Agrega un control deslizante de rango de fechas sobre el gráfico de tendencias".
  • "Cambia el fondo a un gris neutro sutil y agrega tarjetas redondeadas con sombras paralelas suaves".

Paso 5: Publica la app de datos en Looker

Cuando estés conforme con el diseño, pídele a tu agente que implemente la app:

Publish this app to Looker.

El agente ejecuta la secuencia de comandos de publicación, que empaqueta la secuencia de comandos del componente y crea o actualiza un objeto de panel en la carpeta configurada.

Paso 6: Visualiza la app de datos en Looker

Haz clic en el vínculo de Looker que devolvió el agente. Tu app de datos se carga en Looker con compatibilidad total para los filtros de acceso del usuario, el uso compartido de carpetas y las funciones de la plataforma.

Sugerencias de cosas que puedes probar

Para explorar las capacidades de las apps de datos de Looker durante la versión preliminar, prueba las siguientes situaciones:

Cómo replicar informes existentes a partir de imágenes

Sube una captura de pantalla de un informe existente de otra herramienta de IE (como Tableau o Power BI) o una presentación de diapositivas a tu agente de IA. Escribe la siguiente instrucción para el agente:

Replicate the layout, visual hierarchy, and color scheme shown in this
screenshot, binding the charts to our customer_analytics explore.

Los agentes de IA multimodales pueden extraer geometría de coordenadas, tipografía y paletas de colores de las imágenes para generar diseños de apps de datos coincidentes.

Diseña diseños personalizados

Crea diseños asimétricos para ir más allá de las cuadrículas rectangulares estándar:

  • Crea tarjetas de KPI flotantes que se superpongan parcialmente con los banners principales.
  • Agrega barras laterales de resumen ejecutivo de varias columnas junto a las cuadrículas de datos anchas.
  • Aplica la marca corporativa, los estilos de fuente y los degradados de fondo personalizados.

Incorpora componentes de IU interactivos y enriquecidos

Pídele a tu agente que agregue elementos web interactivos:

  • Navegación con pestañas: Organiza métricas operativas complejas en varias pestañas sin volver a cargar la página.
  • Diálogos y paneles modales: Abre vistas detalladas o definiciones de glosario cuando haces clic en una métrica.
  • Filtros y controles interactivos: Agrega botones de activación, controles deslizantes y entradas de búsqueda personalizados que actualicen las series de gráficos de forma dinámica.

Usa tablas y visualizaciones de datos avanzadas

Aprovecha las bibliotecas de componentes integradas:

  • Integración de AG Grid: Incorpora tablas de datos interactivas que admiten la clasificación y el cambio de tamaño de columnas, y el formato de celdas.
  • Tipos avanzados de Highcharts: Genera gráficos de velocímetro, mapas de calor, mapas de árbol y diagramas de Sankey que no admiten los mosaicos estándar del panel.

Prueba las funciones de la plataforma de Looker

Verifica que tu app de datos se integre con los flujos de trabajo de Looker:

  • Filtrado cruzado: Configura los gráficos para que, cuando se seleccione una categoría en uno de ellos, se filtren las visualizaciones restantes.
  • Exportación de PDF: Descarga todo el panel como un PDF.
  • Envío programado: Configura un programa automatizado para enviar una instantánea en PDF de tu app de datos a tu equipo por correo electrónico.