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 e ottimizzare il codice.
• Spiegare il codice.
• Aiutarti a trovare informazioni pertinenti nella documentazione di Azure Databricks.

Per informazioni sull'abilitazione e l'uso di Databricks Assistant, vedere Abilitare e provare Databricks Assistant. Per informazioni generali su Databricks Assistant, consultare le funzionalità supportate da DatabricksIQ .

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.

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 le query SQL inefficienti.
/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. Consulta i Suggerimenti per l'uso di Databricks Assistant.

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).

Ottenere assistenza con il codice

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

• 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 Diagnosi errore (anteprima pubblica).

Nota

I suggerimenti per il codice inline non sono disponibili nelle aree di Azure per enti pubblici o nelle aree di lavoro con conformità FedRAMP.

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).

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

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".

codice di debug: esempi python e SQL

Importante

Questa funzionalità si trova in anteprima pubblica.

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 esempi nel codice Python e SQL:

Pitone

esempio di debug di

SQL

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

correzione rapida di

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

Fare clic su Accettare ed eseguire per apportare la correzione consigliata e continuare a eseguire il codice:

Suggerimenti per l'uso di Databricks Assistant

Questa sezione include alcuni suggerimenti generali e procedure consigliate quando si usa Databricks Assistant.

Databricks Assistant usa il contesto per fornire risposte migliori

Databricks Assistant ha accesso a schemi di tabella e colonne e metadati. In questo modo è possibile usare il linguaggio naturale e generare query più accurate. Ad esempio, se una tabella contiene una colonna denominata State, è possibile chiedere a Databricks Assistant di generare un elenco di utenti che risiedono in Michigan.

Databricks Assistant usa il contesto seguente:

• Codice o query nella cella del notebook corrente o nella scheda dell'editor SQL di Databricks.
• Nomi e descrizioni delle tabelle e delle colonne.
• Domande precedenti.
• Tabelle preferite e attive.
• Per la funzionalità diagnosticare l'errore, l'analisi dello stack dall'output degli errori.

Quando si selezionano colonne da un dataframe, è possibile ottenere risultati più accurati fornendo una query iniziale. Ad esempio, fornire un esempio di dichiarazione come SELECT * FROM <table_name>. In questo modo Databricks Assistant può ottenere i nomi delle colonne e non dover indovinare.

Poiché Databricks Assistant usa la cronologia delle conversazioni per fornire risposte migliori e più accurate, è possibile chiedere a Databricks Assistant di modificare l'output di una risposta precedente senza dover riscrivere l'intero prompt. Usare la cronologia delle chat dell'Assistente per pulire in modo iterativo, esplorare, filtrare e suddividere i DataFrame nel riquadro Assistente.

Essere specifici

La struttura e i dettagli forniti da Databricks Assistant variano da un momento all'altro, anche per la stessa richiesta. Provare a fornire all'Assistente il maggior numero di indicazioni che è possibile per aiutarlo a restituire le informazioni desiderate nel formato desiderato, nel livello di dettaglio e così via. Per esempio:

• "Spiegare questo codice in un paio di frasi" o "Spiegare questo codice riga per riga".
• "Creare una visualizzazione usando MatPlotLib" o "Creare una visualizzazione con Seaborn".

Dare esempi di valori di dati per riga

Poiché Databricks Assistant non usa dati a livello di riga, potrebbe essere necessario fornire maggiori dettagli alle richieste per ottenere la risposta più accurata. Usare i commenti di tabella o colonna nel Catalog Explorer per aggiungere una linea di dati di esempio. Si supponga, ad esempio, che la colonna height sia nel formato feet-inches. Per consentire all'Assistente di interpretare i dati, aggiungere un commento, ad esempio "La colonna height è in formato stringa ed è separata da un trattino. Esempio: '6-2'". Per informazioni sui commenti di tabella e colonna, vedere Aggiungere commenti ai dati e agli asset di intelligenza artificiale.

Se è necessario usare le conversioni dei tipi di dati della colonna per eseguire un'operazione, potrebbe essere necessario specificare i dettagli. Ad esempio: "convertire questo codice da pandas a PySpark, incluso il codice necessario per convertire il dataframe pandas in un dataframe PySpark e modificare il tipo di dati della varianza di colonna da boolean a integer".

Usare MAIUSC+INVIO per aggiungere una nuova riga nella casella di testo della chat

Usare MAIUSC+INVIO per aggiungere una nuova riga nella casella di testo Assistente chat. In questo modo è facile formattare e organizzare i messaggi in Databricks Assistant.

Modificare ed eseguire il codice nel riquadro chat dell'Assistente Databricks

Eseguire il codice nel riquadro Assistente per convalidarlo o usarlo come scratchpad. Per eseguire il codice, fare clic su nell'angolo superiore sinistro della casella di codice nel riquadro Assistente.

Le schede seguenti mostrano esempi di codice Python e SQL:

Pitone

SQL

Quando si esegue il codice nel riquadro Assistente, viene visualizzato l'output e le variabili diventano utilizzabili nel notebook.

È anche possibile modificare il codice generato da Databricks Assistant direttamente nella casella di chat Assistente prima di spostare il codice nel notebook.

Informazioni aggiuntive

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

• Che cos'è Databricks Assistant?
• Abilitare e provare l'assistente Databricks
• attendibilità e sicurezza di DatabricksIQ
• Misurare l'impatto di Databricks Assistant