Carica un file su un Agente Genie

Importante

Il caricamento di file CSV e Excel si trova in Public Preview. Il caricamento di file PDF è in versione beta.

Caricare file CSV, Excel e PDF direttamente in un agente Genie in modo che gli utenti possano eseguire query in linguaggio naturale insieme alle tabelle del catalogo Unity. Ciò è utile per la convalida rapida dei dati, l'analisi leggera e l'uso di set di dati esterni senza importazione o trasformazione manuale.

Note

Gli agenti genie erano in precedenza noti come Genie Spaces.

Overview

Il caricamento di file in un agente Genie consente di esplorare i dati in una conversazione dell'agente Genie. È possibile aggiungere file agli agenti che includono anche tabelle di Catalogo Unity, consentendo di analizzare i dati caricati insieme alle origini esistenti. Invece di importare e trasformare manualmente i set di dati, è possibile trascinare e rilasciare un file nella chat e iniziare subito a eseguire query. Ciò è utile per la convalida rapida dei dati, l'analisi leggera e l'uso di set di dati esterni senza alcuna configurazione aggiuntiva.

Per consentire a un agente di rispondere alle domande sui file non strutturati archiviati nei volumi di Catalogo Unity anziché caricare un file in una singola conversazione, vedere Analizzare i file nei volumi con un agente Genie.

Requisiti

  • Gli agenti Genie devono essere abilitati nell'area di lavoro. Vedere Creare e gestire un agente Genie.
  • L'impostazione Carica dati usando l'impostazione di amministratore dell'area di lavoro dell'interfaccia utente deve essere abilitata. Vedere Disabilitare l'interfaccia utente dei dati di caricamento.
  • Un amministratore dell'area di lavoro deve abilitare l'anteprima dalla pagina delle anteprime . Usare l'interruttore Genie - Upload File (Genie - Carica file ) per gestire l'accesso.
  • Per caricare i file PDF (Beta), un amministratore dell'area di lavoro deve abilitare l'interruttore Carica PDF locali negli agenti Genie nella pagina Anteprime. Si applicano i requisiti aggiuntivi seguenti:
    • Le funzionalità di intelligenza artificiale alimentate da partner devono essere abilitate. Consulta Funzionalità di AI supportate da partner.
    • I caricamenti PDF non sono supportati nelle aree di lavoro dei profili di sicurezza di conformità.
  • Almeno le autorizzazioni CAN RUN per l'agente Genie. Vedi ACL di Genie Agent.

Requisiti dei file

È possibile caricare fino a 25 file per conversazione, indipendentemente dal tipo di file.

File CSV e Excel

I caricamenti csv e Excel non sono disponibili in modalità agente.

  • Ogni file deve essere inferiore a 200 MB.
  • Ogni file deve contenere meno di 100 colonne.
  • I file di Excel possono contenere più fogli. Genie visualizza i dati di esempio del primo foglio per impostazione predefinita, ma sono disponibili tutti i fogli che possono essere analizzati. Per eseguire una query su un foglio specifico, riferisciti ad esso per nome quando chiedi a Genie.

File PDF

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

I caricamenti PDF richiedono la modalità agente.

  • Ogni PDF deve essere inferiore a 20 MB.
  • Ogni PDF deve contenere non più di 20 pagine.
  • Ogni PDF è limitato a 15.000 caratteri.
  • I PDF caricati si applicano solo alla conversazione corrente. I nuovi thread di chat non includono il contesto dei PDF caricati in precedenza.
  • I caricamenti PDF sono disponibili solo tramite l'interfaccia utente. I caricamenti di file basati su API non sono supportati.

Caricare un file

Solo l'utente che ha caricato il file può accedervi.

Caricare i file in uno dei modi seguenti:

  • Trascinare e rilasciare il file nella finestra di chat.
  • Fare clic sull'icona Paperclip. Per selezionare un file dal browser file.

Un agente Genie mostra l'icona della graffetta.

Caricare un file non invia più un messaggio automaticamente. Puoi aggiungere un prompt da inviare insieme al file, oppure caricare il file e poi fare domande a riguardo. Dopo il caricamento e l'elaborazione del file, Genie visualizza i dati nella risposta. È possibile porre domande sul file caricato e su qualsiasi altro dato nell'agente Genie.

Note

I file caricati vengono archiviati in un volume gestito del catalogo Unity specifico dell'utente e dell'agente. Il volume non è elencabile e non viene visualizzato nel navigatore dello schema. Le autorizzazioni per i file caricati non devono essere gestite manualmente. Agli utenti vengono concessi automaticamente i privilegi USE CATALOG, USE SCHEMA, READ VOLUME e WRITE VOLUME nei file caricati.

Azure Databricks memorizza i file caricati nello storage root gestito dal cliente sugli workspace classici e nello storage predefinito nei workspace serverless.

Per altre informazioni sui volumi gestiti, vedere Che cosa sono i volumi del catalogo Unity?.

Visualizzare i file disponibili

Per visualizzare i file caricati nell'agente, fare clic sull'icona Paperclip. Per aprire il menu file. Se un file di Excel caricato include più fogli, vengono visualizzati come file separati nel menu.

Modificare le impostazioni del formato di file

Per modificare le impostazioni di formattazione applicate a un file:

  1. Fare clic sull'icona Paperclip. Per aprire il menu file.
  2. Fare clic sull'icona Wrench. L'icona a forma di chiave a destra del file.
  3. Modificare le impostazioni nella finestra di dialogo Impostazioni formato file .
  4. Fare clic su Applica modifiche per visualizzare in anteprima le modifiche.
  5. Fare clic su Salva per mantenere le modifiche e chiudere la finestra di dialogo.

Rimuovere un file

I file caricati su un Agente Genie non hanno un periodo fisso di conservazione. Rimangono disponibili fino a quando non avviene una delle seguenti cose:

  • L'utente rimuove il file cliccando sull'icona Cestino. L'icona del cestino accanto al file nel menu file allegati.
  • La conversazione viene cancellata.
  • L'Agente Genio viene eliminato. I file vengono rimossi automaticamente dallo storage gestito quando l'agente viene eliminato.

Elenco di file espanso che mostra un'icona del cestino a destra di un nome file.

Disabilitare i caricamenti di file

Un amministratore dell'area di lavoro può impedire la possibilità di caricare file in un agente Genie. A tale scopo, disattivare Carica dati usando l'interfaccia utente. Vedere Disabilitare l'interfaccia utente dei dati di caricamento.

FAQ

Chi può accedere ai file caricati?

Solo l'utente che ha caricato il file può accedervi.

Quali dati vengono inviati all'LLM?

Un subset dei dati dei file caricati viene inviato al modello esterno e usato per migliorare la qualità della risposta e analizzare correttamente i file.

Perché non è possibile caricare un file?

Se non si dispone almeno delle autorizzazioni CAN RUN per l'agente Genie, l'opzione di caricamento non è disponibile. L'amministratore dell'area di lavoro potrebbe anche aver disattivato l'impostazione Carica dati usando l'area di lavoro dell'interfaccia utente o disabilitata l'anteprima genie - Carica file per l'area di lavoro. Vedere Disabilitare l'interfaccia utente dei dati di caricamento.