Panoramica e configurazione delle app di dati di Looker

Le app di dati di Looker sono dashboard canvas in formato libero create da agenti di programmazione AI locali, come Gemini CLI, Claude Code o Cursor, a partire da prompt in linguaggio naturale. A differenza dei dashboard a griglia standard, le app di dati ti offrono il controllo completo del layout visivo (inclusi posizionamento assoluto, elementi sovrapposti e componenti web personalizzati) pur rimanendo vincolate al livello semantico LookML gestito e alle autorizzazioni utente di Looker.

Quando crei un'app di dati, l'agente di codifica AI viene eseguito sulla tua macchina locale per generare il codice dell'applicazione. Dopo aver pubblicato l'app dati in Looker, non viene coinvolto alcun modello di AI quando gli utenti aprono o interagiscono con la dashboard.

Panoramica delle app di dati di Looker

Un'app di dati è un'estensione Looker, basata sul framework di estensione Looker e che viene eseguita all'interno di una dashboard definita dall'utente (UDD) a un solo elemento.

Le sue funzionalità principali includono:

  • Creazione assistita dall'AI, AI runtime zero: utilizzi un agente di programmazione AI sul tuo computer per generare il codice di layout e dei componenti dai prompt. Le app di dati pubblicate vengono eseguite come componenti web standard all'interno di Looker senza chiamare alcun modello di AI quando gli utenti visualizzano la dashboard.
  • Sandbox isolata dalla rete: poiché un agente AI scrive il codice dell'applicazione, Looker esegue ogni app di dati all'interno di una sandbox del browser isolata che blocca le connessioni di rete in uscita. Il codice dell'applicazione può comunicare solo con la tua istanza di Looker, quindi i risultati delle query e le credenziali utente non possono essere inviati a server esterni.
  • Accesso ai dati controllato: le app di dati eseguono query sui dati esclusivamente tramite il livello semantico LookML di Looker. Ogni query viene eseguita in base alle autorizzazioni Looker, all'accesso al modello e ai filtri di accesso a livello di riga dell'utente che visualizza la query.
  • Controlli interattivi e distribuzione pianificata: le app di dati includono filtri interattivi, filtri incrociati e visualizzazioni in dettaglio integrati all'interno dell'app. Inoltre, supportano i download di PDF di Looker e l'invio di email pianificato.

Prima di iniziare

Prima di installare gli strumenti per sviluppatori e creare un'app di dati, verifica di soddisfare i seguenti prerequisiti:

Requisiti dell'istanza

  • Devi utilizzare un'istanza ospitata da Looker che esegue Looker 26.18 o versioni successive.
  • Un amministratore di Looker deve attivare l'opzione di attivazione/disattivazione dell'anteprima App di dati nel pannello Amministrazione in Generale > Anteprime. Per saperne di più, consulta la pagina della documentazione sulle funzionalità di anteprima.
  • I browser degli utenti devono avere accesso alla rete www.gstatic.com per caricare le librerie di runtime delle app di dati.

Autorizzazioni obbligatorie

Per creare e pubblicare un'app di dati, devi disporre di quanto segue:

Per visualizzare un'app di dati pubblicata, gli utenti devono disporre di:

  • Il livello di accesso Visualizza alla cartella di destinazione

  • Le autorizzazioni di Looker access_data, explore e see_user_dashboards per i modelli LookML sottostanti

Credenziali API Looker

Gli strumenti per sviluppatori accedono all'istanza Looker utilizzando l'API Looker. Per concedere alle tue developer tool l'accesso all'API Looker, devi disporre di una chiave API, composta da un ID client e da un client secret. Fornisci l'ID client e il client secret agli strumenti per sviluppatori quando configuri le opzioni di configurazione.

Per recuperare la chiave API:

  1. L'amministratore di Looker deve attivare le chiavi API per il tuo account utente nella pagina Amministrazione > Utenti.
  2. In Looker, vai alla pagina Account utente.
  3. Nella sezione Autenticazione, accanto all'intestazione Chiavi API, fai clic su Gestisci.
  4. Nella pagina Chiavi API puoi visualizzare le chiavi API esistenti o crearne di nuove.
  5. Copia l'ID client e il client secret per la chiave API selezionata.

Identificatore della cartella

Identifica l'ID numerico della cartella Looker in cui vuoi pubblicare le tue app di dati. In Looker, apri la cartella di destinazione (ad esempio Condivisi o La mia cartella) e annota il numero alla fine dell'URL:

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

Limitazioni

Le app di dati di Looker presentano le seguenti limitazioni:

  • Incorporamento, temi e stampa: le app di dati non supportano l'incorporamento, i temi interni dei dashboard o la stampa. Tuttavia, puoi personalizzare lo stile visivo direttamente nell'app di dati chiedendo all'agente di programmazione AI.
  • Copia delle app di dati: evita di copiare un'app di dati in Looker. Poiché le copie fanno riferimento alla stessa applicazione sottostante, le modifiche apportate a una copia vengono replicate in tutte le copie.
  • Esportazione e importazione di LookML: l'esportazione di un'app di dati come LookML e l'importazione di un'app di dati da LookML non sono supportate.
  • Dipendenza da www.gstatic.com: le app di dati richiedono l'accesso alla rete a www.gstatic.com per caricare le librerie di runtime e dei componenti. I browser degli utenti devono essere in grado di raggiungere www.gstatic.com per eseguire il rendering delle app di dati.

Installa gli strumenti per sviluppatori

Per creare app di dati, installa gli strumenti per sviluppatori nel tuo ambiente di sviluppo locale (macOS o Linux).

Esegui lo script di installazione

Apri un terminale su una macchina con accesso all'agente di codifica AI ed esegui il seguente comando:

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

Configura le opzioni di configurazione

Durante l'installazione, rispondi alle richieste interattive:

  1. Directory di installazione: inserisci il percorso locale in cui vuoi archiviare il progetto Data Apps o premi Invio per accettare il percorso predefinito (~/looker-data-apps).
  2. URL istanza Looker: inserisci l'URL dell'istanza di Looker, ad esempio https://myinstance.looker.com.
  3. ID client API Looker: inserisci il tuo ID client.
  4. client_secret dell'API Looker: inserisci il client secret (salvato localmente in data-apps-config.json con autorizzazioni di accesso al file solo per il proprietario).
  5. ID cartella Looker: inserisci l'ID della cartella di destinazione che hai identificato in Identificatore cartella o premi Invio per accettare la cartella predefinita, ovvero la cartella 1, la cartella Condivisi.

Dopo aver completato le richieste, il programma di installazione esegue automaticamente un controllo di verifica in quattro passaggi per confermare che le tue credenziali funzionino e che la tua istanza di Looker possa archiviare e pubblicare le app di dati.

Creare, visualizzare l'anteprima e pubblicare un'app di dati

Segui questo workflow per creare un'app di dati con il tuo agente di codifica AI:

Passaggio 1: avvia l'agente di programmazione AI

Nel terminale, vai alla directory di installazione di Data Apps (~/looker-data-apps) e avvia l'agente di programmazione AI.

Passaggio 2: chiedi all'agente di generare un'app di dati

Utilizzando il linguaggio naturale per scrivere i prompt, chiedi all'agente di creare un'applicazione. La tua applicazione deve basarsi su esplorazioni e visualizzazioni esistenti, ma non devi utilizzare identificatori tecnici. Ad esempio:

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.

L'agente AI esamina le esplorazioni LookML, scrive la definizione del componente e avvia il server di anteprima locale.

Passaggio 3: esamina l'anteprima locale

Apri l'URL di anteprima locale (http://localhost:8765) fornito dall'agente.

Puoi anche eseguire make start (o python3 skills/data-app-previewer/tools/start-preview.py) nel terminale per visualizzare una galleria di tutte le app locali che hai creato.

Passaggio 4: perfeziona l'app in modo iterativo

Parla con il tuo agente AI per perfezionare il layout, lo stile e le interazioni:

  • "Allinea le tre schede delle metriche al lato destro del canvas."
  • "Aggiungi un cursore dell'intervallo di date sopra il grafico delle tendenze".
  • "Cambia lo sfondo con un grigio neutro delicato e aggiungi schede arrotondate con ombreggiature morbide."

Passaggio 5: pubblica l'app di dati su Looker

Quando il design ti soddisfa, chiedi all'agente di eseguire il deployment dell'app:

Publish this app to Looker.

L'agente esegue lo script di pubblicazione, che comprime lo script del componente e crea o aggiorna un oggetto dashboard nella cartella configurata.

Passaggio 6: visualizza l'app di dati in Looker

Fai clic sul link di Looker restituito dall'agente. La tua app di dati viene caricata in Looker con il supporto completo per i filtri di accesso degli utenti, la condivisione delle cartelle e le funzionalità della piattaforma.

Suggerimenti su cosa provare

Per esplorare le funzionalità delle app di dati di Looker durante l'anteprima, prova gli scenari seguenti:

Replicare i report esistenti dalle immagini

Carica uno screenshot di un report esistente da un altro strumento di BI (ad esempio Tableau o Power BI) o un file di presentazione nel tuo agente AI. Prompt dell'agente:

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

Gli agenti AI multimodali possono estrarre la geometria delle coordinate, la tipografia e le tavolozze di colori dalle immagini per generare layout di app di dati corrispondenti.

Progettare layout personalizzati

Vai oltre le griglie rettangolari standard creando layout asimmetrici:

  • Crea schede KPI mobili che si sovrappongono parzialmente ai banner hero.
  • Aggiungi barre laterali con il riepilogo esecutivo a più colonne accanto a griglie di dati larghe.
  • Applica branding aziendale personalizzato, stili di carattere e sfumature di sfondo.

Incorporare componenti UI interattivi avanzati

Chiedi al tuo agente di aggiungere elementi web interattivi:

  • Navigazione a schede: organizza metriche operative complesse in più schede senza ricaricamenti di pagina.
  • Finestre di dialogo modali e riquadri: apri visualizzazioni dettagliate o definizioni del glossario quando fai clic su una metrica.
  • Filtri e controlli interattivi: aggiungi pulsanti di attivazione/disattivazione, cursori e input di ricerca personalizzati che aggiornano dinamicamente le serie del grafico.

Utilizzare tabelle e visualizzazioni avanzate dei dati

Sfrutta le librerie di componenti integrate:

  • Integrazione di AG Grid: incorpora tabelle di dati interattive che supportano l'ordinamento e il ridimensionamento delle colonne e la formattazione delle celle.
  • Tipi avanzati di Highcharts: genera indicatori, mappe termiche, mappe ad albero e diagrammi di Sankey che i riquadri standard della dashboard non supportano.

Testare le funzionalità della piattaforma Looker

Verifica che la tua app di dati si integri con i flussi di lavoro di Looker:

  • Filtro incrociato: configura i grafici in modo che la selezione di una categoria in un grafico filtri le visualizzazioni rimanenti.
  • Esportazione PDF: scarica l'intera dashboard come PDF.
  • Invio pianificato: configura una pianificazione automatica per inviare un'istantanea PDF della tua app di dati al tuo team via email.