Bruk kodetolk i eksempler på instruksjoner

Følgende eksempler viser funksjonaliteten til kodetolk for håndtering av kompliserte instruksjoner.

Eksemplene antar at du startet en ny prompt og slo på kodetolk i prompt-innstillingene.

Eksempel på scenario 1: kodetolker-prompt for å revidere transaksjoner

Innkjøpssjefen hos Contoso overvåker regelmessig kjøpstransaksjoner. De mottar en periodisk PDF-rapport som identifiserer leverandører med høy risiko, og følger en policy som krever innkjøpsordrer for transaksjoner på over 10 000 dollar. Innkjøpssjefen bruker PDF-filen til å overvåke transaksjonene i Excel. Innkjøpssjefen bruker instruksjoner med kodetolk til å automatisere denne revisjonsprosessen.

Rediger og test transaksjoner-instruksen

Når redigeringsprogrammet for instruksjoner er åpent og kodetolk er slått på, følger du denne fremgangsmåten for å opprette instruksjonen:

1. Skriv inn følgende instruksjoner for instruksjonen:

   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. I instruksjonene erstatter du <parameter A> med en filinndataparameter for Excel-filen som inneholder innkjøpstransaksjoner. Hvis du vil gjøre endringen, erstatter du teksten med / og velger Bilde eller dokument fra hurtigmenyen. Angi et navn for denne parameteren, for eksempel «innkjøpstransaksjoner», og last opp en eksempelfil i Excel med transaksjoner som bruker det forventede formatet.

   Pass på at du har transaksjons-ID, leverandørnavn, fakturabeløp, bestillingsnummer og transaksjonsdato som kolonner i transaksjonsfilen. Du kan bruke en annen instruksjon med kodetolk slått på for å opprette denne Excel-eksempelfilen etter behov.

3. Følg den samme fremgangsmåten for å erstatte teksten <parameter B> i instruksjonene med en opplastet PDF-dokumentfil for leverandørrisikorapporten. Du kan ha leverandørnavn som en liste i PDF-filen. Du kan igjen bruke en annen instruksjon med kodetolk slått på for å opprette PDF-eksempelfilen etter behov.

4. Velg Test.

   Om noen sekunder skal du se sammendragsutdataene i tekst som modellsvaret.

   Notat

   Du kan bruke standardmodellen som GPT-4o eller velge andre etter behov.

5. Under Modellsvar>Utdata velger du Dokument for modellsvarformatet. Modellsvaret skal også vise den oppdaterte Excel-filen med rapporterte transaksjoner og sammendragsrapporten i PDF-format. Du kan laste ned disse filene for å bekrefte resultatene.

6. For å teste på nytt med forskjellige inndatafiler, last opp nye prøvefiler i instruksjonene og velg Test uten å regenerere.

   

Dette eksemplet illustrerer kraften i kodetolk, slik at instruksjoner kan utføre kompliserte scenarioer ved hjelp av filer.

Eksempelscenario 2: spørsmål for kodetolkeren for å lage et visuelt sammendrag av Dataverse-tabeller

Dette eksempelet viser hvordan man lager en prompt med kodetolk aktivert for å lese poster fra Dataverse-tabeller, analysere dataene og generere et visuelt sammendrag (diagram) og et tekstsammendrag.

Rediger og test Dataverse-spørsmålet

Når redigeringsprogrammet for instruksjoner er åpent og kodetolk er slått på, følger du denne fremgangsmåten for å opprette instruksjonen:

1. Skriv inn følgende instruksjoner for instruksjonen:

   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. Forankre spørsmålet ved å opprette en kobling til relevante Dataverse-tabeller (f.eks. saker, personalplaner).

   1. Bruk / for å åpne menyen for inndata og kunnskap og velg Dataverse under Kunnskap.

      

   2. Velg en tabell og velg nødvendige felter (f.eks., saksstatus, tildelt agent, SLA-status) som skal brukes i spørsmålet.

   3. Velg Legg til for å legge til feltene fra tabellen i spørsmålet.

      

   4. Velg Filter-attributt, etter behov, for å filtrere tabellens data basert på spesifikke attributter og verdier.

      

3. Velg Test for å kjøre instruksen.

4. Verifiser at spørsmålet leser sakdata, anvender tildelingsregel og oppdaterer poster i Dataverse som forventet.

   

5. Lagre spørsmålet.

Integrer spørsmålet i en agentflyt i Copilot Studio

Deretter kan du opprette en agentflyt for å integrere spørsmålet og koble den til Dataverse.

1. Gå tilbake til verktøysiden for agenten og velg Legg til verktøy>, Nytt verktøy>, Agentflyt.

   Agentflytutformingen vises med en innledende Når en agent kaller opp flyten-utløser.

2. I designeren velger du Sett inn>Kjør en prompt for å legge til en ny Kjør en instruks-handling.

   

3. I Kjør en instruks-noden velger du kodetolker-instruksen din.

   

4. I designeren, velg Sett inn>Svar til agenten for å legge til en ny Svar til agenten-handling etter Kjør en instruks-handling.

5. Deretter åpner du nodeeditoren Svar til agenten for å velge parametere som skal sendes tilbake til agenten som utganger.

6. Bruk Legg til en utgang for å legge til sammendragsteksten og grafbilde-dataene fra instruksen som utgang i flyten.

   Navngi en av utgangene Summary, og bruk dynamisk verdi-alternativet for å velge Insights-utgangsvariabelen fra Kjør en instruks-handling.

   Gi det andre utdataen navnet GraphBase64, og definer utdataverdien ved å bruke uttrykk-alternativet. Velg Base64-bildefilutdataen fra Kjør en instruks-handlingen.

   

7. Velg Lagre utkast.

8. På Oversikt-fanen, under Detaljer, navngi flyten.

Publiser og bruk agenten

1. Lagre og publiser agenten.

   Agenten kan nå behandle Dataverse-poster og generere et sammendrag og et diagram.

2. Gå til siden for agentverktøyene og velg den spesifikke agentflyten som bruker instruksen.

3. Under Fullføring, sett handlingen etter kjøring til Send et dynamisk kort (spesifiser nedenfor).

4. Under dynamisk kort som vises med en Power Fx-formel, velg Formel for å definere kortet med en formel.

   Formelredigereren for dynamisk kort vises.

5. Definer innhold og kilde for det dynamiske kortet ved hjelp av følgende formel:

   {
     "$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
       }
     ]
   }
   

   Her er Topic.Output.GraphBase64 og Topic.Output.Summary, som er utgangsvariablene definert tidligere for agentflyten.

6. Lagre agenten og teste den.

7. Publiser agenten din slik at andre brukere kan generere dynamisk innhold basert på Dataverse-tabeller.

Eksempelscenario 3: kodetolker-spørsmål for å lage et diagram fra en brukerlevert Excel-fil

Dette eksempelet viser hvordan du kan opprette et spørsmål med kodetolk aktivert for å lese en opplastet Excel-fil, konvertere dataene til et diagrambilde og returnere bildet til brukeren. Spørsmålet utløses fra et emne når brukeren laster opp en Excel-fil og ber om et diagram.

Opprett og konfigurer spørsmålet for grafgenerering

Når redigeringsprogrammet for instruksjoner er åpent og kodetolk er aktivert, følger du denne fremgangsmåten for å opprette instruksjonen:

1. Gi spørsmålet et meningsfullt navn (f.eks. Image gen prompt), og angi følgende instruksjoner for spørsmålet:

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

2. Bruk / for å åpne input- og kunnskapsmenyen og velg Bilde eller dokument under Input.

3. Velg en Excel-fil med eksempeldata som skal lastes opp som inputdokument for testformål.

4. Velg Lagre.

5. Velg Legg til i agent for å legge til prompten som et verktøy.

Lag et tema som kaller diagraminstruksen

1. Gå til Emner-fanen i Copilot Studio og opprett et nytt emne ved å velge Legg til et emne>Fra blank.

2. Under Utløser-notatet, sett Beskriv hva temaet gjør til "Når en fil lastes opp og brukeren sier 'generer mitt horoskop.'"

3. Velg Legg til node, og velg deretter Variabelhåndtering>Listehåndtering>Loop gjennom en liste for å legge til en løkke-node.

4. Velg Loop gjennom en liste-node for å åpne node-editoren. Under Elementer som skal løkkes over velger du Velg variabel>System>Aktivitet.Vedlegg.

   

5. I løkken, velg Legg til node, og deretter velg Legg til et verktøy og velg instruksen du opprettet tidligere for å legge instruksverktøyet til emnet.

6. Konfigurer inn- og utgangsvariabler tilsvarende. For inndata, sett med en formel til Topic.LoopValue1.Value og velg sett inn. For utdata, initialiser en variabel med navnet Output for å lagre resultatet fra instruksen.

   

7. I løkken, velg Legg til node>Opprett en melding for å legge til en meldingsnode. Meldingsnoden brukes til å formidle spørsmålets utdata tilbake til brukeren. I dette eksempelet initialiserer spørsmålet variabelen Output med svaret. Teksten lagres i Output.text.

8. I tekstdelen av meldingen, velg Sett inn variabel og velg Output.text.

9. Velg Legg til>Bilde for å legge til et bilde i meldingen.

   

10. Deretter, formater for å vise bildet korrekt. Velg Media og under Bilde-nettadresse, velg Velg variabel>Formel, og skriv inn følgende formel: "data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Notat

    Dette formatet er nødvendig for at nettpraten skal gjengi bildet korrekt. I dette eksempelet representerer mychart navnet vi valgte for filutdataen i spørsmålet vårt, og Output er variabelnavnet. Detaljene kan endres i andre eksempler avhengig av hvordan instruksresultatet og emnevariabler er navngitt.

    

11. Velg Lagre for å lagre emnet.

12. Velg Test. Du skal se et bilde vist når instruksen utløses.

    

Flere eksempler på instruksjoner ved hjelp av kodetolk

Tabellen nedenfor inneholder flere eksempler på instruksjoner som kan brukes med kodetolk slått på. Disse eksemplene viser hvordan du ber kodetolk om å utføre kompliserte oppgaver.