Creare e gestire un agente Genie

Creare, condividere e gestire un agente Genie, 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 agente 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 usano agenti Genie, si applicano i requisiti e i limiti seguenti:

• Catalogo unity: I dati per l'agente Genie devono essere registrati in Unity Catalog. È possibile aggiungere fino a 30 tabelle o viste a un agente Genie.
• Calcolo: Gli agenti Genie richiedono un SQL warehouse Pro o serverless. Quando si crea o si configura un agente Genie, è necessario disporre almeno dell'autorizzazione CAN USE per il magazzino selezionato. Le tue credenziali di calcolo sono incorporate nel Genie Agent per fornire accesso al warehouse a tutti gli utenti. L'accesso ai dati viene sempre valutato utilizzando i permessi del Catalogo Unity di ogni utente finale. Vedi come funziona l'accesso ai dati.
• Capacità: Ogni agente Genie può supportare fino a 10.000 conversazioni e ogni conversazione può includere fino a 10.000 messaggi.

Autorizzazioni necessarie

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

• Diritti: È necessario avere il diritto dell'area di lavoro SQL di Databricks. Si veda Gestione dei diritti di accesso.
• Elaborazione: PUÒ USARE l'accesso in almeno un magazzino di dati SQL pro o serverless.
• Accesso ai dati:SELECT privilegi sui dati usati nell'agente.
• ACL agente Genie: Almeno PUÒ MODIFICARE le autorizzazioni per l'agente Genie. I creatori di Genie Agent hanno automaticamente le autorizzazioni CAN MANAGE per gli agenti creati. Vedi ACL di Genie Agent.

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.

Creare un agente Genie

Per creare un agente Genie:

1. Fare clic su Genie Agents (Agenti Genie ) nella barra laterale.
2. Fare clic su Nuovo nell'angolo superiore destro della schermata.
3. Scegli le origini dati che vuoi includere nel tuo agente Genie. Fare quindi clic su Crea.

Configurare un agente con Genie Code

Quando si crea un agente, Genie Code viene avviato automaticamente. Legge i dati e suggerisce il contesto che consente a Genie di rispondere con precisione alle domande, ad esempio descrizioni delle tabelle e query di esempio. Esaminare i suggerimenti e accettare quelli che si desidera mantenere. Per colmare una lacuna specifica, descrivi il contesto che vuoi che Genie Code aggiunga.

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

È anche possibile chiedere a Genie Code di creare automaticamente un agente quando non si conoscono ancora le tabelle da usare. Descrivere il dominio aziendale, le domande che l'agente deve rispondere e i dati da usare. Genie Code identifica i dati pertinenti, conferma le fonti con te e crea l'agente con quello stesso contesto iniziale.

Prima di condividere l'agente con gli utenti, Databricks consiglia di aggiungere query SQL di esempio, istruzioni e configurazioni dell'archivio conoscenze per migliorare l'accuratezza della risposta. Vedere Ottimizzare la qualità dell'agente Genie.

Esaminare i suggerimenti per le query

Per conoscere i dati del tuo agente, Genie accede alle informazioni presenti nell'area di lavoro per comprendere meglio le relazioni tra le tabelle e la semantica di business. Quando si aggiungono asset di dati a un agente, 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 sull'agente 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 l'agente, fare clic su Accetta o Rifiuta per aggiungerla all'agente 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 l'agente. Dopo essere state aggiunte all'agente, le query suggerite e le domande 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 l'agente 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 all'agente. Se hai creato tabelle unite tramite join o viste appositamente per Genie Agent, ma le query SQL di Databricks rilevanti in genere vengono 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 un agente 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 dall'agente.

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 l'agente 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. Scegliere un titolo che consentirà agli utenti finali di individuare l'agente Genie.
• Data warehouse predefinito: questa risorsa di calcolo alimenta le istruzioni SQL generate da Genie Agent. Quando salvi una selezione di magazzino, le tue credenziali di calcolo vengono incorporate nell'Agente Genie per fornire accesso al magazzino a tutti gli utenti. Queste credenziali incorporate consentono l'accesso solo al magazzino. L'accesso ai dati viene sempre valutato utilizzando i permessi del Catalogo Unity di ogni utente finale. Per modificare il magazzino, è necessario disporre almeno delle autorizzazioni CAN EDIT per l'agente. Se un autore diverso modifica il warehouse in un secondo momento, le credenziali di calcolo vengono incorporate. Un agente 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 classificare gli agentiGenie per semplificare la gestione. Vedere Aggiungere tag.
• Anteprima: aggiungere un'immagine di anteprima all'agente Genie. Le anteprime vengono visualizzate nella pagina iniziale della chat dell'agente Genie e in Genie One.
• Descrizione: gli utenti visualizzano la descrizione quando aprono Genie Agente. Usare questa area di testo per descrivere lo scopo dell'agente. 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 dell'agente e possono essere aggiunti durante la creazione o in un secondo momento dalle Settings dell'agente. 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.

Prevedete di dover apportare modifiche al vostro agente Genie sulla base dei test e dell'uso. Per linee guida sulle best practice per creare un agente e perfezionarlo iterativamente, consulta Creare un agente Genie efficace.

Aggiungere tag

Per aggiungere un tag, è necessario disporre almeno delle autorizzazioni CAN EDIT per un agente 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.

Condividi un agente Genie

Per limitare i dati che ogni utente può visualizzare all'interno dello stesso agente 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 dell'agente Genie. Vedere Filtri di riga e maschere di colonna.

Quando si condivide un agente Genie, gli utenti devono avere le autorizzazioni seguenti per interagire con l'agente:

• Autorizzazioni: Accesso consumer o autorizzazione all'area di lavoro SQL di Databricks. Si veda Gestione dei diritti di accesso.
• 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 nell'agente. Gli utenti visualizzano solo i dati a cui hanno l'autorizzazione per accedere.
• ACL dell'agente Genie: Sull'agente Genie sono necessarie almeno le autorizzazioni CAN VIEW/CAN RUN. Vedi ACL di Genie Agent.

I nuovi agenti Genie 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 l'agente. 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 l'agente è stato condiviso.
3. Usare il pulsante Copia collegamento nella parte inferiore della finestra di dialogo Condividi per ottenere un collegamento condivisibile all'agente Genie. Gli utenti con privilegi possono fare clic sul collegamento per aprire l'agente Genie 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 dell'agente possono anche condividere singole conversazioni. Vedere Condividere una conversazione.

Per condividere un agente Genie con utenti esterni all'organizzazione usando OpenSharing, vedere Condividere un agente Genie con OpenSharing.

Più azioni dell'agente

Il menu kebab nell'angolo in alto a destra di un agente fornisce le seguenti azioni.

Clona un agente Genie

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

Gli elementi seguenti vengono copiati in un agente Genie clonato:

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

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

Per clonare un agente Genie, eseguire le operazioni seguenti:

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

Esportare un agente Genie come visualizzazione delle metriche

È possibile esportare il contesto da un agente Genie come visualizzazione metrica. In questo modo viene creata una visualizzazione delle metriche in base ai dati e al contesto semantico configurati nell'agente.

Per esportare un agente Genie come visualizzazione metrica, eseguire le operazioni seguenti:

1. Aprire l'agente Genie da esportare.
2. Fare clic Menu kebab nell'angolo superiore destro dell'agente.
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.

Assegna la certificazione a un Agente Genio

Puoi contrassegnare un Agente Genie come certificato o obsoleto per indicare il suo stato di fiducia o ciclo di vita. La certificazione utilizza il tag governato da Unity Catalog system.certification_status . Per applicarlo, devi avere il permesso ASSIGN su quel tag.

Per assegnare la certificazione a un Agente Genio, fai quanto segue:

1. Apri l'agente Genie che vuoi certificare.
2. Clicca Menu Kebab nell'angolo in alto a destra dell'agente, poi seleziona Assegna certificazione.
3. Selezionare Certificato, Deprecato o Nessuno.
4. Fare clic su Salva.

Per ulteriori informazioni sulla certificazione, incluso come cercare per stato di certificazione, vedi Segnalare i dati come certificati o obsoleti.

Risorse aggiuntive

• Per indicazioni sulle procedure consigliate e assistenza per la risoluzione dei problemi, vedere Curare un agente Genie efficace.
• Per informazioni su come aggiungere esempi SQL, istruzioni e configurare le impostazioni, vedere Ottimizzare la qualità dell'agente Genie.
• Per informazioni su come testare, esaminare le risposte e monitorare l'agente, vedere Testare e monitorare un agente Genie.
• Per informazioni su come usare i log di controllo per tenere traccia dell'attività e dell'utilizzo in un agente Genie, vedere Eventi dell'agente Genie.
• Vedere Usare l'API Genie Agents per informazioni su come importare ed esportare agenti 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).