Aggiungere la funzionalità dell'interprete del codice all'agente

Suggerimento

Consigliato: Inizia con Work IQ Dev Tools per scenari di agenti dichiarativi e plug-in pro-code supportati. Vedere la guida introduttiva di WIQD. Le istruzioni basate su toolkit rimangono disponibili per i progetti e i flussi di lavoro esistenti che le richiedono. Controlla il supporto per le funzionalità e l'esperienza di destinazione prima di scegliere uno strumento: WIQD non si rivolge agli agenti del motore personalizzato.

È possibile migliorare l'esperienza utente degli agenti dichiarativi per Microsoft 365 Copilot aggiungendo la funzionalità dell'interprete del codice. L'elemento capabilities nel riferimento al manifesto e la sezione Capabilities in Agent Builder forniscono diverse opzioni per sbloccare le funzionalità per gli utenti.

L'interprete di codice è uno strumento avanzato progettato per risolvere compiti complessi tramite codice Python. Utilizza il modello di ragionamento per scrivere ed eseguire codice, consentendo agli utenti di risolvere complessi problemi matematici, analizzare dati, generare visualizzazioni e altro ancora. Dopo l'esecuzione del codice, l'interprete del codice restituisce i risultati e il codice correlato generato. Può anche produrre immagini o file scaricabili in base allo scenario e accetta file come input per la modifica e l'analisi.

La funzionalità di interprete del codice è disponibile per gli utenti con una licenza di Microsoft 365 Copilot e utenti di Copilot Chat senza utilizzo a consumo abilitato.

Nota

Interprete del codice è abilitato per impostazione predefinita per gli agenti nel contesto. Per modificare questa impostazione, seleziona l'icona Impostazioni e aggiorna l'impostazione Interprete del codice in base alle esigenze, come illustrato nello screenshot seguente.

Abilitare l'interprete del codice in Microsoft 365 Agents Toolkit

Se si utilizza Agents Toolkit e Visual Studio Code per creare l'agente e si desidera abilitare l'interprete del codice, aggiungere il CodeInterpreter valore alla proprietà capabilities nel file manifest, come illustrato nell'esempio seguente.

Nota

Per aggiungere la CodeInterpreter funzionalità, è necessario usare la versione 1.2 o successiva dello schema del manifesto dell'agente dichiarativo.

{
  "capabilities": [
    {
      "name": "CodeInterpreter"
    }
  ]
}

Abilitare l'interprete del codice in Generatore di agenti

L'interprete del codice è sempre abilitato in Generatore di agenti. Questa funzionalità viene automaticamente inclusa per tutti gli agenti.

Esempi di funzionalità dell'interprete del codice

La funzionalità dell'interprete del codice usa il modello di ragionamento per consentire agli agenti dichiarativi di scrivere ed eseguire codice Python in un ambiente in modalità sandbox. Questa funzionalità consente agli utenti di risolvere problemi matematici complessi, analizzare dati, generare visualizzazioni e altro ancora. Dopo l'esecuzione del codice, l'interprete del codice restituisce i risultati e il codice generato. Può anche produrre immagini scaricabili e altri file in base allo scenario e accetta file come input per la modifica e l'analisi.

L'interprete del codice fornisce funzionalità per:

Copilot può anche fornire versioni copiabili e scaricabili del codice generato durante l'esecuzione di queste attività.

Creare grafici e diagrammi

Gli utenti possono utilizzare agenti con interprete di codice abilitato per creare grafici e diagrammi. Ad esempio, in risposta al prompt Rappresentare graficamente i primi 20 numeri in una sequenza di Fibonacci, Copilot produce il grafico a linee seguente.

Screenshot di un grafico a linee che mostra i primi 20 numeri di una sequenza di Fibonacci.

Quando l'utente seleziona il </> Code pulsante, l'agente fornisce il codice Python corrispondente.

Screenshot del codice Python per rappresentare graficamente i primi 20 numeri di una sequenza di Fibonacci.

Gli utenti possono anche caricare file di dati per generare grafici e diagrammi in modo da poter visualizzare i propri dati. I formati di file supportati sono Word, Excel, PowerPoint, PDF, CSV/TSV e TXT/UTF8. Ad esempio, un utente può caricare un file di Excel con i dati di vendita e immettere la richiesta: Creare un grafico a barre e un grafico a linee dei dati di vendita caricati. L'agente restituisce la risposta seguente.

Grafico a barre di dati di vendita di esempio

Grafico a linee dei dati di vendita di esempio

Creare codici QR e visualizzazioni dei dati

Con l'interprete del codice abilitato, gli utenti possono creare una varietà di visualizzazioni dei dati come codici QR e nuvole di parole. Ad esempio, in risposta alla richiesta dell'utente Crea un codice QR per il sito Web aziendale di Microsoft, l'agente presenta sia l'URL corrispondente che il codice QR corrispondente.

Codice QR per Microsoft generato da Copilot

Per una nuvola di parole, il prompt Crea una nuvola di parole con i nomi principali degli animali domestici genera un'immagine che include i nomi più comuni, come illustrato nell'esempio seguente.

Risposta di Word Cloud al prompt dell'utente

Creare dati sintetici

Quando un utente ha bisogno di dati di esempio con cui lavorare, integrando l'interprete del codice gli si consente di creare dati sintetici per una varietà di scopi. L'agente può generare i dati di esempio richiesti e quindi visualizzarli come file di Word, Excel, PowerPoint o PDF. Gli utenti possono scaricare i file generati direttamente dalla risposta dell'agente. Di seguito sono riportati prompt e risposte di esempio.

Suggerimento:Crea una tabella di 10 transazioni finanziarie false, tra cui data, importo, commerciante e categoria.

Tabella delle transazioni finanziarie sintetiche.

Prompt:Genera 20 trascrizioni sintetiche delle chat dell'assistenza clienti sui problemi di fatturazione.

Tabella di chat sintetiche dell'assistenza clienti.

Risolvere problemi matematici complessi

Quando si aggiunge un interprete di codice all'agente, gli utenti possono chiedere all'agente di risolvere problemi matematici complessi, come illustrato nell'esempio seguente.

Prompt:Fornire l'integrale dell'area sotto la curva per la funzione ( f(x) = x^3 - 4x^2 + 6x - 2 ) da ( x = 0 ) a ( x = 3 ).

Calcolo integrale per l'area sotto una curva.

Modificare le immagini caricate

L'integrazione dell'interprete di codice consente inoltre agli utenti di modificare le immagini caricate. Gli agenti con questa funzionalità possono aggiungere banner e didascalie alle immagini e generare versioni in bianco e nero di immagini a colori. (L'immagine seguente è stata generata da Copilot.)

Immagine generata da Copilot di un'auto Bentley 4 del 1934.

Per modificare l'immagine, l'utente può immettere il messaggio Dammi una versione in bianco e nero dell'immagine allegata. Aggiungi uno striscione con la scritta "1934 Bentley 4" e una didascalia con il testo "Immagine generata da Copilot". L'agente fornisce il risultato seguente.

Immagine in bianco e nero di un'auto Bentley 4 del 1934, modificata da Copilot.

Generare file scaricabili

L'interprete del codice può generare e ospitare file scaricabili, consentendo all'agente di scaricare i file generati dall'agente. Quando l'interprete del codice produce file di output (ad esempio immagini, grafici, fogli di calcolo o documenti), Copilot presenta automaticamente un collegamento per il download nella risposta. Gli utenti possono selezionare il collegamento per salvare il file in locale.

Questa funzionalità è utile in molti scenari, ad esempio:

  • Esportazioni di dati: genera un foglio di calcolo Excel di dati calcolati o risultati di analisi e offrilo come download.
  • Report: crea un documento PDF o Word formattato che riepiloga i risultati e rendilo disponibile per il download.
  • Immagini generate: crea un grafico, un codice QR o una nuvola di parole come file immagine scaricabile.
  • File elaborati: applica modifiche a un'immagine o a un documento caricato e restituisci il risultato come file scaricabile.

Il prompt seguente attiva la generazione di file e la creazione automatica di collegamenti per il download.

Prompt:Crea un foglio di calcolo con una tabella di moltiplicazione per i numeri da 1 a 10 e dammi il file Excel.

L'agente genera il file di Excel e presenta un collegamento per il download nella risposta.

Nota

I file generati dall'interprete del codice sono ospitati temporaneamente e sono disponibili per il download solo durante la sessione attiva. Files non vengono mantenuti al termine della sessione.