Usare l'interprete di codice per generare ed eseguire codice Python

L'interprete del codice in Microsoft Copilot Studio e i prompt builder consentono agli autori di creare agenti di intelligenza artificiale che:

• Eseguire codice Python per l'analisi dei dati, l'elaborazione di file Word, Excel, PowerPoint e PDF e le visualizzazioni
• Utilizzare modelli linguistici per le risposte generative

Questa funzione è pensata per gli sviluppatori, gli analisti aziendali e i creatori di low-code. La generazione e l'esecuzione del codice si integrano perfettamente con l'ecosistema Copilot Studio per creare potenti soluzioni basate sull'intelligenza artificiale.

Gli sviluppatori devono leggere l'interprete del codice per gli sviluppatori ed esaminare l'esempio di componente Power Apps Component Framework (PCF) dell'interprete del codice per comprendere come usare il messaggio Dataverse Predict per richiamare richieste ed elaborare le risposte restituite.

Requisiti

• Licenze: Fatturazione e licenze di Microsoft Copilot Studio. 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.

Le funzionalità dell'interprete di codice in un colpo d'occhio

L'interprete di codice consente agli agenti di scrivere ed eseguire codice Python per attività avanzate. I casi d'uso includono:

• Elaborazione di file Excel: creare, copiare e aggiornare fogli di lavoro Excel in una cartella di lavoro, leggere StyleNames, applicare StyleNames, copiare la formattazione tra le celle, copiare e aggiornare le formule tra le celle e così via.
• Elaborazione di file Word e PowerPoint.
• Elaborazione di file PDF: Creare e copiare file PDF, leggere tabelle e paragrafi di testo.
• Elaborazione dei dati della tabella dataverse.
• Calcoli matematici e statistici complessi.
• Analisi, manipolazione e visualizzazione dei dati (ad esempio, grafici e diagrammi).

L'interprete di codice aggiunge le seguenti funzionalità ai prompt:

• Supporto per i file come tipo di output nelle richieste
• Supporto per i file Excel come tipi di input e output per richieste

È possibile creare richieste in due modi:

• Utilizzando l'opzione Costruisci il tuo prompt in AI Hub in Power Apps
• All'interno di uno strumento di richiesta aggiunto a un agente in Copilot Studio a livello di agente

Per altre informazioni sui prompt, vedere Panoramica dei prompt.

È anche possibile usare l'interprete del codice nella chat dell'agente in Copilot Studio.

Creare un nuovo prompt vuoto e attivare l'interprete del codice per il prompt

Prima di tutto, creare un nuovo prompt vuoto nell'hub di intelligenza artificiale o in Copilot Studio. Attivare quindi l'interprete del codice nelle impostazioni di richiesta.

Creare una richiesta nell'hub di intelligenza artificiale di Power Apps e attivare l'interprete del codice

È possibile creare una nuova richiesta vuota nell'hub di intelligenza artificiale in Power Apps e attivare l'interprete del codice nelle impostazioni del prompt. È possibile visualizzare esempi di come scrivere e configurare richieste che usano l'interprete del codice, vedere Usare l'interprete del codice negli esempi di richieste.

1. Vai a Power Apps.

2. Selezionare Hub di intelligenza artificiale nel riquadro sinistro.

3. Selezionare Prompts.

   

4. Seleziona Crea la tua richiesta.

   

5. Indicare il nome della richiesta.

6. Nella sezione Istruzioni selezionare ...>Impostazioni.

   

7. Nella pagina Impostazioni attivare l'interprete del codice.

8. Chiudere la pagina delle impostazioni per tornare all'editor dei prompt.

Viene creato un prompt vuoto con l'interprete del codice attivato. Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Creare un prompt come strumento all'interno di un agente e attivare l'interprete del codice

È possibile creare un nuovo prompt vuoto come strumento all'interno di un agente in Copilot Studio e attivare l'interprete del codice per tale richiesta. Più avanti in questo articolo viene illustrato come scrivere e configurare un prompt che usa l'interprete del codice.

1. In Copilot Studio passare all'agente in cui si vuole attivare l'interprete del codice.

2. Selezionare la scheda Strumenti, quindi selezionare Aggiungi uno strumento>Nuovo strumento>Prompt.

   

   L'interfaccia di creazione dei prompt del generatore di prompt incorporata si apre in Copilot Studio.

3. Seleziona ...>Impostazioni nella barra delle informazioni.

   

4. Nella pagina Impostazioni, seleziona Abilita interprete di codice.

5. Chiudere la pagina delle impostazioni per tornare all'editor dei prompt.

Viene creato un prompt vuoto con l'interprete del codice attivato. Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Usare l'interprete di codice negli esempi di prompt

Negli esempi seguenti viene illustrata la funzionalità dell'interprete di codice per la gestione di richieste complesse.

Gli esempi presuppongono che tu abbia già:

• Creato un nuovo prompt del generatore di prompt e attivato l'interprete del codice nelle impostazioni del prompt.

Scenario di esempio 1: richiesta dell'interprete del codice per controllare le transazioni

Il responsabile degli acquisti di Contoso verifica regolarmente le transazioni di acquisto. Ricevono un rapporto periodico in PDF che identifica i fornitori ad alto rischio e seguono una politica che richiede ordini di acquisto per le transazioni superiori a 10.000 dollari. Il responsabile degli acquisti utilizza il PDF per verificare le transazioni in Excel. Il responsabile degli acquisti utilizza i prompt con l'interprete di codice per automatizzare questo processo di audit.

Modificare e testare la richiesta di transazioni

Con l'editor del prompt aperto e l'interprete del codice è attivato, seguire questa procedura per creare il prompt:

1. Inserite le seguenti istruzioni per il prompt:

   1. You are given:
   -An Excel file <parameter A> with thousands of procurement transactions, including vendor name, invoice amount, PO number, and transaction date.
   -A PDF file <parameter B> listing vendors flagged as "High Risk" in the latest compliance audit.
   
   2. Your tasks:
   -Process the Excel file to identify:
   -Transactions over $10,000 with missing or blank PO numbers.
   -Extract vendor names from the PDF file that are marked "High Risk".
   -Cross-reference the vendor names in Excel with those from the PDF file.
   -Flag transactions that meet either of the following criteria:
     -High-value transaction with missing PO
     -Vendor is classified as High Risk
   -For each flagged transaction:
     -Highlight the row in red
     -Add a comment explaining the issue (for example, "High Risk Vendor" or "PO Missing")
   
   3. Generate a summary report listing:
   -Total flagged transactions
   -Vendor names involved
   -Reasons for flagging
   
   4. Return:
   -The updated Excel file with highlights and comments
   -A summary audit report formatted as PDF
   -A summary of updates made in text
   

2. Nelle istruzioni, sostituire <parameter A> con un parametro di input del file Excel contenente le transazioni di approvvigionamento. Per apportare la modifica, sostituire il testo con / e selezionare Immagine o documento dal menu di scelta rapida. Fornire un nome per questo parametro, ad esempio "transazioni di approvvigionamento", e caricare un file Excel di esempio con le transazioni nel formato previsto.

   Assicurarsi che l'ID della transazione, il nome del fornitore, l'importo della fattura, il numero dell'ordine e la data della transazione siano colonne nel file della transazione. È possibile usare un altro prompt con l'interprete del codice attivato per creare questo file di Excel di esempio in base alle esigenze.

3. Seguire la stessa procedura per sostituire il testo <parameter B> con un documento PDF di input caricato per il report di rischio fornitore. È possibile avere nomi fornitore come elenco nel file PDF. Anche in questo caso, è possibile usare un'altra richiesta con l'interprete del codice attivato per creare il file PDF di esempio in base alle esigenze.

4. Selezionare Verifica.

   In pochi secondi, si dovrebbe vedere l'output di riepilogo in testo come risposta del modello.

   Annotazioni

   È possibile lasciare il modello predefinito come GPT-4o o selezionarne un altro a seconda delle esigenze.

5. In Risposta al modello>Output, selezionare Documento per il formato della risposta al modello. La risposta del modello deve inoltre mostrare il file di Excel aggiornato con transazioni contrassegnate e il report di riepilogo in formato PDF. È possibile scaricare questi file per verificare i risultati.

   Importante

   Per eseguire il nuovo test con un file diverso, è necessario modificare il testo della richiesta e salvarlo. Caricare o scambiare il file di esempio senza modificare il prompt non produce rielaborazione.

In questo esempio viene illustrata la potenza dell'interprete del codice che consente di eseguire richieste di esecuzione di scenari complessi usando i file.

Scenario di esempio 2: richiesta dell'interprete del codice per creare un riepilogo visivo delle tabelle dataverse

In questo esempio viene illustrato come creare un prompt con interprete di codice attivato per leggere i record dalle tabelle di Dataverse, analizzare i dati e generare un riepilogo visivo (grafico) e un riepilogo del testo.

Modificare e testare il prompt di Dataverse

Con l'editor del prompt aperto e l'interprete del codice è attivato, seguire questa procedura per creare il prompt:

1. Inserite le seguenti istruzioni per il prompt:

   1. You are given:
   - Ticket data that gives the created date/time, first response date/time, and the first response SLA date/time:
   
   2. Your tasks:
   - Create a histogram of the tickets by day of the week created and show the first response SLA status
   - Create insights into trends in the data
   
   3. Return:
   - A graph. Make sure to return the graph as a base64 encoded image
   - A summary of insights
   

2. Ancorare il prompt collegando le tabelle pertinenti di Dataverse (ad esempio, biglietti, orari del personale).

Passaggi successivi con l'interprete del codice nelle richieste

Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Per esempi dettagliati su come usare l'interprete di codice nei prompt, vedere Esempi di prompt dell'interprete del codice.

Migliori pratiche per l'interprete di codice nei prompt

• Utilizza altri strumenti di intelligenza artificiale come Copilot per ottenere il prompt ottimizzato per l'avvio.
• Usare suggerimenti precisi con esempi (pochi colpi).
• Specificare gli output (ad esempio, "Restituisci come JSON" o "Excel" o "PDF").

Limitazioni

• L'analisi di più file caricati in un'unica richiesta non è supportata.
• La restituzione di più output di file in un singolo prompt non è supportata.
• Le domande su un file caricato su più turni non sono supportate.

Informazioni pertinenti

• Usa l'interprete del codice per analizzare dati strutturati
• Interprete di codice per sviluppatori
• Esempio di componente PCF dell'interprete del codice