Kooditulkin käyttäminen kehotteiden esimerkeissä

Seuraavissa esimerkeissä esitellään kooditulkin toimintaa monimutkaisten kehotteiden käsittelyssä.

Esimerkeissä oletetaan jo:

• Uusi AI Builder -kehote luotiin ja kooditulkin ottaminen käyttöön kehoteasetuksissa.

Esimerkkiskenaario 1: koodin tulkkauskehote tapahtumien valvontaan

Contoson ostopäällikkö seuraa ostotapahtumia säännöllisesti. He saavat kausittaisen PDF-raportin, jossa määritetään suuren riskin toimittajat, ja noudattavat käytäntöä, joka edellyttää yli 10 000 dollarin tapahtumien ostotilauksia. Ostopäällikkö käyttää PDF-tiedostoa Excelin tapahtumien valvontaan. Ostopäällikkö automatisoi tämän valvontaprosessin käyttämällä kooditulkin kehotteita.

Tapahtumakehotteen muokkaaminen ja testaaminen

Kun kehoteeditori on auki ja kooditulkkaus on käytössä, luo kehote noudattamalla seuraavia ohjeita:

1. Kirjoita kehotteeseen seuraavat ohjeet

   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. Korvaa ohjeissa <parameter A> hankintatapahtumia sisältävän Excel-tiedoston syöteparametrilla. Jos haluat tehdä muutoksen, korvaa teksti tekstillä / ja valitse pikavalikosta Kuva tai asiakirja . Anna tälle parametrille nimi, kuten "hankintatapahtumat", ja lataa Excel-mallitiedosto, joka sisältää tapahtumia odotetussa muodossa.

   Varmista, että tapahtumatunnus, toimittajan nimi, laskun summa, tilausnumero ja tapahtumapäivämäärä ovat tapahtumatiedoston sarakkeina. Voit luoda tämän Excel-mallitiedoston tarvittaessa toisen kehotteen avulla kooditulkin ollessa käytössä.

3. Noudata samoja vaiheita korvataksesi tekstin <parameter B> toimittajan riskiraportille ladatulla syötteen PDF-asiakirjalla. Voit määrittää toimittajien nimet PDF-tiedoston luettelona. Voit luoda PDF-mallitiedoston tarpeen mukaan käyttämällä toista kehotetta, jossa koodin tulkki on käytössä.

4. Valitse Testaa.

   Yhteenvetotulosteen pitäisi näkyä tekstissä muutaman sekunnin kuluttua mallin vastauksena.

   Note

   Voit jättää oletusmallin GPT-4o-muotoon tai valita minkä tahansa muun tarpeen mukaan.

5. Valitse Mallivastauksen>Tuloste -kohdasta Asiakirja mallivastauksen muotoa varten. Mallin vastauksessa pitäisi myös näkyä päivitetty Excel-tiedosto, jossa on merkityt tapahtumat, ja yhteenvetoraportti PDF-muodossa. Voit ladata nämä tiedostot ja tarkistaa tulokset.

   Tärkeää

   Jos haluat uudelleentestata eri tiedostolla, sinun on muutettava kehotteen tekstiä ja tallennettava. Pelkkä mallitiedoston lataaminen tai vaihtaminen muokkaamatta kehotetta ei käynnistä uudelleenkäsittelyä.

Tässä esimerkissä havainnollistetaan kooditulkin teho, sillä se kehottaa käynnistämään monimutkaisia skenaarioita tiedostojen avulla.

Esimerkkiskenaario 2: koodin tulkkauskehote visuaalisen yhteenvedon luomiseksi Dataverse-taulukoista

Tässä esimerkissä näytetään, miten voit luoda kehotteen, jossa koodin tulkki on käytössä. Näin voit lukea tietueita Dataverse-taulukoista, analysoida tietoja ja luoda visuaalisen yhteenvedon (kaavion) ja tekstiyhteenvedon.

Dataverse-kehotteen muokkaaminen ja testaaminen

Kun kehoteeditori on auki ja kooditulkkaus on käytössä, luo kehote noudattamalla seuraavia ohjeita:

1. Kirjoita kehotteeseen seuraavat ohjeet

   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. Esitä kehote linkittämällä asiaan liittyviin Dataverse-taulukoihin (esimerkiksi liput, henkilöstön aikataulut).

   1. Käytä / tätä syöttö- ja tietämysvalikon avaamiseen ja valitse Dataverse kohdassa Tietämys.

      

   2. Valitse taulukko ja valitse kehotteeseen tarvittavat kentät (esimerkiksi lipun tila, määritetty agentti, palvelutasosopimuksen tila).

   3. Lisää kentät taulukosta kehotteeseen valitsemalla Lisää .

      

   4. Valitse tarvittaessa Suodata määrite, jos haluat suodattaa taulukon tiedot tietyille määritteille ja arvoille.

      

3. Suorita kehote valitsemalla Testaa .

4. Varmista, että kehote lukee lipputiedot, käyttää määrityssääntöjä ja päivittää tietueet Dataversessa odotetulla tavalla.

   

5. Tallenna kehote.

Kehotteen integrointi agenttityönkulkuun Copilot Studiossa

Seuraavaksi voit luoda agentin työnkulun, joka rivittää kehotteen ja yhdistää sen Dataverseen.

1. Palaa agentin Työkalut-sivulle ja valitse Lisää työkalu>Uusi työkalu>Agentin työnkulku.

   Agenttityönkulun suunnittelutyökalussa näkyy aluksi Kun agentti kutsuu työnkulun -käynnistintä.

2. Valitse suunnittelutyökalussa Lisää>Suorita kehote , jos haluat lisätä uuden Suorita kehote -toiminnon.

   

3. Valitse Suorita kehote -solmussa kooditulkin kehote.

   

4. Valitse suunnittelutyökalussa Lisää>vastaus agenttiin , jos haluat lisätä uuden Vastaa agenttiin -toiminnon Suorita kehote -toiminnon jälkeen.

5. Avaa sitten Vastaa agentille - solmueditori, jotta voit valita parametrit välitetäksesi ne takaisin agentille tulosteina.

6. Lisää yhteenvetoteksti ja kaaviokuva kehotteesta työnkulun tulosteina Lisää tuloste -painikkeella.

   Anna yhden tulosteen Summarynimeksi ja valitse Insights dynaamisen arvon asetuksen avulla tulosmuuttuja Suorita kehote -toiminnosta.

   Nimeä toinen tuloste GraphBase64ja määritä tulostearvo lausekeasetuksen avulla. Valitse Base64-kuvatuloste Suorita kehote -toiminnosta.

   

7. Valitse Tallenna luonnos.

8. Anna Yleiskatsaus-välilehdenTiedot-kohdassa työnkululle nimi.

Agentin julkaiseminen ja käyttäminen

1. Tallenna ja julkaise agentti.

   Agentti voi nyt käsitellä Dataverse-tietueita ja luoda yhteenvedon ja kaavion.

2. Siirry Agenttityökalut-sivulle ja valitse kehotetta käyttävä tietty agenttityönkulku.

3. Määritä Valmis-kohdassaSuorittamisen jälkeen -toiminnoksi Lähetä mukautuva kortti (määritä alla) .

4. Jos haluat näyttää PowerFx-kaavan avulla mukautuvan kortin, valitse Kaava määrittääksesi kortin kaavan avulla.

   Mukautuvan kortin kaavaeditori tulee näkyviin.

5. Määritä mukautuvan kortin sisältö ja lähde käyttämällä seuraavaa kaavaa:

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

   Tässä ja Topic.Output.GraphBase64 ovat tulosmuuttujat, Topic.Output.Summary jotka on määritetty aiemmin agentin työnkululle.

6. Tallenna agenttisi ja testaa sitä.

7. Julkaise agenttisi, jotta muut käyttäjät voivat luoda Dataverse-taulukoihin perustuvaa dynaamista sisältöä.

Esimerkkiskenaario 3: koodin tulkkauskehote kaavion luomiseksi käyttäjän toimittamasta Excel-tiedostosta

Tässä esimerkissä näytetään, miten voit luoda kehotteen, jossa koodin tulkki on käytössä ja lukee ladatun Excel-tiedoston, muuntaa tiedot kaaviokuvaksi ja palauttaa kuvan käyttäjälle. Kehote käynnistyy aiheesta, kun käyttäjä lataa Excel-tiedoston ja pyytää kaaviota.

Kaavion luontikehotteen luominen ja määrittäminen

Kun kehoteeditori on auki ja kooditulkki on käytössä, luo kehote noudattamalla seuraavia ohjeita:

1. Anna kehotteellesi merkityksellinen nimi (esimerkiksi Gen-kehote), ja anna seuraavat ohjeet kehotetta varten:

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

2. Käytä / tätä syöttö- ja tietämysvalikon avaamiseen ja valitse Kuva tai asiakirjaSyöttö-kohdasta.

3. Valitse testaukseen tarkoitettuna tiedostona Excel-tiedosto, joka sisältää mallitietoja ladattavaksi.

4. Valitse Tallenna.

5. Lisää kehote työkaluksi valitsemalla Lisää agenttiin .

Kaaviokehotetta kutsuvan aiheen luominen

1. Siirry Copilot Studion Aiheet-välilehteen ja luo uusi aihe valitsemalla Lisää aihe>tyhjästä.

2. Aseta Käynnistin-huomautuksessa Kuvaile, mitä aihe tekee kohteeseen "Kun tiedosto ladataan ja käyttäjä sanoo 'generoi kaavioni'."

3. Valitse Lisää solmu ja valitse sitten Muuttujan hallinta, > ja Silmukoi luettelon läpi, jotta lisäät silmukkasolmun.

4. Valitse Silmukoi luettelon läpi -solmu avataksesi solmueditorin. Valitse Silmukoitavat kohteet -kohdasta Valitse muuttuja>Järjestelmäaktiviteetti.Liitteet>.

   

5. Valitse silmukassa Lisää solmu, valitse sitten Lisää työkalu ja valitse aiemmin luomasi kehotetyökalun lisäämiseksi aiheeseen.

6. Määritä syöte- ja tulostemuuttujat vastaavasti. Määritä syötteelle kaavalla kohteeseen Topic.LoopValue1.Value ja valitse Lisää. Alusta tulostetta varten muuttuja nimeltä Output, joka kaappaa annettuun kehotteeseen liittyvän tulosteen.

   

7. Lisää viestisolmu valitsemalla silmukassa Lisää solmu>Luo viesti . Viestisolmua käytetään kehotteen tulosteen välittämiseen takaisin käyttäjälle. Tässä esimerkissä kehote alustaa muuttujan Output vastauksella. Teksti tallennetaan kohteeseen Output.text.

8. Valitse viestin tekstiosassa Lisää muuttuja ja valitse Output.text.

9. Lisää viestiin kuva valitsemalla Lisää>kuva .

   

10. Muotoile sitten kuva oikein. Valitse Media ja valitse Kuvan URL-osoite -kohdasta Valitse muuttuja>Kaava ja kirjoita seuraava kaava: "data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Note

    Tätä muotoa tarvitaan, jotta keskustelu hahmontaa kuvan oikein. Tässä esimerkissä mychart esitetään kehotteessa tiedostotulosteelle valitsemamme nimi ja Output muuttujan nimi. Tiedot voivat muuttua muissa esimerkeissä sen mukaan, miten kehotteen tuloste ja aiheen muuttujat nimetään.

    

11. Tallenna aihe valitsemalla Tallenna.

12. Valitse Testaa. Kuvan pitäisi näkyä, kun kehote käynnistetään.

    

Lisää esimerkkejä kooditulkin käytön kehotteesta

Seuraavassa taulukossa on lisää esimerkkejä kehotteista, joita voi käyttää kooditulkin ollessa käytössä. Näissä esimerkeissä näytetään, miten kooditulkkia kehotetaan suorittamaan monimutkaisia tehtäviä.

Kehote	Odotettu tulos
Luo PDF-tiedosto tilaustietojen tallentamiseksi	Tilauksen sieppauslomakkeen luominen PDF-muodossa
Pdf-tiedoston <parametri A:n > kopion luominen	Luo kopio annetusta PDF-tiedoston syötteestä.
Luo Excel-tiedosto, joka sisältää synteettisen tietojoukon myyntitapahtumia	Luo Excel-tiedosto mallimyyntitapahtuman avulla. Voit parantaa suorituskykyä antamalla kehotteeseen lisää ohjeita kehittyneempien synteettisten tietojen saamiseksi. Seuraavassa esimerkissä näytetään monimutkaisempi kehote.
Luo Excel-tiedosto, jossa on realistinen synteettinen tietojoukko, joka simuloi viikoittaisia myyntitapahtumia neljällä alueella ("Pohjoinen", "Etelä", "Itä", "Länsi") koko kalenterivuoden ajan. Kunkin tietueen tulee sisältää seuraavat: - Tapahtuman päivämäärä (viikoittainen) - Alue - Myyjän nimi (vähintään kolme yksilöllistä nimeä aluetta kohden) - Tuoteluokka (esimerkiksi "elektroniikka", "huonekalut", "laitteet", "vaatteet") - Tuotteen nimi (realistiset nimet luokan perusteella) - Myyty määrä - Yksikköhinta (vaihtelee luokan mukaan) - Kokonaismyyntisumma (laskettu) - Tavoite saavutettu (kyllä/ei alueellisen raja-arvon perusteella) - Neljännes - Kanava (online, jälleenmyynti, jakelija) - Asiakassegmentti (esimerkiksi "Yritys", "SMB", "kuluttaja") Lisää satunnaisia vaihteluja ja kausivaihteluja: - Tehosta "elektroniikan" myyntiä Q4:ssä - Pienempi myynti "Pohjoisessa" tammi–helmikuussa (simuloi talven hidastumista) - Korkeampi vaatemyynti kvartaalissa 2 (kevät) Lopullisen tietojoukon rivien määrän tulee olla vähintään 2 000. Lisää kevyttä satunnaisuutta realismiin.	Tämä kehote luo Excel-tiedoston, joka sisältää aiempaa monipuolisempia synteettisiä tietoja. Tämä kehote havainnollistaa kooditulkin tehokkuutta ja sitä, miten kehotteeseen pitäisi antaa selkeät ja yksityiskohtaiset ohjeet.
Luo yhteenvetotaulukko automaattisesti – käyttämällä <parametria A> Luo: - Kuukausittaiset koosteet - Parhaiten suoriutuvat alueet - Alisuoriutujien ehdollinen muotoilu	Analysoi Excel-tiedosto välittämällä tiedosto syötteenä tähän kehotteeseen. Tämä kehote luo yhteenvedon Excelissä, mutta se voidaan tallentaa PDF-tiedostoon myös kehotteen avulla.
Korosta solut vihreällä värillä, jos myynti > 1000, muuten merkitse se punaisella	Pyydä kooditulkkia suorittamaan Excel-muotoilu ehtojen ja kaavojen perusteella. Muotoilu ilmaistaan kehotteessa kuvan mukaan. Voit käyttää samaa ideaa myös muihin käyttötapauksiin Excelin muotoilussa ja tyylin käsittelyssä.