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à:

• È stato creato un nuovo prompt di AI Builder 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).

   1. Usare / per aprire il menu input e delle conoscenze e selezionare Dataverse sotto Conoscenza.

      

   2. Seleziona una tabella e i campi necessari, come lo stato del ticket, l'agente assegnato e lo stato SLA per la richiesta.

   3. Selezionare Aggiungi per aggiungere i campi dalla tabella al prompt.

      

   4. Selezionare Attributo filtro, in base alle esigenze, per filtrare i dati della tabella in base a attributi e valori specifici.

      

3. Selezionare Test per eseguire il prompt.

4. Verificare che il prompt legge i dati del ticket, applica le regole di assegnazione e aggiorna i record in Dataverse come previsto.

   

5. Salvare il prompt.

Integrare il prompt in un flusso agente in Copilot Studio

Successivamente, è possibile creare un flusso dell'agente per eseguire il wrapping del prompt e connetterlo a Dataverse.

1. Tornare alla pagina Strumenti per l'agente e selezionare Aggiungi uno strumento>Nuovo strumento>Flusso agente.

   La finestra di progettazione flusso dell'agente appare con un trigger iniziale Quando un agente chiama il flusso.

2. Nella finestra di progettazione selezionare Inserisci>esegui una richiesta per aggiungere una nuova azione Esegui richiesta .

   

3. Nel nodo Esegui un prompt, seleziona il prompt dell'interprete del codice.

   Screenshot della selezione del prompt dell'interprete del codice nel nodo di esecuzione del prompt.

4. Nella finestra di progettazione selezionare Inserisci>rispondi all'agente per aggiungere una nuova azione Rispondi all'agente dopo l'azioneEsegui richiesta .

5. Aprire quindi Rispondi all'editor dei nodi dell'agente per selezionare i parametri da passare all'agente come output.

6. Usa Aggiungi un output per aggiungere il testo di riepilogo e i dati dell'immagine del grafico dalla richiesta come output per il flusso.

   Assegna un nome a uno degli output Summarye usa l'opzione valore dinamico per selezionare la Insights variabile di output dall'azione Esegui una richiesta .

   Denominare il secondo output GraphBase64e definire il valore di output usando l'opzione expression. Seleziona l'output dell'immagine Base64 dall'azione Esegui una richiesta.

   

7. Seleziona Salva bozza.

8. Nella scheda Panoramica , in Dettagli, assegnare un nome al flusso.

Pubblicare e usare l'agente

1. Salva e pubblica l'agente.

   L'agente può ora elaborare i record di Dataverse e generare un riepilogo e un grafico.

2. Vai alla pagina Strumenti dell'agente e seleziona il flusso specifico dell'agente che utilizza il prompt.

3. In Completamento impostare l'azione Dopo l'esecuzione su Invia una scheda adattiva (specificare di seguito).

4. In Scheda adattiva da visualizzare usando una formula di PowerFx selezionare Formula per definire la scheda usando una formula.

   Viene visualizzato l'editor di formule della scheda adattiva.

5. Definire il contenuto e l'origine per la scheda adattiva usando la formula seguente:

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.0",
     "body": [
       {
         "type": "Image",
         "url": "data:image/png;base64," & Topic.Output.GraphBase64,
         "altText": "Ticket analysis generated graph"
       },
       {
         "type": "TextBlock",
         "text": Topic.Output.Summary,
         "wrap": true
       }
     ]
   }
   

   Topic.Output.GraphBase64 Qui e Topic.Output.Summary sono le variabili di output definite in precedenza per il flusso dell'agente.

6. Salva l'agente e testalo.

7. Pubblicare l'agente in modo che altri utenti possano generare contenuto dinamico in base alle tabelle Dataverse.

Scenario di esempio 3: richiesta dell'interprete del codice per creare un grafico da un file di Excel fornito dall'utente

In questo esempio viene illustrato come creare un prompt con l'interprete di codice attivato per leggere un file di Excel caricato, convertire i dati in un'immagine del grafico e restituire l'immagine all'utente. Il prompt viene attivato da un argomento quando l'utente carica un file di Excel e richiede un grafico.

Creare e configurare il prompt di generazione del grafico

Con l'editor del prompt aperto e l'interprete del codice abilitato, seguire questa procedura per creare una richiesta:

1. Assegnare al prompt un nome significativo (ad esempio, prompt della generazione di immagini) e immettere le istruzioni seguenti per il prompt:

   Read the attached Excel (.xlsx) and convert it into a chart named mychart.png. 
   

2. Utilizzare / per aprire il menu input e il menu della conoscenza e selezionare Immagine o documento su Input.

3. Selezionare un file di Excel con dati di esempio da caricare come input del documento per i test.

4. Seleziona Salva.

5. Selezionare Aggiungi all'agente per aggiungere il prompt come strumento.

Creare un argomento che attivi il comando del grafico

1. Passare alla scheda Argomenti in Copilot Studio e creare un nuovo argomento selezionando Aggiungi un argomento>Da vuoto.

2. Nella nota Trigger imposta Descrivi cosa fa l'argomento su "Quando un file viene caricato e l'utente dice "Genera il mio grafico".

3. Seleziona Aggiungi nodo e quindi seleziona Gestione variabili>Gestione elenco>Esegui iterazione attraverso un elenco per aggiungere un nodo ciclo.

4. Selezionare il nodo Loop through a list per aprire l'editor di nodi. In Elementi da scorrere selezionare Seleziona variabile>System>Activity.Attachments.

   

5. All'interno del ciclo selezionare Aggiungi nodo, quindi selezionare Aggiungi uno strumento e selezionare il prompt creato in precedenza per aggiungere lo strumento prompt all'argomento.

6. Configurare le variabili di input e di output di conseguenza. Per l'input, imposta usando una formula su Topic.LoopValue1.Value e seleziona Inserisci. Per l'output, inizializza una variabile denominata Output per acquisire l'output del prompt.

   

7. All'interno del ciclo selezionare Aggiungi nodo>Crea un messaggio per aggiungere un nodo del messaggio. Il nodo del messaggio viene usato per trasmettere l'output del prompt all'utente. In questo esempio, il prompt inizializza la variabile Output con la risposta. Il testo viene archiviato in Output.text.

8. Nella parte di testo del messaggio selezionare Inserisci variabile e selezionare Output.text.

9. Selezionare Aggiungi>immagine per aggiungere un'immagine al messaggio.

   

10. Successivamente, formattare per visualizzare correttamente l'immagine. Seleziona Supporto e in URL immagine, seleziona Seleziona variabile>Formula e immetti la formula seguente:"data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Annotazioni

    Questo formato è necessario affinché la chat esegua correttamente il rendering dell'immagine. In questo esempio rappresenta mychart il nome selezionato per l'output del file nel prompt ed Output è il nome della variabile. I dettagli possono cambiare in altri esempi a seconda del modo in cui vengono denominate le variabili di output e argomento del prompt.

    

11. Seleziona Salva per salvare il tuo argomento.

12. Selezionare Verifica. Quando viene attivata la richiesta, verrà visualizzata un'immagine.

    

Altri esempi di richieste con l'interprete del codice

La tabella seguente fornisce altri esempi di richieste che possono essere usate con l'interprete del codice attivato. Questi esempi mostrano come richiedere all'interprete del codice di eseguire operazioni complesse.

Prompt	Risultato atteso
Creare un file PDF per acquisire i dettagli dell'ordine	Generare un modulo di acquisizione degli ordini in formato PDF
Crea una copia del file PDF <parametro A>	Creare una copia del file PDF fornito.
Creare un file Excel con un set di dati sintetici sulle transazioni di vendita	Creare un file Excel con un esempio di transazione di vendita. È possibile migliorare le prestazioni fornendo istruzioni più dettagliate nel prompt per ottenere dati sintetici generati più avanzati. L'esempio seguente mostra un prompt più complesso.
Creare un file di Excel con un set di dati sintetico realistico che simula le transazioni di vendita settimanali in quattro aree ("Nord", "Sud", "Est", "Ovest") per un anno di calendario completo. Ogni record deve includere: - Data della transazione (settimanale) - Regione - Nome del venditore (almeno tre nomi unici per regione) - Categoria di prodotto (ad esempio, "Elettronica", "Mobili", "Elettrodomestici", "Abbigliamento") - Nome del prodotto (nomi realistici in base alla categoria) - Unità vendute - Prezzo unitario (varia a seconda della categoria) - Importo totale della vendita (calcolato) - Obiettivo raggiunto (Sì/No, sulla base di una soglia regionale) - Trimestre - Canale (online, al dettaglio, distributore) - Segmento di clientela (ad esempio, "Enterprise", "SMB", "Consumer") Iniettare una variazione casuale e una stagionalità: - Aumento delle vendite di "Elettronica" nel 4° trimestre - Vendite più basse nel "Nord" durante gennaio-febbraio (simulazione del rallentamento invernale) - Aumento delle vendite di abbigliamento nel 2° trimestre (primavera) Il set di dati finale deve essere di almeno 2.000 righe. Aggiungete una leggera casualità per il realismo.	Questo prompt genera un file Excel con dati sintetici più ricchi di quelli precedenti. Questo prompt illustra l'efficacia dell'interprete di codice e come sia necessario fornire istruzioni chiare e dettagliate nel prompt.
Creare automaticamente un foglio di riepilogo - utilizzando il parametro A <> Generare: - Rollup mensili - Le regioni più performanti - Formattazione condizionale per chi non ha prestazioni adeguate	Eseguire l'analisi di un file Excel passando il file come input in questo prompt. Questo prompt crea il riepilogo in Excel, ma può anche essere salvato in un file PDF seguendo le istruzioni appropriate.
Evidenziare le celle in colore verde se le vendite > 1000 altrimenti, renderle rosse	Chiedete all'interprete del codice di eseguire la formattazione di Excel in base a condizioni e formule. La formattazione è espressa nel prompt come illustrato. È possibile applicare la stessa idea ad altri casi d'uso nella gestione della formattazione/stile di Excel.