Del via

Automatisk start af en agentsamtale

  • Artikel

Du kan konfigurere din agent til at starte en samtale med en bruger. Du kan også kombinere den tilpassede hilsen med tilpasning til agentens udseende og funktionalitet.

Vigtige oplysninger

Hvis agenten starter samtalen, vises den i analyser, og sessionsantallet øges.

Hvis brugeren af din agent ikke interagerer med agenten (hvis de eksempelvis indlæser siden, men ikke spørger agenten om noget), markeres sessionen som en ikke-aktiveret session. Dette kan påvirke dine analyser.

Agenter, der er oprettet med Copilot Studio og udgivet på et website, indlæses som standard uden en hilsen og venter passivt på, at brugeren starter samtalen.

Du kan dog bruge brugerdefineret CSS- og JavaScript-kode til automatisk at få agenten til at starte samtalen automatisk, når agenten indlæses. Du kan f.eks. få din agent til at sige "Hej, jeg er Botty, en virtuel agent" så snart, agenten er blevet indlæst.

Du skal først installere et brugerdefineret lærred, der indeholder argumenter, som udløser en hilsen. Det brugerdefinerede lærred kalder det velkomstemne, der er angivet som standard for systemet. Du kan dog oprette et nyt emne, der skal bruges som hilsen. Du skal omdirigere velkomstemnet, som er standard for systemet, til et nyt emne.

Vigtigt

Du må kun installere og bruge eksempelkoden, der findes i denne dokumentation, til brug sammen med Copilot Studio-produktet. Eksempelkoden er licenseret "som den er og forefindes" i forhold til serviceaftaler eller supporttjenester. Dokumentet bruges på egen risiko.

Microsoft giver ingen udtrykkelige garantier, eller betingelser og påtager sig intet ansvar og fraskriver sig alle underforståede garantier, herunder garanti for salgbarhed, egnethed til et bestemt formål og ikke-krænkelser.

Hente tokenslutpunkt

Hvis du vil tilpasse lærredet, uanset om det er standardlærredet eller et brugerdefineret lærred, som du opretter forbindelse til, skal du hente dine agentoplysninger.

  1. Vælg Kanaler under Indstillinger i navigationsmenuen.

  2. Vælg Mobilapp.

    Skærmbillede af mobilappens kanalfelt.

  3. Vælg Kopiér ud for Slutpunkt for token.

    Skærmbillede af slutpunktets token-id.

Tilpas standardlærredet (simpelt)

Konfigurere, hvordan chatlærredet skal se ud med nogle simple CSS- og JavaScript-formateringsindstillinger.

Du skal først konfigurere, hvor du vil installere botlærredet.

  1. Oprette og publicere en agent.

  2. Kopiér og indsæt HTML-koden, som er vist her, og gem den som index.html.
    Du kan også kopiere og indsætte koden i w3schools.com HTML-prøveeditoren. Du skal stadig tilføje dit 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, som du har oprettet, skal du angive dit tokenslutpunkt på linjen var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Åbn indeks.html ved hjælp af en moderne browser (f.eks. Microsoft Edge) for at åbne agenten i det brugerdefinerede lærred.

  5. Test agenten for at sikre dig, at du modtager svar fra din agent, og at agenten fungerer korrekt.

    Hvis du støder på problemer, skal du sørge for at have udgivet din agent, og at dit token-slutpunkt er indsat på det korrekte sted. Tokenslutpunktet skal være angivet efter lighedstegnet (=) på linjen var theURL = "<YOUR TOKEN ENDPOINT>" og omgivet af dobbelte anførselstegn (").

Ændre agentens standardhilsen

Koden i filen index.html medfører, at et emne kaldes automatisk, når agenten indlæses. Som standard kalder koden systemets velkomstemne. Du kan også oprette et ny emne og omdirigere velkomstemnet, som er angivet som standard for systemet, til det nye emne.

I begge tilfælde foretager du ændringer af det emne, du vil kalde som normalt.

Hvis du ændrer eller opretter et nyt hilsenemne, skal du medtage en form for indikation af, at brugeren taler med en agent (eller "virtuel agent"). En sådan indikation vil gøre det lettere for brugeren at forstå, at de ikke taler med et menneske.

Det anbefales, at du ændrer systemets velkomstemne så du ikke behøver at redigere koden indekset.html.

  1. Vælg Emner i navigationsmenuen, og vælg derefter rækken Hilsen.

    Skærmbillede af emnesiden med velkomstemnet fremhævet.

  2. Rediger teksten i noderne Meddelelser. Du kan også tilføje eller slette yderligere noder.

  3. Vælg Save.

  4. Publicer din agent.

Du kan nu teste din agent ved at gå til det website, hvor du har installeret din agents brugerdefinerede lærred. Du kan se robotten starte samtalen ved automatisk at vise velkomstemnet.

Opret et nyt brugeremne

Advarsel!

Hvis du bruger et brugeremne til at starte en samtale, forøges dine fakturerede sessioner. En faktureret session er en interaktion mellem en kunde og en agent og repræsenterer én forbrugsenhed. Den fakturerede session starter, når et brugeremne udløses. Du kan finde flere oplysninger under Administrér meddelelseskapacitet.

  1. Vælg Emner i navigationsmenuen.

  2. Vælg Nyt emne, og giv det et navn.

  3. Tilføj teksten i Meddelelsesnoden.

  4. Når du har redigeret meddelelsen, skal du vælge Gem.

  5. Vælg Emner i navigationsmenuen, og vælg derefter rækken Hilsen.

  6. Slet meddelelsesnoderne i emnet Velkomsthilsen.

  7. Hvis agenten automatisk skal omdirigeres til et brugeremne, skal du vælge Tilføj node (+) for at tilføje en node og derefter Gå til et andet emne.

  8. Vælg det brugeremne du har oprettet ovenfor, i pop op-menuen.

  9. Når du er færdig med at redigere meddelelsen, skal du vælge Gem.

  10. Publicer din agent.

Du kan nu teste din agent ved at gå til det website, hvor du har installeret din agents brugerdefinerede lærred. Du kan se agenten starte samtalen ved automatisk at vise det nye emne.