Utilizzo di Databricks Assistant

Assistente di Databricks è un assistente di IA compatibile con il contesto che consente di usare notebook di Databricks, editor SQL, processi, dashboard di IA/BI ed editor di file. Assistente di Databricks consente di usare dati e codice quando si richiede assistenza usando un'interfaccia di conversazione.

Per un account: Disabilitare o abilitare le funzionalità di Assistente di Databricks

Le funzionalità di Assistente di Databricks basate su IA di Azure sono abilitate per impostazione predefinita. Tuttavia, gli amministratori dell'account possono disabilitare le funzionalità di Assistente IA di Azure per tutte le aree di lavoro all'interno di un account. Gli amministratori dell'account possono anche applicare l'abilitazione di Assistente di Databricks per l'intero account:

1. Come amministratore dell'account, accedere alla console dell'account.

   Importante

   Se nessun utente nel tenant di Microsoft Entra ID ha ancora eseguito l'accesso alla console dell'account, l'utente o un altro utente nel tenant deve accedere come primo amministratore dell'account. A tale scopo, è necessario essere un amministratore globale di Microsoft Entra ID, ma solo quando si accede per la prima volta alla Console dell'account di Azure Databricks. Al primo accesso, si diventa un amministratore dell'account Azure Databricks e non è più necessario il ruolo amministratore globale di Microsoft Entra ID per accedere all'account Azure Databricks. Come primo amministratore dell'account, è possibile assegnare gli utenti nel tenant di Microsoft Entra ID come amministratori di account aggiuntivi (che possono assegnare più amministratori account). Gli amministratori dell'account aggiuntivi non richiedono ruoli specifici in Microsoft Entra ID. Vedere Gestisci utenti, entità servizio e gruppi.

2. Fare clic su Impostazioni.

3. Cliccare sulla scheda Abilitazione funzionalità.

4. Per l'opzione Abilita funzionalità basate su IA di Azure selezionare Disattivato o Attivato.

5. Impedire le sostituzioni dell'area di lavoro con l'impostazione Imponi:

Per informazioni sui servizi usati per le funzionalità di Databricks Assistant basate sull'intelligenza artificiale di Azure, vedere Funzionalità regolate dall'impostazione funzionalità di assistive ai partner basate su partner.

Per un'area di lavoro: Disabilitare o abilitare le funzionalità di Assistente

Se l'amministratore dell'account abilita Assistente, è abilitato per impostazione predefinita nelle aree di lavoro. A meno che l'amministratore dell'account non ha scelto di applicare l'impostazione, gli amministratori dell'area di lavoro possono disabilitarlo per le loro aree di lavoro.

Per disabilitare Assistente di Databricks in un'area di lavoro:

1. Cliccare sul nome utente nell'angolo superiore delle >Impostazioni dell'area di lavoro di Databricks.
2. Nel riquadro a sinistra in Amministratore dell'area di lavoro, cliccare sulla scheda Avanzate.
3. Per disabilitare Assistente, cliccare sull'interruttore Disattivato per le funzionalità di assistente basate su IA di Azure.

Panoramica del riquadro Assistente

Questa sezione descrive l'esperienza predefinita del riquadro Assistente.

Per aprire il riquadro Assistente, cliccare sulla barra laterale sinistra.

Digitare domande nella casella di testo nella parte inferiore del riquadro Assistente e premere Invio o cliccare a destra della casella di testo. Assistente visualizza la risposta. Lo screenshot seguente mostra le azioni che è possibile eseguire dopo che Assistant ha generato il codice nel riquadro Assistente.

È possibile eseguire di nuovo la stessa query per generare un'altra risposta. A tale scopo, passare il cursore sulla risposta e cliccare su .

Per chiudere il riquadro, cliccare di nuovo sull'icona o fare clic nell'angolo in alto a destra della cella. È possibile espandere il riquadro a larghezza intera cliccando su ; cliccare per restituire la larghezza predefinita del riquadro.

Il riquadro Assistente tiene traccia delle conversazioni anche se si chiude il riquadro o il notebook. Per cancellare le conversazioni precedenti, cliccare in alto a destra nel riquadro Assistente.

Thread e cronologia richieste

I thread di conversazione vengono mantenuti tra i diversi contesti in cui è disponibile Assistente di Databricks. Dal riquadro Assistente è possibile creare nuovi thread di conversazione, visualizzare la cronologia delle domande e delle richieste e gestire l'esperienza dell'Assistente Databricks.

Assistente di Databricks intitola i thread in base al contesto delle richieste, in modo da poter esplorare la cronologia della conversazione dell'Assistente. L'esempio seguente proviene da una domanda su un notebook.

Usare Assistente di Databricks in una cella del notebook

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

Per usare Assistente di Databricks 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 Invio (non Shift+Invio, come si farebbe per eseguire una cella) per fare in modo che Assistente generi una risposta.

Usare i comandi slash per i prompt

I comandi Slash sono un collegamento per la creazione di prompt comuni.

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 rivedere il codice prima di eseguirlo. Se il codice generato non è quello desiderato, riprovare aggiungendo altri dettagli o informazioni al commento. Vedere Suggerimenti per l'uso di Assistente di Databricks.

Ottenere spiegazioni dettagliate dei frammenti di codice. Usare il /explain prompt e includere termini come “essere concisi” o “spiegare il codice riga per riga” per richiedere il livello di dettaglio desiderato. È anche possibile chiedere ad Assistente di Databricks 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.

Fare riferimento alle tabelle nelle richieste tramite @

Per fare riferimento rapidamente alle tabelle nelle richieste di Assistente, usare il simbolo @ @.

Richiesta di supporto con codice

Assistente di Databricks consente di usare il codice, sia SQL che Python:

• Completamento automatico basato su intelligenza artificiale nei notebook di Databricks, nell'editor SQL e nell'editor di file.
• Filtro dei dati con prompt in linguaggio naturale.
• Debug del codice con diagnostica dell'errore (anteprima pubblica).

Filtrare i dati con prompt del linguaggio naturale

Usare Assistente di Databricks per filtrare gli output dei dati con prompt del linguaggio naturale.

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

Ottenere suggerimenti per il codice inline: esempi di Python e SQL

Durante la digitazione, vengono visualizzati automaticamente i suggerimenti. Premere Scheda per accettare un suggerimento. Per attivare manualmente un suggerimento, premere Opzione + MAIUSC + Spazio (in macOS) o Ctrl + MAIUSC + Spazio (in Windows).

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

Codice di debug: esempi Python e SQL

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

• Porre una domanda nel riquadro Assistente.
• Cliccare sul pulsante Diagnostica errore che appare nella cella quando si verifica un errore.
• Cliccare su Debug per esaminare in modo interattivo il codice riga 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:

Python

SQL

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

Correzione rapida

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.

Cliccare su Accetta ed esegui per apportare la correzione consigliata e continuare a eseguire il codice:

Diagnosticare gli errori nei processi (anteprima pubblica)

Assistente di Databricks consente di diagnosticare gli errori nei processi.

Per diagnosticare un processo con Assistente:

1. Aprire il processo non riuscito dall'interfaccia utente dei processi.
2. Selezionare Diagnostica Errore.

Ottenere risposte dalla documentazione di Azure Databricks

Nell'editor di notebook, Assistente di Databricks può rispondere a domande basate sulla documentazione di Databricks. Digitare la domanda o la richiesta nella casella di richiesta.

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 ha una colonna denominata Stato, è 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 editor SQL di Databricks.
• Nomi e descrizioni delle tabelle e delle colonne.
• Domande di richiesta precedenti.
• Tabelle preferite e attive.
• Per la funzionalità di diagnostica degli errori, 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'istruzione 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 selezionare 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 materiale sussidiario possibile per aiutarlo a restituire le informazioni desiderate nel formato desiderato, nel livello di dettaglio e così via. Ad 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”.

Assegnare esempi di valori di dati a livello di 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 commenti di tabella o colonna in Esplora Catalog per aggiungere una riga di dati di esempio. Si supponga, ad esempio, che la colonna altezza sia nel formato feet-inches. Per consentire all'Assistente di interpretare i dati, aggiungere un commento, ad esempio “La colonna altezza è 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 IA.

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 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 area dei file temporanei. Per eseguire il codice, cliccare nell'angolo in alto a sinistra della casella di codice nel riquadro Assistente.

Le schede seguenti mostrano esempi di codice Python e SQL:

Python

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:

• Cos'è Databricks Assistant?
• Attendibilità e sicurezza di DatabricksIQ
• Misurare l'impatto di Databricks Assistant