Dela via


Starta automatiskt en Copilotkonversation

Du kan konfigurera din pilot så att du kan starta en konversation med en användare. Du kan även kombinera den anpassade hälsningsfrasen med anpassningar till copilot-utseende och känsla.

Viktigt

Om copilot startar konversationen kommer den att visas i analysen och det ökar antalet sessioner.

Om användaren av copilot inte interagerar med roboten (t.ex. läser in sidan utan att fråga roboten om något annat), markeras sessionen som en session som inte har aktiverats. Detta kan påverka analysen.

Som standard laddas Copilot som har skapats med Microsoft Copilot Studio och publicerats på en webbplats utan en hälsning och väntar på att användaren ska vänta på att användaren startar konversationen.

Du kan emellertid använda anpassad CSS och JavaScript-kod för att Copilot automatiskt ska starta konversationen när Copilot läses in. Du kan till exempel använda Copilot för att säga ”Hej, jag är Botty, en virtuell handläggare” så fort den läses in.

Först måste du distribuera en anpassad arbetsyta som innehåller argument som utlöser hälsningen. Som standard anropar den anpassade arbetsytan standardhälsningsämne för system. Du kan emellertid skapa en ny ämne ska användas som hälsning. Du måste också ändra standardhälsningsämnet för system till det nya ämnet.

Viktigt!

Du kan installera och använda exempelkoden som finns i den här dokumentationen endast för användning med Microsoft Copilot Studio-produkten. Exempelkoden är licensierad och ingår inte i några servicenivåavtal eller supporttjänster. Användande sker på egen risk.

Microsoft lämnar inga uttryckliga garantier, eller villkor och exkluderar alla underförstådda garantier, inklusive säljbarhet, lämplighet för ett särskilt ändamål och ansvarsfrihet mot inskränkning av immaterielrätt.

Hämta tokenslutpunkt

Om du vill anpassa arbetsytan, oavsett om det är standardarbetsytan eller en som du ansluter till, måste du hämta dina copilot-uppgifter.

  1. I navigeringsmenyn, under Inställningar, väljer du Kanaler.

  2. Välj Mobilapp.

    Bild på fönstret för installation av kanalpanel.

  3. Bredvid tokenslutpunkt, välj kopiera.

    Skärmbild på tokenslutpunkt-ID.

Anpassa standarddesignytan (enkel)

Konfigurera hur chattarbetsytan ska se ut med några enkla CSS och JavaScript-alternativ.

Först måste du konfigurera vart du distribuerar din robotarbetsyta.

  1. Skapa och publicera en copilot.

  2. Kopiera och klistra in HTML-koden som visas här och spara den som index.html.
    Du kan också kopiera och klistra in koden i w3schools.com HTML prova den i redigeraren. Du måste fortfarande lägga till din tokenslutpunkt.

    <!DOCTYPE html>
    <html>
    <head>
        <title>Contoso Sample Web Chat</title> 
        <!-- This styling is for the Web Chat demonstration purposes. It is recommended that style is moved to a separate file for organization in larger projects -->
        <style>
            html, body {
                height: 100%;
            }
    
            body {
                margin: 0;
            }
    
            h1 {
                font-size: 16px;
                font-family: Segoe UI;
                line-height: 20px;
                color: whitesmoke;
                display: table-cell;
                padding: 13px 0px 0px 20px;
            }
    
            #heading {
                background-color: black;
                height: 50px;
            }
    
            .main {
                margin: 18px;
                border-radius: 4px;
            }
    
            div[role="form"]{
                background-color: black;
            }
    
            #webchat {
                position: fixed;
                height: calc(100% - 50px);
                width: 100%;
                top: 50px;
                overflow: hidden;
            }
    
        </style>
    
    </head>
    <body>
        <div>
            <div id="heading">
                <!-- Change the h1 text to change the bot name -->    
                <h1>Contoso Bot Name</h1>
            </div>
            <div id="webchat" role="main"></div>
        </div>    
    
      <script src="https://cdn.botframework.com/botframework-webchat/latest/webchat.js"></script>
    
      <script>
            const styleOptions = {
    
               // Add styleOptions to customize Web Chat canvas
               hideUploadButton: true
            };
    
            // Add your BOT token endpoint below
            var theURL = "<BOT TOKEN ENDPOINT>";
    
            var environmentEndPoint = theURL.slice(0,theURL.indexOf('/powervirtualagents'));
            var apiVersion = theURL.slice(theURL.indexOf('api-version')).split('=')[1];
            var regionalChannelSettingsURL = `${environmentEndPoint}/powervirtualagents/regionalchannelsettings?api-version=${apiVersion}`; 
    
            var directline;
                fetch(regionalChannelSettingsURL)
                    .then((response) => {
                        return response.json();
                        })
                    .then((data) => {
                        directline = data.channelUrlsById.directline;
                        })
                    .catch(err => console.error("An error occurred: " + err));
    
          fetch(theURL)
                .then(response => response.json())
                .then(conversationInfo => {
                    window.WebChat.renderWebChat(
                        {
                            directLine: window.WebChat.createDirectLine({
                                domain: `${directline}v3/directline`,
                                token: conversationInfo.token,
                            }),
                            styleOptions
                        },
                        document.getElementById('webchat')
                    );
                })
                .catch(err => console.error("An error occurred: " + err));
    
        </script>
      </body>
    </html>
    
  3. I filen index.html du skapade, ange tokenslutpunkt på raden var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Öppna index.html med en modern webbläsare (t.ex. Microsoft Edge) för att öppna copilot i den anpassade arbetsytan.

  5. Testa Copilot för att se till att du får svar från den och att den fungerar som det ska.

    Om det uppstår problem kontrollerar du att du har publicerat Copilot och att tokenslutpunkten har infogats på rätt plats. Tokenslutpunkten ska vara efter likhetstecknet (=) på raden var theURL = "<YOUR TOKEN ENDPOINT>" och omges av dubbla citattecken (”).

Ändra standardhälsningar för Copilot

Koden i filen index.html gör att ett ämne anropas automatiskt när Copilot läses in. Som standard anropar koden systemhälsningsämnet. Du kan också skapa en ny ämne och avsätta standardhälsningsämne för system till det nya ämnet.

I båda fallen gör du ändringar i den ämne du vill ringa som vanligt.

Om du ändrar eller skapar ett nytt ämne ska du ange någon form av indikering på att användaren pratar med en Copilot (eller en ”virtuell handläggare”). En sådan indikering hjälper användaren att förstå att de inte pratar med någon annan.

Vi rekommenderar att du ändrar systemets hälsningsämne så att du inte behöver redigera index.html-kod.

  1. Markera avsnitt i navigeringsmeny och markera raden Hälsning ämne.

    Skärmbild av sidan Ämnen med hälsningsämnet markerat.

  2. Redigera texten i de noder som är meddelande. Du kan även lägga till eller ta bort ytterligare noder.

  3. Välj Spara.

  4. Publicera din Copilot.

Nu kan du testa Copilot genom att gå till den webbsida där du har distribuerat Copilots egen arbetsyta. Du lär dig att använda roboten för att starta konversationen genom att automatiskt visa hälsningsämne.

Skapa ett nytt användarämne

Varning

Om du använder en användarämne för att starta en konversation görs en ökning av dina fakturerade sessioner. En fakturerad session är en interaktion mellan en kund och en Copilot och representerar en förbrukningsenhet. Den fakturerade sessionen börjar när ett användarämne utlöses. Mer information finns i Visa fakturerade sessioner (förhandsversion).

  1. I navigeringsmeny väljer du Ämnen.

  2. Välj nytt ämne och ge den ett namn.

  3. Lägg till texten i de noder som är meddelande.

  4. Välj Spara när du är klar med att redigera meddelandet.

  5. Markera avsnitt i navigeringsmeny och markera raden Hälsning ämne.

  6. Ta bort de meddelandenoder som visas i ämnet hälsning.

  7. Om du vill vidarebefordra Copilot automatiskt till ett användarämne väljer du Lägg till nod (+) för att lägga till en nod och sedan Gå till et annat ämne.

  8. Markera det användarämne du skapat ovan på den utfällbara menyn.

  9. Välj Spara när du är klar med att redigera meddelandet.

  10. Publicera din Copilot.

Nu kan du testa Copilot genom att gå till den webbsida där du har distribuerat Copilots egen arbetsyta. Copilot startar konversationen genom att automatiskt visa det nya ämnet.