Aggiungere commenti generati dall'intelligenza artificiale agli oggetti di Unity Catalog

Questo articolo presenta i commenti relativi a oggetti e colonne di tabella generati dall'intelligenza artificiale (noti anche come documentazione generata dall'intelligenza artificiale), spiega come funzionano e illustrano come aggiungerli e modificarli.

Importante

Il salvataggio dei commenti attiva un comando SQL ALTER, che può interrompere le pipeline e i processi di Azure Databricks.

Per informazioni dettagliate sull'intelligenza artificiale dietro i commenti generati dall'intelligenza artificiale, vedere Attendibilità e sicurezza delle funzionalità di intelligenza artificiale di Databricks.

Oggetti supportati

I commenti generati dall'IA sono supportati per gli oggetti catalogo Unity seguenti:

• Cataloghi
• Schemi
• Tabelle
• Colonne di tabella
• Funzioni
• Modelli
• Volumi

I commenti generati dall'intelligenza artificiale non supportano visualizzazioni o viste materializzate.

Come funzionano i commenti generati dall'intelligenza artificiale?

In qualità di proprietario di un oggetto o di un utente autorizzato a modificare un oggetto, è possibile usare Esplora cataloghi per visualizzare e aggiungere un commento generato dall'intelligenza artificiale per oggetti e colonne di tabella gestite da Unity Catalog. I commenti sono basati su un modello LLM (modello linguistico di grandi dimensioni) che tiene conto dei metadati degli oggetti, ad esempio lo schema della tabella e i nomi delle colonne.

I commenti generati dall'intelligenza artificiale offrono un modo rapido per aiutare gli utenti a individuare i dati gestiti da Unity Catalog.

Importante

I commenti generati dall'intelligenza artificiale sono progettati per fornire una descrizione generale degli oggetti e delle colonne di tabella in base allo schema. Le descrizioni vengono ottimizzate per i dati in un contesto aziendale e aziendale, usando schemi di esempio di diversi set di dati aperti in vari settori. Il modello è stato valutato con centinaia di campioni simulati per verificare che eviti la generazione di descrizioni dannose o inappropriate.

I modelli di intelligenza artificiale non sono sempre accurati e i commenti devono essere esaminati prima del salvataggio. Databricks consiglia vivamente la revisione umana dei commenti generati dall'IA per verificare la presenza di imprecisioni. Il modello non deve essere basato su per le attività di classificazione dei dati, ad esempio il rilevamento di colonne con informazioni personali.

Per visualizzare i commenti dopo l'aggiunta, è necessario avere il SELECT privilegio per l'oggetto, USE SCHEMA nello schema padre e USE CATALOG nel catalogo padre.

Per informazioni sui modelli usati per generare suggerimenti relativi ai commenti, vedere le domande frequenti.

Operazioni preliminari

Prima di poter usare i commenti generati dall'IA, un amministratore dell'area di lavoro deve abilitare le funzionalità assistite basate sui servizi di Azure AI:

1. In Impostazioni, passare alla scheda Avanzate e scorrere verso il basso fino alla sezione Altro.
2. Attivare l'opzione Funzionalità di IA assistite ai servizi di Azure AI.

Importante

Solo per tabelle e colonne, i commenti AI funzionano di default e non sono controllati dalle funzionalità assistive basate su AI partner. Per informazioni dettagliate, vedere Funzionalità regolate dall'impostazione funzionalità di assistive per intelligenza artificiale basata su partner.

Aggiungere commenti generati dall'IA

È necessario usare Esplora cataloghi per visualizzare i commenti suggeriti, modificarli e aggiungerli a oggetti e colonne di tabella.

Autorizzazioni necessarie: è necessario essere il proprietario dell'oggetto o avere il privilegio MODIFY per l'oggetto per visualizzare il commento suggerito dall'IA, modificarlo e aggiungerlo.

Aggiungere un commento suggerito dall'IA a un oggetto

1. Nell'area di lavoro di Azure Databricks fare clic Catalogo.

2. Cercare l'oggetto e selezionarlo.

3. Nel pannello Informazioni su questo <object>, fare clic su Generato dall’IA.

   

   L'IA potrebbe richiedere qualche minuto per generare il commento.

4. Fare clic su Accetta per accettare il commento così come è, oppure su Modifica per modificarlo prima di salvarlo.

Aggiungere un commento suggerito dall'IA a una colonna di tabella

1. Nell'area di lavoro di Azure Databricks fare clic Catalogo.

2. Cercare e selezionare la tabella.

3. Sopra le intestazioni di colonna della tabella fare clic su Generato dall’IA.

   Viene generato un commento per ogni colonna.

4. Fare clic sul segno di spunta accanto al commento della colonna per accettarlo o chiuderlo non salvato.

Aggiornare un commento generato dall'IA

Il proprietario dell'oggetto o l'utente con il privilegio MODIFY per l'oggetto può aggiornare i commenti in qualsiasi momento, usando l'interfaccia utente Esplora cataloghi. L'assistente chat inline consente di modificare i commenti, fornendo opzioni per Abbreviare il testo o Tradurre testo in una lingua diversa.

È anche possibile usare ALTER o COMMENT ON comandi SQL.

Domande frequenti sui commenti generati dall'intelligenza artificiale per gli oggetti del catalogo unity

Questa sezione fornisce informazioni generali sui commenti generati dall'intelligenza artificiale (nota anche come documentazione generata dall'intelligenza artificiale) per gli oggetti catalogo unity sotto forma di domande frequenti.

Quali servizi vengono usati dalla funzionalità commenti generati dall'intelligenza artificiale?

I commenti generati dall'intelligenza artificiale (nota anche come documentazione generata dall'intelligenza artificiale) per le tabelle e le colonne delle tabelle usano il servizio Azure OpenAI se l'intelligenza artificiale basata su partner è abilitata. Se si disattiva l'intelligenza artificiale basata su partner , i commenti di intelligenza artificiale usano un modello ospitato da Databricks.

Per altri dettagli, inclusi i modelli usati per altri commenti generati dall'intelligenza artificiale, vedere Funzionalità regolate dall'impostazione funzionalità di assistive ai partner basate su intelligenza artificiale.

In quali aree sono ospitati gli endpoint di gestione dei modelli?

Per le aree di lavoro dell'Unione europea (UE), le funzionalità di assistenza IA usano un modello esterno ospitato nell'UE. Tutte le altre aree usano modelli ospitati negli Stati Uniti.

Quali dati vengono inviati ai modelli?

Azure Databricks invia i metadati seguenti ai modelli con ogni richiesta API:

• Catalogo (nome catalogo, commento corrente, tipo di catalogo)
• Schema (nome catalogo, nome schema, commento corrente)
• Tabella (nome catalogo, nome schema, nome tabella, commento corrente)
• Funzione (nome catalogo, nome schema, nome funzione, commento corrente, parametri, definizione)
• Modello (nome catalogo, nome schema, nome modello, commento corrente, alias)
• Volume (nome catalogo, nome dello schema, nome del volume, commento corrente)
• Nomi di colonna (nome della colonna, tipo, chiave primaria o meno, commento colonna corrente)

I commenti approvati vengono archiviati nel database del piano di controllo di Azure Databricks, insieme al resto dei metadati del catalogo Unity. Il database del piano di controllo è crittografato a 256 bit AES.