Creare e gestire uno spazio Genie

Creare, condividere e gestire un Genie Space, l'interfaccia di chat in linguaggio naturale usata dagli utenti aziendali per porre domande sui propri dati in Azure Databricks. Gli analisti dei dati configurano ogni spazio con Unity Catalog, query SQL di esempio, istruzioni e asset attendibili; gli utenti aziendali lo interrogano tramite l'interfaccia di chat.

Requisiti tecnici e limiti

Quando si usa Genie Spaces, si applicano i requisiti e i limiti seguenti:

• Catalogo unity: I dati per Genie Space devono essere registrati nel catalogo unity. È possibile aggiungere fino a 30 tabelle o viste a uno spazio Genie.
• Compute: Genie Spaces richiede un SQL Warehouse Pro o Serverless. Quando si crea o si configura uno spazio Genie, è necessario disporre almeno dell'autorizzazione CAN USE per il magazzino selezionato. Le credenziali di calcolo vengono incorporate nello spazio Genie e usate per elaborare tutte le query per tutti gli utenti.
• Throughput: Ogni area di lavoro può gestire fino a 20 domande al minuto in tutti gli spazi Genie quando si accede tramite l'interfaccia utente di Azure Databricks. Quando si accede a Genie Spaces usando il livello gratuito dell'API Genie (anteprima pubblica), la velocità effettiva è limitata a cinque domande al minuto per area di lavoro, in tutti gli spazi Genie. Questi limiti predefiniti sono applicati per evitare abusi. Per scalare oltre, contattare il team dell'account Databricks.
• Capacità: Ogni Spazio Genie può supportare fino a 10.000 conversazioni e ogni conversazione può includere fino a 10.000 messaggi.

Autorizzazioni necessarie

Per creare o modificare uno spazio Genie, è necessario disporre delle autorizzazioni e dei diritti seguenti:

• Diritti: È necessario avere il diritto dell'area di lavoro SQL di Databricks. Vedere Gestire i diritti.
• Elaborazione: PUÒ USARE l'accesso in almeno un magazzino di dati SQL pro o serverless.
• Accesso ai dati:SELECT privilegi sui dati usati nello spazio.
• ACL di spazio genie: Almeno PUÒ MODIFICARE le autorizzazioni per lo spazio Genie. I creatori di Genie Space hanno automaticamente le autorizzazioni CAN MANAGE per gli spazi creati. Consultare Genie Space ACLs.

Gestire l'accesso a Genie

Genie usa funzionalità di intelligenza artificiale basate su partner, che devono essere abilitate a livello di account e area di lavoro. Per informazioni su come gestire queste funzionalità per l'account, vedere Funzionalità di intelligenza artificiale basate su partner.

Crea uno spazio Genie

Per creare uno spazio Genie:

1. Fare clic su Genie Spaces nella barra laterale.
2. Fare clic su Nuovo nell'angolo superiore destro della schermata.
3. Scegliere le origini dati da includere nello spazio Genie. Fare quindi clic su Crea.

Prima di condividere lo spazio con gli utenti, Databricks consiglia di aggiungere query SQL di esempio, istruzioni e configurazioni dell'archivio conoscenze per migliorare l'accuratezza della risposta. Vedi Regolare la qualità di Genie Space.

Esaminare i suggerimenti per le query

Per apprendere informazioni sui dati della tua area, Genie accede alle informazioni nell'area di lavoro per comprendere più a fondo le relazioni tra le tabelle e la semantica aziendale. Quando si aggiungono asset di dati a uno spazio, Genie cerca automaticamente le query dell'area di lavoro più diffuse associate a tali asset. Le credenziali utente vengono usate per trovare le query pertinenti per le quali si dispone almeno delle autorizzazioni CAN VIEW. Se la ricerca restituisce query, viene visualizzata una notifica nella scheda Dati del pannello Istruzioni . Fare clic su Rivedi per visualizzare le query suggerite.

Per altre informazioni sulle autorizzazioni di accesso alle query, vedere ACL di query.

Usare la finestra di dialogo Rivedi query suggerite per esaminare, modificare, accettare o rifiutare le query suggerite. Gli altri utenti con accesso almeno CAN EDIT nello spazio Genie possono esaminare le query, purché dispongano almeno dell'accesso CAN VIEW sulla query stessa.

1. Il testo titolo è prepopolato con una domanda. Rivedere o modificare la domanda digitando nel campo Titolo .
2. Il campo Codice contiene il testo completo della query SQL suggerita. Questo campo non è modificabile. Per visualizzare la query completa, fare clic su ... più linee.
3. Se si dispone di autorizzazioni sufficienti per la query, è possibile fare clic su Query SQL per aprire la query nell'interfaccia utente della cronologia query . Vedere Visualizzare la cronologia delle query.
4. Dopo aver determinato se la query è pertinente per lo spazio, fare clic su Accetta o Rifiuta per aggiungerla allo spazio o ignorare il suggerimento di conseguenza.
5. Fare clic su altri suggerimenti per espandere ed esaminare.

Le query accettate vengono visualizzate nel contesto query SQL per lo spazio. Dopo che sono stati aggiunti allo spazio, le domande suggerite e quelle associate sono completamente modificabili. Vedere Aggiungere query e funzioni SQL di esempio.

Se non vengono restituite query suggerite:

• Potrebbe non essere disponibile un accesso sufficiente alle query pertinenti.
• Potrebbero non essere presenti dati rilevanti. Se le query non sono state eseguite nelle tabelle incluse, la ricerca potrebbe non restituire risultati.
• Le query irrilevanti per lo spazio Genie non vengono considerate. Ad esempio, le query che eseguono solo operazioni di scrittura di base sugli asset inclusi non vengono considerate esempi rilevanti per Genie.
• Genie non suggerisce query su tabelle che non vengono aggiunte allo spazio. Se hai creato tabelle unite tramite join o viste appositamente per Genie Space, ma le query Databricks SQL relative vengono generalmente eseguite su una tabella di origine diversa, Genie non restituisce tali query nei risultati.

Gestire gli oggetti dati

Per gestire gli oggetti dati inclusi in uno spazio Genie, fare clic su Configura>dati. Fare clic sul pulsante aggiungi per aggiungere altre tabelle. Fare clic A destra del nome della tabella per rimuovere una tabella dallo spazio.

Per visualizzare i dettagli su un oggetto dati, fare clic sul nome dell'oggetto. La visualizzazione oggetto dati mostra due schede:

• Panoramica: mostra le colonne nell'oggetto dati, inclusi nomi di colonna, tipi di dati e descrizioni.
• Dati di esempio: mostra i dati di esempio della tabella per comprendere il contesto e il contenuto dei dati.

Configurare le impostazioni

Personalizzare lo spazio Genie configurando impostazioni aggiuntive. Fare clic su Configura>impostazioni per accedere alle impostazioni seguenti:

• Titolo: il titolo viene visualizzato nel browser dell'area di lavoro con altri oggetti dell'area di lavoro. Scegli un titolo che aiuterà gli utenti finali a scoprire il tuo Genie Space.
• Warehouse predefinito: questa risorsa di calcolo supporta le istruzioni SQL generate nello spazio Genie. Quando si salva una selezione di magazzino, le credenziali di calcolo vengono incorporate nello spazio Genie e usate per elaborare tutte le query Genie per tutti gli utenti. Per modificare il magazzino, è necessario disporre almeno delle autorizzazioni CAN EDIT per lo spazio. Se un autore diverso modifica il warehouse in un secondo momento, le credenziali di calcolo vengono incorporate. Uno spazio Genie può usare un data warehouse SQL pro o serverless. Per ottenere prestazioni ottimali, Databricks consiglia di usare un sql warehouse serverless.
• Tag: usare i tag per organizzare e classificareGenie Spaces per semplificare la gestione. Vedere Aggiungere tag.
• Anteprima: aggiungere un'immagine di anteprima allo spazio Genie. Le anteprime vengono visualizzate nella pagina iniziale della chat di Genie Space e in Genie One.
• Descrizione: gli utenti visualizzano la descrizione quando aprono genie spacee. Usare questa area di testo per descrivere lo scopo dello spazio. Il campo descrizione supporta la formattazione Markdown in modo da poter applicare stili al testo e fornire collegamenti a contesti e riferimenti utili. Per altre informazioni sulla sintassi markdown, vedere il foglio informativo della Guida markdown.
• Domande comuni: le domande comuni sono esempi facoltativi dei tipi di domande che gli utenti possono porre. Vengono visualizzati nella pagina iniziale della chat dello spazio e possono essere aggiunti durante la creazione o in seguito dalle Impostazioni dello spazio. Le domande comuni definite dall'autore hanno priorità e vengono visualizzate per prime. Quando fornisci domande comuni sufficienti per riempire la pagina di destinazione della chat, vengono visualizzate solo le tue domande. Quando si fornisce meno, Genie riempie gli slot rimanenti con domande generate automaticamente.

Aspettatevi di iterare sullo spazio Genie in base ai test e all'utilizzo. Per indicazioni sulle procedure consigliate per la creazione e l'iterazione su uno spazio, vedere Curare uno spazio genie efficace.

Aggiungere tag

Per aggiungere un tag, è necessario disporre almeno delle autorizzazioni CAN EDIT per uno spazio Genie. Per aggiungere un tag regolamentato, è necessario disporre anche dell'autorizzazione ASSIGN per il tag regolamentato. Per altre informazioni sui tag, vedere Applicare tag a oggetti a protezione diretta del catalogo Unity.

1. Fare clic su Configura>impostazioni.

2. Fare clic su Generale.

3. In Tag aggiungere o aggiornare un tag:

   • Se non sono presenti tag, fare clic sul pulsante Aggiungi tag.
   • Se sono presenti tag, fare clic sull'icona Aggiungi/Modifica tag.

4. Selezionare un tag esistente Chiave e Valore oppure immettere un nome di un nuovo tag.

   • I tag regolati si trovano nell'intestazione della sezione Regolamentata e hanno
   • Le chiavi dei tag sono obbligatorie. L'eventuale richiesta di un valore di tag dipende dalla chiave del tag.

Condividere un Genie Space

Per limitare i dati che ogni utente può visualizzare all'interno dello stesso spazio Genie, applicare la sicurezza a livello di riga alle tabelle sottostanti in Unity Catalog. I filtri di riga e le maschere di colonna definiti in Unity Catalog vengono applicati automaticamente per utente, indipendentemente dalla modalità di condivisione di Genie Space. Vedere Filtri di riga e maschere di colonna.

Quando si condivide uno spazio Genie, gli utenti devono avere le autorizzazioni seguenti per interagire con lo spazio:

• Autorizzazioni: Accesso consumer o autorizzazione all'area di lavoro SQL di Databricks. Vedere Gestire i diritti.
• Calcolare: Le query vengono eseguite usando le credenziali di calcolo incorporate dall'autore che ha configurato il warehouse. Gli utenti finali non necessitano delle autorizzazioni di direct warehouse.
• Accesso ai dati:SELECT Almeno privilegi per tutti gli oggetti dati di Unity Catalog usati nello spazio. Gli utenti visualizzano solo i dati a cui hanno l'autorizzazione per accedere.
• ACL di Spazio Genie: Almeno le autorizzazioni CAN VIEW/CAN RUN nello Spazio Genie. Consultare Genie Space ACLs.

I nuovi Genie Spaces vengono salvati nella cartella utente per impostazione predefinita. Analogamente ad altri oggetti dell'area di lavoro, ereditano le autorizzazioni dalla cartella contenitore. È possibile usare la struttura di cartelle dell'area di lavoro per condividerle con altri utenti. Consulta Browser dell'area di lavoro.

È anche possibile specificare determinati utenti o gruppi (inclusi tutti gli utenti dell'account) da condividere con a un determinato livello di autorizzazione: CAN MANAGE, CAN EDIT, CAN RUN e CAN VIEW.

Per condividere con utenti o gruppi specifici:

1. Fare clic su Condividi.
2. Immettere gli utenti o i gruppi con cui si vuole condividere lo spazio. Fare quindi clic su Aggiungi e impostare i livelli di autorizzazione appropriati. Singoli utenti e membri di piccoli gruppi ricevono una notifica tramite posta elettronica che conferma che lo spazio è stato condiviso.
3. Usare il pulsante Copia collegamento nella parte inferiore della finestra di dialogo Condividi per ottenere un collegamento condivisibile allo spazio Genie. Gli utenti con privilegi possono fare clic sul collegamento per aprire Genie Space in una nuova scheda e porre domande.

Per condividere con tutti gli utenti dell'account:

1. Fare clic su Condividi.
2. Selezionare Tutti gli utenti dell'account.
3. Impostare il livello di autorizzazione appropriato.

Gli utenti dello spazio possono anche condividere singole conversazioni. Vedere Condividere una conversazione.

Per condividere uno spazio Genie con utenti esterni all'organizzazione usando OpenSharing, vedere Condividere uno spazio Genie con OpenSharing.

Clonare un Genie Space

La clonazione di uno spazio Genie crea una copia che include tutto il contesto di installazione e le istruzioni. La clonazione è utile quando si desidera testare le modifiche in uno spazio separato o riutilizzare il contesto originale in una nuova. Dopo la clonazione di uno spazio, il nuovo spazio è indipendente dall'originale. È possibile apportare modifiche e aggiustamenti senza influire sull'originale.

Gli elementi seguenti vengono copiati in un Genie Space clonato:

• Tabelle e impostazioni
• Istruzioni generali
• Esempi di query SQL
• Funzioni SQL

I thread di chat esistenti e i dati della scheda Monitoraggio non vengono copiati nel nuovo spazio.

Per clonare uno spazio Genie, eseguire le operazioni seguenti:

1. Apri il Genie Space che vuoi clonare.
2. Fare clic Menu kebab nell'angolo superiore destro dello spazio.
3. Fare clic su Clona.
4. (Facoltativo) Nella finestra di dialogo Clona specificare un nuovo nome e un nuovo percorso della cartella dell'area di lavoro per lo spazio genie clonato.
5. Clicca Clona per creare il nuovo spazio.

Esportare uno spazio Genie come visualizzazione metrica

È possibile esportare il contesto da uno spazio Genie come visualizzazione metrica. In questo modo viene creata una visualizzazione delle metriche in base ai dati e al contesto semantico configurati nello spazio.

Per esportare uno spazio Genie come visualizzazione metrica, eseguire le operazioni seguenti:

1. Apri il Genie Space che desideri esportare.
2. Fare clic Menu kebab nell'angolo superiore destro dello spazio.
3. Selezionare Esporta in visualizzazione metrica.
4. Selezionare il percorso per la nuova visualizzazione delle metriche.
5. (Facoltativo) Fare clic Nell'angolo superiore destro della pagina per aprire Genie Code e perfezionare la definizione della visualizzazione metrica.
6. Clicca su Crea.

Risorse aggiuntive

• Per indicazioni sulle procedure consigliate e assistenza per la risoluzione dei problemi, vedere Curare uno spazio genie efficace.
• Per informazioni su come aggiungere esempi, istruzioni e configurare le impostazioni di SQL, vedere Ottimizzare la qualità di Genie Space.
• Per informazioni su come testare, esaminare le risposte e monitorare lo spazio, vedere Testare e monitorare uno spazio Genie.
• Per informazioni su come usare i log di controllo per tenere traccia dell'attività e dell'utilizzo in uno spazio Genie, vedere Eventi Genie Space.
• Vedere Usare l'API Genie Spaces per informazioni su come importare ed esportare Spazi Genie a livello di codice e usare l'API di conversazione Genie. Vedere anche le informazioni di riferimento sulle API Genie.
• Per informazioni su come creare un sistema multi-agente con agenti personalizzati, vedere Usare Genie nei sistemi multi-agente (Model Serving).