Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo articolo è una documentazione preliminare soggetta a modifiche].
Usando l'interprete del codice, gli agenti di Copilot Studio possono generare ed eseguire codice Python quando devono rispondere alle richieste degli utenti. L'interprete del codice supporta attività come l'analisi statistica, i join di tabelle, la previsione e la generazione di grafici. Questi compiti lavorano con file strutturati come CSV ed Excel.
Importante
Questo articolo contiene Microsoft Copilot Studio documentazione di anteprima ed è soggetto a modifiche.
Le funzionalità di anteprima non sono progettate per l'uso in produzione e possono avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che sia possibile ottenere l'accesso iniziale e inviare commenti.
Se stai creando un agente destinato alla produzione, vedi Panoramica di Microsoft Copilot Studio.
La proposta di valore dell'uso dell'interprete di codice per analizzare i file di dati strutturati è:
- Usando calcoli deterministici e riproducibili, è possibile sbloccare l'analisi affidabile all'interno degli agenti invece di basarsi sulle funzionalità matematiche e inferenze intrinseche del modello linguistico di grandi dimensioni per rispondere alle domande analitiche.
- Abbassare la barriera delle competenze per l'analisi avanzata permettendo agli utenti di porre domande analitiche in linguaggio naturale.
- Genera tabelle e visualizzazioni dei risultati in modo programmatico che gli utenti possano vedere, scaricare e riutilizzare.
Copilot Agenti di Studio possono usare l'interprete del codice per analizzare i file strutturati forniti all'agente nei due modi seguenti:
- Come utente finale, quando si caricano file strutturati durante la chat con l'agente.
- In qualità di autore, quando aggiungi la raccolta Documenti di SharePoint come origine della Knowledge Base, che a sua volta contiene i file strutturati.
Requisiti
Licensing: Microsoft Copilot Studio fatturazione e licenze. Generazione del codice e conteggio delle esecuzioni come funzionalità di strumenti di intelligenza artificiale generativi (Premium).
Aree supportate: disponibile per tutti i cloud pubblici. I cloud sovrani non sono attualmente supportati.
Scenari ampiamente testati
Microsoft ha testato ampiamente gli scenari seguenti con un elevato livello di attendibilità.
Annotazioni
- Se lo scenario non è tra gli scenari elencati nelle tabelle, potrebbe comunque funzionare. Gli scenari elencati nelle tabelle seguenti riflettono il gruppo di scenari testati ampiamente da Microsoft in base all'uso previsto dei clienti.
- Il limite di dimensioni per ogni file che può essere analizzato dall'interprete del codice, indipendentemente dal tipo di file, è di 16 MB. È possibile caricare un massimo di 10 file.
Scenari per i file di Excel (.xlsx)
| Categoria | Descrizione dello scenario | Esempio 1 | Esempio 2 | Esempio 3 |
|---|---|---|---|---|
| Ricerca - foglio singolo | Recuperare un valore, un'etichetta o un record specifico da un singolo foglio di un file di Excel. Non è necessario alcun calcolo tra righe. La risposta è ottenuta tramite una ricerca diretta delle celle/righe. Include valori numerici, attributi di testo (nomi, ruoli, categorie) e marcature temporali. | Quali partite includono una rete laterale di almeno tre gol? | Qual era il flusso di cassa libero nel Q4 2024? | Quale segmento appartiene ai combustibili all'ingrosso a partire dal Q1 2024? |
Scenari per i file di .csv
| Categoria | Descrizione dello scenario | Esempio 1 | Esempio 2 | Esempio 3 |
|---|---|---|---|---|
| Ricerca - singolo file | Recuperare un valore, un attributo o un record specifico da un singolo file CSV. Sono coperti lookup di entità (contatti, aeroporti, progetti eolici), il recupero dei valori in un dato momento e i lookup di tabelle di piccole dimensioni. Nessuna aggregazione tra righe richiesta. | Chi è lo sviluppatore del progetto Sunrise Wind? | Quante moto sono state registrate nel Tennessee nel 1970? | Chi possiede l'aeroporto Horsehoe Landings a Keenesburg, CO? |
| Aggregazione - file unico | Calcola i totali, i conteggi, le differenze, i riepiloghi per raggruppamento o le ricerche classificate all'interno di un singolo file CSV. Sono trattate le aggregazioni finanziarie, i conteggi condizionali, i recuperi classificati (max/min) e i riepiloghi a livello di gruppo presentati sotto forma di numeri, testo o tabelle. | Qual è stato il valore totale delle royalties delle vendite di petrolio onshore nel 2019? | Quanti più camion sono stati registrati in California nel 2020 rispetto al 2010? | Qual è il fatturato totale delle vendite generato da ogni area nel gennaio 2025? |
| Ricerca - più file | Unire o fare riferimento incrociato a più file CSV per recuperare un valore o un elenco specifico ( ad esempio, cercando l'inventario associando nomi di parti in un elenco di parti, inventario e listino prezzi; oppure eseguendo query sui dati sulle emissioni aggiungendo nomi di settore a un file di emissioni principale). | Quanti frese a getto d'acqua sono disponibili nel magazzino orientale? | Qual è il prezzo didattico di un tornio 10x24? | Quanti bit di drill da 3/8" sono in magazzino nel magazzino orientale? |
| Aggregazione - più file | Aggregare o confrontare i dati distribuiti tra più file CSV (ad esempio, sommando le ore dei dipendenti nei CSV mensili per un totale trimestrale, conteggiando le trattative nei file CSV esportati annualmente, o classificando i settori in base alle emissioni nei file aggregati). | Quante ore lavorative totali sono state registrate in Q3? | Qual è stato l’orario più mattiniero in cui Chris ha timbrato l’ingresso durante il mese di luglio? | Quale settore ha prodotto il maggior numero di CO2 nel 2020? |
Usa l'interprete di codice per l'analisi di un file di dati strutturati caricati dall'utente
In Copilot Studio selezionare Settings>Generative AI. In Funzionalità di elaborazione file attivare l'interruttore Caricamenti file .
Sotto Capacità di elaborazione file, attiva il toggle dell'interprete di codice .
Seleziona Salva.
Nel riquadro di test scrivere una query che richiede all'agente di eseguire un calcolo usando i dati di un file di dati strutturato. Allegare il file di dati al prompt.
Usare l'interprete del codice per l'analisi di un file di dati strutturato come origine della knowledge base di SharePoint
Se l'agente non dispone già di un file di dati strutturato SharePoint come origine della knowledge base, aggiungere questo file SharePoint come origine della knowledge base.
In Copilot Studio selezionare Settings>Generative AI. Sotto Capacità di elaborazione file, attiva il toggle dell'interprete di codice .
Sotto Ricerca, attiva l'interruttore Integrazione del grafo tenant con ricerca semantica.
Seleziona Salva.
Se hai aggiunto un file SharePoint seguendo le istruzioni nel primo passaggio, pubblica il tuo agente.
Testare l'agente fornendo una query che richiede all'agente di eseguire un calcolo per rispondere.