Analizza i file all'interno dei volumi con Genie Agent

Un agente Genie può analizzare i file non strutturati archiviati in volumi del catalogo Unity, ad esempio PDF, Word documenti, mazzi diapositive e immagini. Un autore di agente allega fino a 10 volumi e gli utenti aziendali pongono domande sui loro contenuti insieme ai dati strutturati dell'agente in una singola conversazione.

Cosa puoi chiedere a un Agente Genie riguardo ai tuoi file

Collegando volumi a un agente, gli utenti aziendali possono combinare dati da documenti come ticket di supporto, log delle chiamate di vendita e file di criteri con i dati delle tabelle strutturate dell'agente. Gli utenti possono quindi rispondere a domande come:

• Quali problemi di supporto richiedono più tempo per risolvere e cosa dicono i clienti nelle richieste di escalation?
• Perché le opportunità di vendita in ritardo si bloccano e quali obiezioni appaiono più spesso nei registri delle chiamate di vendita?
• Quali regioni hanno prestazioni inferiori e quali politiche di escalation interne si applicano?

Per unire un file CSV locale o Excel in una singola conversazione anziché analizzare i file archiviati nei volumi, vedere Caricare un file in un agente Genie.

Come un Genie Agent analizza i file

Quando un utente pone una domanda che richiede il contesto di un volume, l'Agente Genie recupera il contenuto del file più rilevante per la domanda e lo aggiunge al contesto dell'agente. L'agente quindi ragiona su tale contenuto insieme agli eventuali dati strutturati per generare una risposta con citazioni.

L'analisi dei file viene eseguita solo in modalità Agente, che usa il ragionamento in più passaggi per recuperare e analizzare i file pertinenti. Vedi Modalità agente.

L'agente Genie usa sempre le autorizzazioni dell'utente che pone la domanda. Un utente che non dispone almeno READ VOLUME dell'autorizzazione per un volume collegato riceve un errore. Gli utenti possono porre domande su un volume specifico, più volumi e dati strutturati nella stessa conversazione.

Requisiti

I requisiti seguenti si applicano all'agente e ai relativi utenti:

• Catalogo Unity abilitato nell'area di lavoro.
• Modalità Agente disponibile nella tua regione. Vedere Disponibilità a livello di area.
• Un agente Genie ben preparato con istruzioni chiare e metadati di tabella. Vedere Curare un agente Genie efficace.
• Uno o più volumi del catalogo Unity che contengono file pertinenti.
• Sia l'accesso all'area di lavoro sia le autorizzazioni di accesso a Databricks SQL per ciascun utente dell'agente. Gli utenti possono usare il resto di Genie senza accesso all'area di lavoro, ma questa funzionalità richiede entrambi. Si veda Gestione dei diritti di accesso.
• READ VOLUME Almeno l'autorizzazione per i volumi associati per ogni utente dell'agente.

Collega volumi a un Agent Genie

Prima di iniziare, esaminare i requisiti.

Per collegare volumi a un Genie Agent:

1. Aprire l'agente Genie a cui si desidera aggiungere file.
2. Aprire la scheda Origini , quindi fare clic su Aggiungi.
3. Selezionare uno o più volumi. L'agente Genie elabora l'intero volume. Non è possibile allegare un subset di cartelle o file in un volume.
4. Aggiungere una descrizione chiara nel campo Descrizione . Per domande su file, vedere Ottimizzare l'agente.
5. Opzionalmente, abilita la ricerca di contenuti per i volumi che hai allegato. Vedi Abilita la ricerca dei contenuti per i volumi allegati.

Abilita la ricerca di contenuti per i volumi allegati

Databricks consiglia di abilitare la ricerca di contenuti per i volumi che si allegano. La ricerca di contenuti prepara e indicizza i tuoi file in modo che l'Agente Genie possa usarli in modo più efficace, migliorando così la sua capacità di ragionare su un insieme più ampio di file e rispondere a domande con una latenza inferiore. Un volume indicizzato può contenere fino a 10.000 file di fino a 50 MB ciascuno. Vedi Ricerca Contenuti per i volumi del Catalogo Unity.

Ottimizza il tuo agente per le domande sui file

Dopo aver collegato i volumi, seguire questi consigli per aiutare l'agente Genie a usare il contenuto:

• Aggiungere una descrizione chiara: descrivere il contenuto che contiene il volume, come è organizzato e come deve essere usato dall'agente. L'agente usa questa descrizione per recuperare i file pertinenti.
• Evitare il contenuto duplicato: il collegamento di più volumi contenenti informazioni sovrapposte rende più difficile per l'agente recuperare i documenti pertinenti. Lo stesso vale per i singoli file all'interno di un volume.
• Evitare file irrilevanti: includere solo i file rilevanti per il dominio dell'agente. I file irrilevanti possono confondere l'agente.
• Usare nomi di file non crittografati: usare nomi di file descrittivi in modo che l'agente possa distinguere i file.

Porre domande sui file

Per porre domande sui file in un agente Genie:

1. Apri un Genie Agent a cui sono associati volumi.
2. Attivare la modalità agente nella casella di chat. È necessario usare la modalità Agent per rispondere alle domande sui file.
3. Immettere una domanda e inviare la richiesta. La modalità agente recupera il contesto dal volume pertinente e quindi genera una risposta al termine dell'analisi.

Limitazioni

Si applicano le limitazioni seguenti:

• È possibile collegare un massimo di 10 volumi a un agente Genie.
• Questa funzionalità non è disponibile in AWS GovCloud.
• Gli utenti che utilizzano solo Consumer, solo Databricks SQL o solo l'account non possono usare questa funzionalità. Ogni utente dell'agente deve disporre sia dell'accesso all'area di lavoro sia delle autorizzazioni di accesso a Databricks SQL.
• Nei volumi che non hanno la ricerca dei contenuti attivata, un Genie Agent può recuperare il contesto da un massimo di 5 file per domanda. Vedi Limitazioni per volumi senza ricerca di contenuti.
• L'agente Genie non può analizzare file esterni, ad esempio file in Google Drive o SharePoint.
• Gli strumenti di ricerca Web non sono disponibili.

Limitazioni per volumi senza ricerca di contenuto

Databricks consiglia di abilitare la ricerca di contenuti sui volumi che allegi. Se non abiliti la ricerca di contenuti per un volume allegato, un Genie Agent può recuperare il contesto da un massimo di 5 file per domanda. Inoltre, i seguenti limiti si applicano ai file che può leggere:

Il Genie Agent ignora i tipi di file non supportati e quelli che superano la dimensione massima del file. Continua a rispondere alle domande utilizzando gli altri file supportati nel volume.

Domande frequenti

Le domande seguenti illustrano gli argomenti comuni per l'analisi dei file nei volumi.

Come viene fatturata questa funzionalità?

La fatturazione dipende dal fatto che il volume allegato abbia la ricerca dei contenuti attivata. In entrambi i casi, l'agente ragiona sul contenuto recuperato, che viene annunciato come parte dell'uso standard di Genie. Consulta i prezzi di Genie.

• Volumi senza ricerca nel contenuto: Durante la Beta, agli utenti viene addebitato solo il ragionamento dell'agente sul contenuto recuperato.
• Volumi con ricerca di contenuti: L'agente interroga l'indice esistente invece di analizzare i file al momento della consulta, quindi non si applicano costi di Foundation Model Serving al recupero. Si applicano invece i costi di ingestione e di gestione delle query. Vedi come viene fatturata la ricerca di contenuti.

Quando è consigliabile usare questa funzionalità anziché un supervisore multi-agente?

Collegare volumi a un agente Genie quando si vuole che un agente risponda a domande su dati strutturati e non strutturati all'interno di un dominio specifico. Creare un agente supervisore personalizzato solo quando è necessario un controllo granulare sul comportamento dell'agente, ad esempio la selezione del modello, la strategia di suddivisione in blocchi o l'orchestrazione di più sotto-agenti.

Quando devo usare questa funzionalità invece di Genie One?

Collegare volumi a un agente Genie quando si vuole creare un agente specializzato che risponde alle domande in un dominio specifico. Usare Genie One come punto di ingresso unificato per tutte le domande sui dati strutturati. Genie One può chiamare un agente Genie per rispondere a domande sui file.

È possibile analizzare i file nei volumi tramite l'API?

Yes. È possibile analizzare i file nei volumi tramite le API in modalità agente. Consulta il riferimento API della modalità Agente.

Risorse aggiuntive

Per informazioni correlate, vedere le risorse seguenti:

• Concetti relativi agli agenti genie
• Creare e gestire un agente Genie
• Curare un agente Genie efficace
• Carica un file su un agente Genie
• Ricerca di contenuti per volumi del Catalogo Unity