Starta en chattrobotkonversation automatiskt

  • Artikel

Viktigt!

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Du kan konfigurera din robot att starta en konversation med en användare. Du kan även kombinera den anpassade hälsningsfrasen med anpassningar till robotens utseende och känsla.

Viktigt!

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

Om användaren av roboten 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 chattrobotar 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 automatiskt starta konversationen när robot öppnas i robotfunktionen. Du kan till exempel använda robot för att säga "Hej, jag är Botty, en virtuell handläggare" så fort roboten 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 ett nytt ämne som ska användas som hälsningsfras, men du måste därför behöva överföra standardsystemets hälsningsämne till ett nytt ämne.

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 robotuppgifter.

  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 robot.

  2. Kopiera och klistra in HTML-koden nedan och spara den som index.html.
    Du kan också kopiera och klistra in koden nedan i w3schools.com HTML prova den i redigeraren. Du måste fortfarande lägga till 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 robot i den anpassade arbetsytan.

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

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

Ändra standardhälsningar för robot

Koden i filen index.html gör att ett ämne anropas automatiskt när robotfunktionen läses in. Som standard anropas systemhälsningsämne. 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 hälsningsämne är det en bästa praxis att inkludera någon form av identifiering om att användaren pratar med en robot (eller "virtuell agent"), så att de inte tror att de pratar med en människa.

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 roboten.

Nu kan du testa roboten genom att gå till den webbsida där du har distribuerat robotens 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 robot och representerar en förbrukningsenhet. Den fakturerade sessionen börjar när ett användarämne utlöses. Mer information finns i ämne analysera information om fakturerade sessioner.

  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 roboten automatiskt till ett användarämne väljer du Lägg till nod (+) för att lägga till en nod innan du Går till ett annant ä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 roboten.

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