Panoramica e configurazione di Looker Data Apps

Le Looker Data Apps sono dashboard con canvas a forma libera create da agenti di programmazione AI locali, come Gemini CLI, Claude Code o Cursor, a partire da prompt in linguaggio naturale. Le Data Apps ti offrono il controllo completo del layout grafico (inclusi posizionamento assoluto, elementi sovrapposti e componenti web personalizzati) pur rimanendo vincolate al livello semantico LookML gestito di Looker e alle autorizzazioni dell'utente.

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

Panoramica di Looker Data Apps

Una Data App è un'estensione di Looker, basata sul framework di estensione Looker e in esecuzione all'interno di una dashboard definita dall'utente (UDD) a elemento singolo.

Le funzionalità principali includono le seguenti:

  • Creazione assistita dall'AI, AI senza runtime: utilizzi un agente di programmazione AI su computer per generare il codice di layout e dei componenti dai prompt. Le Data Apps 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 Data App all'interno di una sandbox del browser isolata che blocca le connessioni di rete in uscita. Il codice dell'applicazione può comunicare solo con l'istanza di Looker, pertanto i risultati delle query e le credenziali utente non possono essere inviati a server esterni.
  • Accesso ai dati gestito: le Data Apps 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.
  • Controlli interattivi: le Data Apps includono filtri interattivi integrati, filtri incrociati e visualizzazioni di drill-down all'interno dell'app.

Prima di iniziare

Prima di installare gli strumenti per sviluppatori e creare una Data App, 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 anteprima Data Apps nel riquadro Amministrazione in Generale > Anteprime. Per ulteriori informazioni, consulta la pagina della documentazione Funzionalità in anteprima.
  • I browser degli utenti devono avere accesso alla rete a www.gstatic.com per caricare le librerie di runtime di Data Apps.

Autorizzazioni obbligatorie

Per creare e pubblicare una Data App, devi disporre di:

Per visualizzare una Data App pubblicata, gli utenti devono disporre di:

  • Il livello di accesso Visualizza alla cartella di destinazione

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

Credenziali API Looker

Gli strumenti per sviluppatori accedono all'istanza di Looker utilizzando l' API Looker. Per concedere agli strumenti per sviluppatori l'accesso all'API Looker, hai bisogno di una chiave API, composta da un ID client e 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 utente Account.
  3. Nella sezione Autenticazione , fai clic su Gestisci accanto all'intestazione Chiavi API.
  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 di Looker in cui vuoi pubblicare le Data Apps. In Looker, apri la cartella di destinazione (ad esempio Condivisa o La mia cartella) e prendi nota del numero alla fine dell'URL:

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

Limitazioni

Le Looker Data Apps presentano le seguenti limitazioni:

  • Incorporamento, applicazione di temi e stampa: le Data Apps non supportano l'incorporamento, i temi delle dashboard interne o la stampa. Tuttavia, puoi personalizzare lo stile visivo direttamente nella Data App chiedendo al tuo agente di programmazione AI.
  • Copia delle Data Apps: evita di copiare una Data App 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 una Data App come LookML e l'importazione di una Data App da LookML non sono supportate.
  • Dipendenza da www.gstatic.com: le Data Apps 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 Data Apps.
  • Esportazione in PDF: il download della Data App in formato PDF non è supportato.
  • Invio pianificato: la configurazione di una pianificazione automatica per inviare uno snapshot PDF della Data App tramite email non è supportata.

Installare gli strumenti per sviluppatori

Per creare Data Apps, installa gli strumenti per sviluppatori nell'ambiente di sviluppo locale (macOS o Linux).

Eseguire lo script di installazione

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

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

Configurare le opzioni di configurazione

Durante l'installazione, rispondi ai prompt interattivi:

  1. Directory di installazione: inserisci il percorso locale in cui vuoi archiviare il progetto Data Apps o premi Invio per accettare il valore 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 API Looker: inserisci il tuo client secret (salvato localmente in data-apps-config.json con autorizzazioni di file solo per il proprietario).
  5. ID cartella Looker: inserisci l'ID della cartella di destinazione che hai identificato in Identificatore della cartella o premi Invio per accettare la cartella predefinita, ovvero la cartella 1, la cartella Condivisa.

Una volta completati i prompt, il programma di installazione esegue automaticamente un controllo di verifica in quattro passaggi per confermare che le credenziali funzionino e che l'istanza di Looker possa archiviare e pubblicare le Data Apps.

Creare, visualizzare in anteprima e pubblicare una Data App

Segui questo workflow per creare una Data App con l'agente di programmazione 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 una Data App

Utilizzando il linguaggio naturale per scrivere i prompt, chiedi all'agente di creare un'applicazione. L'applicazione deve essere basata su Esplora e viste 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 ispeziona le Esplora LookML, scrive la definizione del componente e avvia il server di anteprima locale.

Passaggio 3: ispeziona 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 l'agente AI per perfezionare il layout, lo stile e le interazioni:

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

Passaggio 5: pubblica la Data App in Looker

Quando sei soddisfatto del design, chiedi all'agente di eseguire il deployment dell'app:

Publish this app to Looker.

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

Passaggio 6: visualizza la Data App in Looker

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

Suggerimenti per le attività da provare

Per esplorare le funzionalità di Looker Data Apps durante l'anteprima, prova i seguenti scenari:

Replica 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 set di slide nell'agente AI. Chiedi all'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 dei colori dalle immagini per generare layout di Data App corrispondenti.

Progetta layout personalizzati

Vai oltre le griglie rettangolari standard creando layout asimmetrici:

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

Incorpora componenti UI interattivi avanzati

Chiedi all'agente di aggiungere elementi web interattivi:

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

Utilizza tabelle e visualizzazioni di dati avanzate

Sfrutta le librerie di componenti integrate:

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

Testa le funzionalità della piattaforma Looker

Verifica che la Data App si integri con i processi di Looker.