Creare LookML con gli strumenti di programmazione agentica

1. Introduzione

Gli strumenti di creazione di codice autonomi basati sull'ecosistema VS Code sono diventati molto popolari. Cursore e Antigravity sono solo due esempi. Questo codelab mostrerà come scrivere LookML con questi strumenti di codifica.

Attività previste

In questo codelab, utilizzerai l'estensione VS Code di Looker per modificare un modello LookML in modo da aggiungere una nuova misura, testarla e poi creare una dashboard LookML utilizzando questa nuova misura. Tutto questo verrà fatto richiedendo un agente di codifica.

Che cosa ti serve

Pubblico: sviluppatori LookML, data engineer e architetti.

2. Configurare l'istanza di Looker

Crea un progetto Google Cloud

  1. Nella console Google Cloud, nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud.
  2. Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

Connettere Looker all'origine dati

  1. In Looker, nella sezione Amministrazione, vai all'intestazione Database e seleziona Connessioni.
  2. Fai clic su Aggiungi connessione in alto a destra dello schermo.
  3. Crea una nuova origine dati per il set di dati Cymbal Gadgets. Assegna il nome cymbal_gadgets. Seleziona Google BigQuery Standard SQL per il dialetto SQL. Screenshot delle impostazioni di connessione generali
  4. Nella pagina successiva, inserisci il nome del progetto Google Cloud, il progetto di archiviazione looker-private-demo e il nome del set di dati cymbal_gadgets. Screenshot delle impostazioni del database
  5. Accetta i valori predefiniti per tutti i campi rimanenti e completa la procedura di creazione della nuova origine dati.
  6. In SQL Runner, verifica di poter eseguire query sul set di dati eseguendo
    SELECT count(*)
FROM looker-private-demo.cymbal_gadgets.transactions

Importa il progetto da GitHub

  1. Crea un fork del progetto https://github.com/looker-open-source/cymbal_gadgets da GitHub nel tuo repository. Non puoi aggiungere una chiave di deployment a un progetto di cui non sei proprietario, pertanto il fork è necessario per collegare il progetto a Looker.
  2. Attiva la modalità di sviluppo.
  3. Seleziona Sviluppo e poi Progetti.
  4. Nella pagina Progetti LookML, fai clic su Nuovo modello.
  5. Fai clic sul link per utilizzare la vecchia pagina di creazione del modello LookML. Screenshot del link alla vecchia finestra di dialogo per la creazione del modello
  6. Crea un nuovo progetto vuoto in Looker denominato cymbal_gadgets. Screenshot della finestra di dialogo Nuovo progetto
  7. Scegli Configura Git per connetterlo al repository creato mediante fork. Screenshot della configurazione di Git
  8. Aggiungi Deploy Key al tuo repository Git. Assicurati di selezionare la casella per consentire l'accesso in scrittura con la chiave di deployment. Screenshot della configurazione della chiave di deployment Git
  9. Quindi, scegli Testa e finalizza la configurazione. Screenshot della configurazione del progetto completata
  10. Verifica che il progetto e l'origine dati funzionino eseguendo una query sui dati dell'esplorazione "🛍️ Cymbal Gadgets: Transactions & Sales".
  11. Apri il progetto cymbal_gadgets nell'editor LookML e premi il pulsante Crea copia sviluppatore in alto a destra.
  12. Nella sezione Git Actions (Azioni Git), fai clic su Push Changes To Remote (Trasferisci modifiche al repository remoto) in modo che il ramo di sviluppo sia disponibile da GitHub. Screenshot di Azioni Git
  13. Da una sessione del terminale sul computer, esegui questo comando:
    cd $HOME
git clone git@github.com:YOUR_GITHUB_USER/cymbal_gadgets.git
cd cymbal_gadgets
git checkout YOUR_DEV_BRANCH
    Sostituisci YOUR_GITHUB_USER con il nome del tuo account utente GitHub. Sostituisci anche il nome del branch di sviluppo con YOUR_DEV_BRANCH. Il branch di sviluppo avrà un nome simile a dev-john-doe-jhgr, ovvero la parola dev seguita dal tuo nome e cognome e da una breve stringa casuale. Troverai il tuo ramo di sviluppo personale nella parte superiore dell'editor LookML nell'interfaccia utente di Looker.

3. Configura l'IDE agentico

Installare l'estensione VS Code

Nell'IDE, fai clic sull'icona Estensioni nel riquadro a sinistra. Quindi, cerca "Looker" e installa l'estensione ufficiale di Google facendo clic sul pulsante di installazione.

Installa il server MCP Toolbox for Databases

Per fornire ad Antigravity l'accesso all'API Looker (eseguire query, esaminare SQL, esaminare il modello LookML ed esaminare le informazioni sullo schema di connessione), è necessario un server MCP Toolbox per database locale in esecuzione. MCP Toolbox include l'implementazione ufficiale di Looker MCP. In questa sezione configurerai questa funzionalità per la tua istanza Looker.

  1. Per prima cosa, devi avere un'API client_id e un client_secret. Utilizza la guida alle API Looker per generare client_id e client_secret per il tuo utente. Avrai bisogno anche dell'URL di base per l'istanza di Looker.
  2. Ora utilizzerai npx per installare MCP Toolbox. Puoi fornire l'URL dell'istanza di Looker e le credenziali API come variabili di ambiente inline oppure puoi impostarle nell'ambiente shell. Esegui questo comando nell'ambiente shell per Mac e Linux:
    LOOKER_BASE_URL="https://your-instance.looker.com" \
LOOKER_CLIENT_ID="YOUR_CLIENT_ID" \
LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
npx @toolbox-sdk/server --prebuilt=looker,looker-dev
    Per Windows, esegui questo comando in PowerShell:
    $env:LOOKER_BASE_URL="https://your-instance.looker.com"
$env:LOOKER_CLIENT_ID="YOUR_CLIENT_ID"
$env:LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET"
npx @toolbox-sdk/server --prebuilt=looker,looker-dev

Configurare l'estensione VS Code

In questo passaggio, configurerai l'estensione VS Code per connetterti a Looker e al server MCP di Looker.

  1. In Antigravity, usa CMD+MAIUSC+P (Mac) o CTRL+MAIUSC+P (Linux/Windows) per aprire il riquadro dei comandi e scegliere Preferences: Open Workspace Settings (JSON).
  2. Aggiungi quanto segue alle impostazioni di Workspace per configurare l'estensione utilizzando client_id e client_secret. Per l'utilizzo di looker.projectId, utilizza cymbal_gadgets:
    {
   "looker.instanceURL": "https://your-instance.looker.com",
   "looker.clientId": "YOUR_API_KEY_CLIENT_ID",
   "looker.clientSecret": "YOUR_API_KEY_CLIENT_SECRET",
   "looker.projectId": "cymbal_gadgets"
}

Apri l'editor

  1. Apri Antigravity.
  2. Fai clic su File > Apri cartella….
  3. Vai alla cartella cymbal_gadgets e selezionala.

4. Creare una metrica del customer lifetime value

Per prima cosa, crea una nuova misura nel modello LookML esistente utilizzando l'agente. Una metrica Customer Lifetime Value sarà utile in questo caso d'uso per il settore retail. Utilizzerai l'agente per determinare la metodologia e LookML per questa misura.

Chiedere all'agente

Nel progetto cymbal_gadgets del tuo spazio di lavoro Antigravity, dovresti visualizzare una nuova interfaccia di conversazione a destra. Inizia la conversazione in modalità Pianificazione utilizzando l'ultimo modello Gemini con il prompt: Create a Customer Lifetime Value measure.

Screenshot del prompt in Antigravity

Controllare il piano di implementazione

L'agente creerà prima un piano di implementazione. Apri il piano di implementazione per esaminarlo, quindi fai clic sul pulsante Procedi.

Screenshot del piano di implementazione

Esamina il codice LookML

Rivedi il codice LookML modificato. Assicurati che le modifiche abbiano senso e siano valide.

Screenshot del LookML modificato

Il codice LookML modificato viene sincronizzato automaticamente con Looker dall'estensione VS Code. Può essere testato in modalità di sviluppo.

Test nell'IDE

Chiedi ad Antigravity di query CLV broken down by customer loyalty tier. Antigravity utilizzerà il server MCP di Looker per trovare i modelli, esaminare i campi disponibili ed eseguire una query utilizzando Looker. Il risultato sarà simile a questo:

Screenshot dei dati in Antigravity

Test in Looker

In Looker, con la modalità di sviluppo attivata, apri l'esplorazione 🛍️ Cymbal Gadgets: Transactions & Sales. Seleziona la misura customer lifetime value, quindi esegui il pivot per anno di registrazione del cliente. Esegui la query. Dovrebbe avere un aspetto simile a questo.

Screenshot dell'esplorazione

5. Creare una dashboard del customer lifetime value

Ora proviamo con un esempio più complesso. Chiederemo all'agente di creare una dashboard LookML completamente nuova.

Richiedere una nuova dashboard all'agente

Tornare ad Antigravity. Nella stessa conversazione, assicurati che siano selezionati la Modalità di pianificazione e l'ultimo modello Gemini. Poi il prompt Create a dashboard showing customer lifetime value based on customer loyalty tier.

Screenshot della creazione della dashboard

Approva di nuovo il piano di implementazione e accetta le modifiche al codice. Ora questo nuovo file LookML verrà sincronizzato automaticamente con Looker.

Test in Looker

In modalità di sviluppo, vai alla cartella LookML Dashboards. Seleziona la dashboard appena creata per visualizzarla.

Screenshot della nuova dashboard

6. Esegui la pulizia

  1. In Antigravity, nel riquadro Controllo della sorgente, ripristina le modifiche LookML, se vuoi. Accanto a ogni file LookML modificato è presente un simbolo come ↶ per ripristinare il file. Premi questo pulsante per ogni file. Screenshot del ripristino delle modifiche
  2. In Looker, seleziona Amministrazione, poi Database e infine Connessioni. Fai clic sull'icona a forma di ingranaggio per la connessione cymbal_gadgets e scegli Elimina. Conferma di voler eliminare la connessione.
  3. In Looker, utilizza la modalità di sviluppo. Seleziona Sviluppo e poi il progetto cymbal_gadgets. Nella sezione Impostazioni progetto, seleziona Elimina progetto. Conferma di voler eliminare il progetto digitando il nome del progetto - cymbal_gadgets - e selezionando il pulsante Elimina definitivamente cymbal_gadgets.

7. Complimenti

Congratulazioni per aver completato il codelab.

Argomenti trattati

  • Come modificare LookML con un agente.
  • Come verificare i piani di implementazione.
  • Come eseguire il test dall'IDE.
  • Come eseguire il test nell'interfaccia utente di Looker.
  • Come creare una nuova dashboard con un agente.

Da provare

Ora prova i seguenti prompt nell'interfaccia utente per vedere le diverse funzionalità dell'IDE autonomo:

  • Descrizioni efficaci sono fondamentali sia per gli utenti sia per l'AI. Chiedi all'agente di aggiungere descrizioni a tutti i campi che non ne hanno una.
  • Chiedi all'agente di aggiungere altri periodi di tempo a uno dei gruppi di dimensioni.
  • Chiedi all'agente di eseguire una query come "entrate suddivise per categoria di prodotto con pivot per trimestre".

Scopri di più