Personalizzare e migliorare le risposte di Databricks Assistant

Questa pagina fornisce suggerimenti e procedure consigliate per aiutare Databricks Assistant a fornire risposte migliori.

Personalizzare le risposte di Assistente aggiungendo istruzioni

È possibile personalizzare la modalità di risposta di Databricks Assistant aggiungendo istruzioni personalizzate. L'assistente considera queste istruzioni quando genera nuove risposte.

Ad esempio, le istruzioni possono includere:

• Informazioni sulle preferenze, ad esempio le librerie che si preferisce usare durante la scrittura di codice.
• Contesto relativo all'utente, ad esempio il nome e il ruolo.
• Convenzioni di codifica da seguire.
• Linee guida da seguire.
• Indicazioni su come l'Assistente deve rispondere, ad esempio usando un tono casuale.

Ad eccezione di Correzione rapida e completamento automatico, Databricks Assistant applica le istruzioni a ogni risposta generata, tra cui Assistente inline, Chat generale, Suggerisci correzione e modalità di modifica.

Databricks Assistant supporta due tipi di istruzioni: istruzioni utente e istruzioni per l'area di lavoro. Se non diversamente indicato, l'assistente in genere assegna la priorità alle istruzioni dell'area di lavoro sulle istruzioni dell'utente.

Aggiungere istruzioni per l'utente

Le istruzioni utente consentono di fornire istruzioni a livello di sistema all'Assistente. Sono un modo permanente per condividere il contesto, le preferenze o i metodi di creazione preferiti. Queste istruzioni sono specifiche dell'utente e vengono applicate solo alle interazioni con l'Assistente.

Per aggiungere istruzioni utente:

1. Aprire il riquadro Assistente facendo clic Nell'angolo superiore destro dell'area di lavoro.

2. Nel riquadro Assistente fare clic aprire le impostazioni dell'Assistente.

   

3. In Istruzioni utente fare clic su Aggiungi file di istruzioni. Verrà creato un .assistant_instructions.md file nella directory predefinita dell'area di lavoro utente (/Users/<your-username-or-email>) e verrà aperto in una nuova scheda del file.

   Se è già stato creato un file di istruzioni, fare clic su Apri file di istruzioni per aprire il file.

4. Modificare il .assistant_instructions.md file per aggiungere le istruzioni personalizzate. Databricks consiglia di aggiungere le istruzioni in testo in inglese normale, separando ogni istruzione come nuovo punto elenco o paragrafo. Vedere Procedure consigliate per istruzioni sull'assistente.

L'Assistente preleva automaticamente le istruzioni alla successiva interazione con esso.

È anche possibile usare l'Assistente per aggiungere istruzioni. Nel pannello Assistente o nella casella di input Assistente inline usare il /addInstructions comando .

Aggiungere e visualizzare le istruzioni dell'area di lavoro

Annotazioni

Solo gli amministratori dell'area di lavoro possono aggiungere o modificare le istruzioni dell'area di lavoro.

Le istruzioni per l'area di lavoro vengono configurate dall'amministratore dell'area di lavoro e forniscono un contesto maggiore all'Assistente per aiutarlo a seguire le linee guida e a operare in modo più efficiente nell'area di lavoro.

Se l'area di lavoro non ha ancora istruzioni sull'area di lavoro, un amministratore dell'area di lavoro può creare il file di istruzioni seguendo questa procedura:

1. Workspace/ Nella directory dell'area di lavoro creare un nuovo file denominato .assistant_workspace_instructions.md.
2. Modificare il file per aggiungere istruzioni per Assistente che devono essere applicate a livello di area di lavoro. Databricks consiglia di aggiungere le istruzioni in testo in inglese normale, separando ogni istruzione come nuovo punto elenco o paragrafo. Vedere Procedure consigliate per istruzioni sull'assistente.

L'Assistente preleva automaticamente le istruzioni della nuova area di lavoro alla successiva interazione dell'utente.

Per visualizzare o modificare le istruzioni dell'area di lavoro:

1. Aprire il riquadro Assistente facendo clic Nell'angolo superiore destro dell'area di lavoro.

2. Nel riquadro Assistente fare clic aprire le impostazioni dell'Assistente.

3. In Istruzioni dell'area di lavoro fare clic su Visualizza file. Verrà aperto il .assistant_workspace_instructions.md file in una nuova scheda.

4. Gli amministratori dell'area di lavoro possono modificare il file e aggiungere istruzioni applicabili al comportamento dell'Assistente in tutta l'area di lavoro. Per altre informazioni sull'aggiunta di istruzioni, vedere Procedure consigliate per l'assistente .

   Se non si è un amministratore, è comunque possibile visualizzare il file per comprendere le istruzioni che l'Assistente sta seguendo oltre alle istruzioni fornite dall'utente.

   

Procedure consigliate per le istruzioni dell'assistente

È importante considerare le potenziali limitazioni dell'Assistente quando si forniscono istruzioni. Ecco alcune linee guida generali e suggerimenti per la scrittura di istruzioni per ottimizzare l'esperienza e sfruttare al meglio questa funzionalità.

• Scrivere istruzioni chiare e specifiche: Quando si scrivono le istruzioni, è necessario essere espliciti e non ambigui.
• Mantenere le istruzioni sotto 4000 caratteri: I file di istruzioni sono limitati a 4000 caratteri. Tutte le istruzioni passate da questo limite non verranno usate dall'Assistente. Essere concisi e classificare in ordine di priorità istruzioni importanti.
• Usare intestazioni e delimitatori per la struttura: Le istruzioni sono contenute nei file Markdown. Usare la formattazione Markdown nelle istruzioni per fornire la struttura. Usare punti elenco come delimitatori per separare istruzioni distinte. Usare le intestazioni per raggruppare un set di istruzioni. Ad esempio, si potrebbe avere un'intestazione per "Convenzioni di codice Python" che include un elenco puntato di linee guida specifiche di Python che l'Assistente deve seguire quando si usa il codice Python.
• Portata: L'Assistente applica istruzioni a ogni risposta generata quando si interagisce con esso usando Assistente inline, Chat generale, Suggerisci correzione, Modalità di modifica e così via. Tuttavia, l'Assistente non prende in considerazione le istruzioni per correzione rapida e completamento automatico. Mantenere le istruzioni su larga scala rilevanti per diverse funzioni assistente per evitare comportamenti imprevisti.
• Fornire contesto e riferimenti: Anche se l'Assistente usa il contesto circostante, ad esempio il codice del notebook e i metadati della tabella, non recupera ancora informazioni aggiuntive in modo proattivo in base alle istruzioni. Per garantire risposte utili, includere i dettagli chiave direttamente nelle istruzioni, ad esempio quando usare una tabella o una funzione specifica.

Suggerimenti per migliorare le risposte dell'Assistente

Fornire istruzioni consente all'Assistente di generare risposte personalizzate in base alle preferenze. Oltre a questo, ci sono altre operazioni generali che è possibile eseguire quando si interagisce con l'Assistente per aiutarlo a restituire risposte migliori.

Databricks Assistant considera la cronologia della conversazione, in modo da poter perfezionare le domande man mano che si procede.

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. Valutare la possibilità di eseguire le operazioni seguenti:

• Specificare il livello di dettaglio che si sta cercando. Ad esempio, "Spiegare questo codice in un paio di frasi" o "Spiegare questa riga di codice per riga".
• Specificare la libreria che si desidera utilizzare dall'Assistente. Ad esempio, "Creare una visualizzazione usando Matplotlib" o "Creare una visualizzazione usando Seaborn".
• Specificare la struttura della risposta desiderata. Ad esempio, "Fornire istruzioni nei passaggi numerati" o "Fornire istruzioni con i passaggi come punti elenco con brevi spiegazioni".
• Specificare le richieste. Databricks Assistant conosce lo schema e i metadati della tabella e della colonna, quindi è possibile usare il linguaggio naturale per porre la domanda. Ad esempio, "Elencare il tasso di completamento dei quarterback NFL attivi e ritirati, per coloro che hanno avuto più di 500 tentativi in una stagione". Databricks Assistant risponde usando i dati delle colonne, s.player_id ad esempio e s.attempts.

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

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 filtrare i dataframe nel riquadro Assistente.

Aiutare l'Assistente a lavorare con i set di dati

L'Assistente può accedere al contesto delle tabelle in uso. Ecco alcune operazioni che è possibile eseguire per rispondere meglio quando si lavora con i set di dati:

• Quando si cerca una tabella, usare il prompt "Trova tabelle" o il comando /findTables per ottenere risposte migliori. Ad esempio, "Trova tabelle correlate ai giochi NFL".

• Utilizzare @<table-name> per fare riferimento a una tabella specifica in un prompt. L'Assistente adatta le risposte per l'uso di tale tabella.

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

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

• Documenti di tabelle e colonne nel catalogo unity. Vedere Aggiungere commenti generati dall'intelligenza artificiale agli oggetti del catalogo unity. In questo modo l'Assistente offre più contesto sui dati. Usare commenti di tabella o colonna in Esplora cataloghi per aggiungere una riga 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.

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

Usare Shift + Enter per aggiungere una nuova riga nella casella di testo della chat

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

Usare le azioni delle celle in un notebook

Le azioni delle celle includono collegamenti a attività comuni, ad esempio la documentazione (commento), la correzione e la spiegazione del codice.

Risorse aggiuntive

Per altri suggerimenti, vedere:

• Suggerimenti e consigli per gli analisti dei dati di Databricks Assistant
• Suggerimenti e consigli per gli assistenti databricks per i data engineer