Condividi tramite

Ottenere assistenza per la scrittura del codice da Databricks Assistant

Questo articolo descrive come usare Databricks Assistant per semplificare il codice e il debug dei notebook e fornisce suggerimenti su come sfruttare al meglio l'Assistente.

Che cosa può aiutare Databricks Assistant?

Databricks Assistant è un assistente di intelligenza artificiale compatibile con il contesto con cui è possibile interagire usando un'interfaccia conversazionale, rendendo più produttivi all'interno di Databricks. È possibile descrivere l'attività in inglese e consentire all'assistente di generare codice Python o query SQL, spiegare codice complesso e correggere automaticamente gli errori. L'assistente usa i metadati di Unity Catalog per comprendere le tabelle, le colonne, le descrizioni e gli asset di dati più diffusi nell'azienda per fornire risposte personalizzate.

Databricks Assistant può aiutarti con le seguenti attività:

  • Generare codice.
  • Eseguire il debug del codice, inclusa l'identificazione e la suggerimento di correzioni per gli errori.
  • Trasformare, ottimizzare e eseguire il refactoring del codice.
  • Spiegare il codice.
  • Aiutarti a trovare informazioni pertinenti nella documentazione di Azure Databricks.

Per informazioni sui modelli basati su Databricks Assistant, vedere Funzionalità di intelligenza artificiale basate su partner. Per informazioni generali su Databricks Assistant, vedere Che cos'è Databricks Assistant?.

Scorciatoie dei comandi di Assistant per i notebook

In un notebook, Databricks Assistant è disponibile nel riquadro Assistente o direttamente in una cella di codice.

Per usare Databricks Assistant direttamente in una cella di codice, premere Cmd+I in MacOS o Ctrl+I in Windows. Nella cella viene visualizzata una casella di testo. È possibile digitare una domanda o un commento in inglese e quindi premere Enter (non Shift+Enter, come si vuole eseguire una cella) per fare in modo che Assistente generi una risposta.

L'assistente in linea consente di individuare e aggiungere dati di arricchimento.

Usare i comandi barra per i prompt

I comandi Slash sono una scorciatoia per creare prompt comuni.

Testo del prompt Cosa fa Assistente
/ Visualizza i comandi comuni
/doc Commenti il codice in una visualizzazione diff
/explain Fornisce una spiegazione del codice in una cella
/fix Propone una correzione a eventuali errori di codice in una visualizzazione diff
/findTables Cerca le tabelle pertinenti in base ai metadati del catalogo unity. Per trovare le funzionalità o le tabelle delle funzionalità, menzionare "features" o "feature tables" nella query. Consultare Trovare le funzionalità e le tabelle delle funzionalità utilizzando l'Assistente Databricks.
/findQueries Effettua ricerche per query pertinenti basate sui metadati del catalogo Unity.
/optimize Migliora il codice SQL e Python.
/prettify Formatta il codice per la leggibilità.
/rename Suggerisce nomi aggiornati alle celle del notebook e ad altri elementi, a seconda del contesto.
/settings Regola le impostazioni del notebook direttamente da Assistente.

Quando si usa /fix o /doc, nella finestra diff selezionare Accetta per accettare le modifiche proposte o Rifiuta per mantenere il codice originale. Se si accetta il codice proposto, il codice non viene eseguito automaticamente. È possibile esaminare il codice prima di eseguirlo. Se il codice generato non è quello desiderato, riprovare aggiungendo altri dettagli o informazioni al commento. Vedere Suggerimenti per migliorare le risposte dell'assistente.

Ottenere spiegazioni dettagliate dei frammenti di codice. Usare il prompt /explain e includere termini come "essere concisi" o "spiegare il codice riga per riga" per richiedere il livello di dettaglio desiderato. È anche possibile chiedere a Databricks Assistant di aggiungere commenti al codice.

Per il completamento automatico del codice, le prestazioni possono essere migliori usando il riquadro Assistente rispetto a una cella del notebook.

L'assistente si chiude automaticamente se si Accetta o Rifiuta il codice generato.

tabelle di riferimento nelle richieste tramite @

Per fare riferimento rapidamente alle tabelle nei prompt dell'Assistente, usare il simbolo @ (chiocciola).

riferimento alla tabella nel prompt di un assistente utilizzando il simbolo @

Ottenere assistenza con il codice

Databricks Assistant consente di usare codice, sia SQL che Python:

  • Modalità di modifica, che funziona in un notebook per apportare correzioni e aggiornamenti a più celle.
  • Completamento automatico basato su intelligenza artificiale nei notebook di Databricks, nell'editor SQL e nell'editor di file.
  • Filtraggio dei dati con prompt in linguaggio naturale.
  • Debugging del codice con Diagnose Error.

Modalità di modifica per i suggerimenti in più celle del notebook

La modalità di modifica applica suggerimenti generati dall'intelligenza artificiale tra più celle del notebook da un'unica richiesta.

Per usare la modalità di modifica:

  1. Con un notebook aperto, fare clic sull'icona Sparkle dell'icona Assistente. In alto a destra nella schermata.

  2. Nel riquadro Assistente fare clic su Modifica nella parte inferiore della casella di richiesta.

    Modalità di modifica nel pannello Assistente Databricks.

  3. In modalità di modifica immettere un prompt proprio come si farebbe in modalità chat.

    Assistente analizza il blocco appunti e presenta suggerimenti inline nelle celle in cui sono necessarie modifiche.

  4. Dopo aver generato suggerimenti, è possibile esaminarli direttamente nel notebook o tramite il pannello Assistente. Fare clic su una cella nel pannello Assistente per passare a quella parte del notebook.

  5. Accettare o rifiutare le modifiche singolarmente, inline nel notebook o nel pannello Assistente. Per applicare tutti i suggerimenti contemporaneamente, fare clic su Accetta tutto o Rifiuta tutto.

Ottenere suggerimenti di codice inline: esempi python e SQL

Durante la digitazione, vengono visualizzati automaticamente i suggerimenti. Premere Tab per accettare un suggerimento. Per attivare manualmente un suggerimento, premere Option+Shift+Space (in macOS) o Control+Shift+Space (in Windows).

GIF animata del completamento del codice per SQL.

GIF animata del completamento del codice per Python.

Il completamento automatico basato su intelligenza artificiale può anche generare codice dai commenti:

GIF animata del completamento del codice da un commento.

Filtrare i dati con indicazioni in linguaggio naturale

Usare Databricks Assistant per filtrare gli output dei dati con comandi in linguaggio naturale.

Per filtrare gli output con il linguaggio naturale, fare clic sull'icona Filtro nella tabella di output e immettere un prompt. Ad esempio, come nell'esempio animato seguente, è possibile richiedere "Mostra solo maschi oltre 70".

La GIF animata mostra Databricks Assistant che filtra una tabella di sopravvissuti del Titanic, cercando maschi con età superiore ai 70 anni.

correzione rapida di

Quando il codice restituisce errori, Correzione rapida consiglia automaticamente le correzioni per gli errori di base che possono essere corretti in una modifica a riga singola.

Fare clic su Accetta ed eseguire per apportare la correzione consigliata e continuare a eseguire il codice, come illustrato nello screenshot seguente:

Istantanea dell'interfaccia utente per la correzione di bug inline di Databricks Assistant.

codice di debug: esempi python e SQL

Per usare Databricks Assistant per correggere il codice, eseguire una delle operazioni seguenti:

  • Porre una domanda nel riquadro Assistente.
  • Fare clic sul pulsante Diagnostica errore visualizzato nei risultati della cella quando si verifica un errore.
  • Fare clic su Debug per esaminare in modo interattivo la riga di codice per riga, impostare punti di interruzione, esaminare le variabili e analizzare l'esecuzione di un programma.

Le schede seguenti mostrano gli esempi di errore di diagnostica nel codice Python e SQL:

Pitone

esempio di debug di Assistant in Python.

SQL

Quando fai clic su Diagnostica errore, l'Assistente esegue automaticamente un prompt '/fix'.

esempio di debugging per l'assistente in SQL.

Quando si fa clic su Diagnostica errore, l'Assistente esegue automaticamente /fix.

Errori dell'ambiente di debug

L'Assistente consente di diagnosticare e suggerire correzioni per gli errori dell'ambiente, inclusi gli errori di installazione della libreria.

Quando si verifica un errore di installazione nel pannello laterale dell'ambiente, l'icona Sparkle Assistente compare in basso a destra. Fare clic sull'icona Sparkle. per aprire il riquadro Assistente, dove l'Assistente esegue /repairEnvironment per aiutare a diagnosticare e risolvere il problema.

È anche possibile aprire i log pip e quindi fare clic su Diagnostica errore per eseguire il /repairEnvironment comando nel riquadro Assistente.

Ottimizzare codice Python, PySpark e SQL

Usando il prompt della barra /optimize, valuta e ottimizza il codice Python, PySpark e SQL.

  1. In una cella del notebook o nell'editor SQL, fare clic sull'icona dell'Assistente guida nel prodotto - colore.
  2. Nella casella di richiesta digitare /optimizee fare clic sul pulsante Genera .
  3. Per usare i suggerimenti di ottimizzazione da Assistente, fare clic su Accetta.

Usare il prompt di ottimizzazione in un notebook.

Ecco come /optimize aiuta con il codice:

  • Avvisi di pre-esecuzione: La sottolineatura gialla evidenzia le opportunità per ottimizzare la query prima dell'esecuzione, ad esempio quando non si filtra in base a una colonna di partizione. Passare il puntatore del mouse sul testo sottolineato per visualizzare i suggerimenti di ottimizzazione.
  • Analisi post-esecuzione: Dopo aver eseguito il codice, fare clic sul pulsante Ottimizza .
  • Suggerimenti a livello di tabella: Ad esempio, quando gli utenti creano una tabella, ricevono un suggerimento che CREATE TABLE CLUSTER BY AUTOconsiglia .

Informazioni aggiuntive

Gli articoli seguenti contengono informazioni aggiuntive sull'uso di Databricks Assistant:

  • Last updated on