Stil spørgsmål med adaptive kort

Med adaptive kort kan du føje indholdsuddrag til Copilot Studio agenter, som også åbent kan udveksles med andre cloudapps og -tjenester. Hvis du vil give din agent omfattende samtalefunktioner, kan du inkludere tekst, grafik og knapper. Da de er platformsagnostiske, kan du let skræddersy adaptive kort efter dine behov.

Med en Adaptive kort-node kan din agent vise et adaptivt kort, der indeholder en eller flere send-knapper og eventuelt et eller flere formularinputfelter. Din agent gemmer brugerinput i variabler til brug senere i samtalen.

Bemærk

Copilot Studio understøtter Adaptive kort-skemaversion 1.6 og tidligere. Den relevante skemaversion afhænger dog af den målrettede værtsapp:

• Webchatkomponenten Bot Framework (dvs. standardmønsteret for webstedsintegration) understøtter version 1.6, men understøtter ikke Action.Execute
• Live chat-widgetten (bruges til Dynamics 365 Omnikanal til Customer Service) er begrænset til version 1.5
• Teams er også begrænset til version 1.5

Derudover gengiver Copilot Studio kun version-1.6-kort i testchatten, ikke på lærred.

Du kan finde flere oplysninger om skemaet for adaptive kort i Schema Explorer.

Copilot Studio indeholder en indbygget adaptiv kortdesigner, som tilbyder de mest nyttige funktioner fra Adaptive Cards Designer.

Du kan eventuelt bruge:

• Brug en JSON-repræsentation til det kort, du vil vise brugeren.
• Brug en Power Fx formel til at medtage dynamiske oplysninger på kortet.

Du kan også kontrollere kortets funktionsmåde, f.eks. hvad du skal gøre, når brugeren angiver et ugyldigt svar, eller hvis noden afbrydes.

Noden Adaptive kort er beregnet til interaktive kort, hvor brugeren forventes at sende et svar. Meddelelses- og Spørgsmåls-noder kan bruges til at præsentere brugeren for et ikke-interaktivt kort, hvor der vises oplysninger for brugeren.

Tip

Omdøb noder for at gøre det nemmere at identificere dem. Vælg nodens navnefelt for at opdatere navnet direkte, eller vælg ikonet Flere (...) for noden, og vælg Omdøb i menuen. Du kan også omdøbe noder i kodeeditoren.

Det er ikke muligt at omdøbe udløsernoder og noderne Gå til trin.

Nodenavne kan være på op til 500 tegn.

Tilføje et adaptivt kortnode

1. Vælg ikonet Tilføj node under den node, hvorunder du vil tilføje en node til Adaptive kort, og vælg derefter Spørg med adaptivt kort.

2. Vælg ikonet Flere (...) i noden, og vælg derefter Egenskaber.

3. I panelet Adaptive kortnodeegenskaber skal du vælge Rediger adaptivt kort. Designerpanelet for adaptive kort åbnes.

4. Tilføj de ønskede elementer til dit kort, og konfigurer deres egenskaber. I panelet Editor til kortnyttedata kan du også skifte standardnyttedata til dit kort ved at erstatte den bogstavelige JSON-værdi for dit kort.

   Tip

   Dit kort skal indeholde mindst én send-knap, da det skal være et interaktivt kort, der giver brugeren mulighed for at sende oplysninger tilbage til helpdesk-medarbejderen. Hvis det ikke gør og kun er beregnet til at vise oplysninger, skal du føje dit adaptive kort til en meddelelsesnode.

5. Når du er færdig med det oprindelige design, skal du vælge Gem og lukke designerpanelet. Der vises et eksempel på kortet på noden. Copilot Studio opretter automatisk outputvariabler baseret på de input, der er angivet i koden.

   

   Tip

   Hvis de outputvariabler, der genereres for kortet, er forkerte, kan du manuelt opdatere listen over variabler og deres typer ved at vælge Rediger skema i panelet med Nodens egenskaber for adaptive kort.

   Dit interaktive adaptive kort er nu klar. Når en bruger af din helpdesk-medarbejder vælger knappen Send på et kort, udfyldes outputvariablerne med de oplysninger, som brugeren har angivet i sin interaktion med kortet.

Andre egenskaber

Andre egenskaber gør det muligt at styre funktionsmåden for noden Adaptive kort, f.eks.:

• Sådan reagerer helpdesk-medarbejderen på et ugyldigt svar
• Om den kan afbrydes

Hvis agenten afventer en indsendelse fra et adaptivt kort, og brugeren i stedet sender en sms, betragtes dette svar som ugyldigt, medmindre meddelelsen udløser en afbrydelse. I dette tilfælde bestemmer følgende egenskaber funktionsmåden.

• Hvor mange genprompter: Det antal gange, din agent forsøger at få en gyldig indsendelse fra kortet. Gentag op til 2 gange er standarden. Du kan også vælge Gentag én gang eller Gentag ikke. For hvert forsøg sendes kortet til brugeren igen.

• Prøv igen: Brug denne egenskab til at definere en meddelelse, der skal sendes, når der opstår flere forsøg, sammen med en gentagelse af kortet. Hvis du definere en forsøg igen-meddelelse, skal du vælge Tilpas og derefter angive det nye spørgsmål.

• Tillad skift til et andet emne: Hvis indstillingen er valgt (standard), udløser en indgående meddelelse fra en bruger, når agenten afventer indsendelse af et kort, en afbrydelse og skifter til et andet emne. Hvis der sker et emneskift, sendes kortet igen til brugeren, når det afbrydende emne er fuldført.

Brug til Power Fx at gøre kortet dynamisk

Du kan bruge en Power Fx formel til at medtage dynamiske oplysninger på kortet ved at referere til variabler fra dit emne eller din agent.

1. Vælg ikonet Flere (...) i noden, og vælg derefter Egenskaber.

2. I egenskabspanelet for Adaptive Card Node, skift til Formel. Hvis du vælger Formel, konverteres JSON-repræsentationen af dit kort automatisk til en Power Fx-formel.

   

   Du kan f.eks. starte med følgende bogstavelige JSON-værdi for et kort:

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.5",
     "body": [{
         "type": "ColumnSet",
         "columns": [{
             "type": "Column",
             "width": 2,
             "items": [{
                 "type": "TextBlock",
                 "text": "Tell us about yourself",
                 "weight": "Bolder",
                 "size": "Medium",
                 "wrap": true,
                 "style": "heading"
               }, {
                 "type": "TextBlock",
                 "text": "We just need a few more details to get you booked for the trip of a lifetime!",
                 "isSubtle": true,
                 "wrap": true
               }, {
                 "type": "Input.Text",
                 "id": "myName",
                 "label": "Your name (Last, First)",
                 "isRequired": true,
                 "regex": "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 "errorMessage": "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     "actions": [{
         "type": "Action.Submit",
         "title": "Submit"
       }
     ]
   }
   

   Her er den resulterende Power Fx formel, der bruger to variabler Topic.Title og Topic.Subtitle i stedet for den hardkodede tekst fra JSON-bogstavelig tekst. I dette eksempel antages det, at variablerne er defineret i emnet.

   {
     '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
     type: "AdaptiveCard",
     version: "1.5",
     body: [
       {
         type: "ColumnSet",
         columns: [
           {
             type: "Column",
             width: "2",
             items: [
               {
                 type: "TextBlock",
                 text: Topic.Title,
                 weight: "Bolder",
                 size: "Medium",
                 wrap: true,
                 style: "heading"
               },
               {
                 type: "TextBlock",
                 text: Topic.Subtitle,
                 isSubtle: true,
                 wrap: true
               },
               {
                 type: "Input.Text",
                 id: "myName",
                 label: "Your name (Last, First)",
                 isRequired: true,
                 regex: "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 errorMessage: "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     actions: [
       {
         type: "Action.Submit",
         title: "Submit"
       }
     ]
   }
   

Vigtige oplysninger

Når du begynder at redigere i formelpanelet, kan du ikke gå tilbage til den oprindelige JSON-kode. Hvis du vil tillade iterativt design og ændringer, anbefales det, at du gemmer en kopi af den oprindelige JSON i dine egne noter eller som en kommentar i noden. Denne forholdsregel giver dig mulighed for at gå tilbage til ændringer, hvis det er nødvendigt.