Del via

Automatisk start af en agentsamtale

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. Denne funktionsmåde kan påvirke din analyse.

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 som standard det foruddefinerede emne Hilsen . Du kan dog oprette et nyt emne, der skal bruges som hilsen. Du omdirigerer standardemnet Hilsen til dette nye emne.

Vigtige oplysninger

Du kan kun installere og bruge den eksempelkode, der er inkluderet i denne artikel, til brug sammen med Copilot Studio. 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.

Tilpas standardlærredet

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 følgende HTML-kode, og gem den i en fil med navnet index.html. Du kan også kopiere og indsætte koden i w3schools.com HTML prøv den editor.

    <!DOCTYPE html>
<html>
<head>
    <title>Contoso Sample Web Chat</title> 
    <!-- This styling is for Web Chat demonstration purposes. For larger projects, we recommend you move style to a separate file -->
    <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 the token endpoint for your agent below
        var theURL = "<YOUR 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. Hent token-slutpunktet for din agent.

  4. Udskift index.html pladsholderen med tokenslutpunktet for din agent på linjen var theURL = "<YOUR TOKEN ENDPOINT>".

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

  6. Test agenten for at sikre, at du modtager svar fra den, og at den fungerer korrekt.

    Hvis der opstår problemer, skal du sørge for, at du har publiceret din agent, og at tokenslutpunktet er på det korrekte sted. Tokenslutpunktet skal være angivet efter lighedstegnet (=) på linjen var theURL = "<YOUR TOKEN ENDPOINT>" og omgivet af dobbelte anførselstegn (").

Hent token-slutpunktet for din agent

Hvis du vil tilpasse dit lærred, uanset om det er standardlærredet eller et brugerdefineret lærred, du opretter forbindelse til, skal du bruge tokenslutpunktet for din agent.

  1. Vælg Kanaler under Indstillinger i navigationsmenuen.

  2. Vælg Mail. Konfigurationspanelet for denne kanal vises.

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

Ændre agentens standardhilsen

Koden i index.html filen medfører, at et emne kaldes automatisk, når agenten indlæses. Koden kalder som standard emnet Hilsen . Du kan også oprette et nyt emne og omdirigere standardemnet for hilsenen til det nye emne.

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

Hvis du ændrer emnet Hilsen eller opretter et nyt, skal du angive, at brugeren taler med en agent (eller "virtuel agent"). En sådan indikation hjælper brugeren med at forstå, at vedkommende ikke taler med et menneske.

Vi anbefaler, at du ændrer det foruddefinerede emne Hilsen , så du ikke behøver at redigere koden index.html .

  1. Gå til siden Emner for din agent, og vælg emnet Hilsen .

  2. Rediger teksten i noden Meddelelse . Du kan også tilføje eller slette 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 brugerdefineret emne

Advarsel!

Hvis du bruger et brugerdefineret emne til at starte en samtale, ø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 brugerdefineret emne udløses. Du kan finde flere oplysninger under Administrér meddelelseskapacitet.

  1. Gå til siden Emner for din agent.

  2. Vælg Tilføj et emne>fra bunden.

  3. Angiv et navn til det nye emne.

  4. Tilføj en node af typen Meddelelse , og konfigurer den med den ønskede meddelelse.

  5. Vælg Gem , når du er færdig med at redigere meddelelsen.

  6. Gå til siden Emner igen, og vælg emnet Hilsen .

  7. Slet alle meddelelsesnoder fra emnet Hilsen .

  8. Hvis du automatisk vil omdirigere agenten til det nye emne, skal du tilføje noden Omdirigering med det nye emne for destinationen.

  9. Vælg Gem, og 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.