Del via

Automatisk start af en copilotsamtale

  • Artikel

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

Vigtigt!

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

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

Copiloter, der er oprettet med Microsoft Copilot Studio og publiceret til et websted, 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å copiloten til at starte samtalen, når copiloten indlæses. Du kan f.eks. få din copilot til at sige "Hej, jeg er Botty, en virtuel agent" så snart copiloten 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 Microsoft 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 copilotoplysninger.

  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. Opret og publicer en copilot.

  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 copiloten i det brugerdefinerede lærred.

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

    Hvis du støder på problemer, skal du sørge for at have udgivet din copilot, og at dit tokenslutpunkt 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 copilotens standardhilsen

Koden i filen index.html medfører, at et emne kaldes automatisk, når copiloten 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 angive en form for indikation på, at brugeren taler med en copilot (eller "virtuel helpdesk-medarbejder"). 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 Gem.

  4. Publicer din copilot.

Du kan nu teste din copilot ved at gå til det websted, hvor du har installeret din copilots 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 copilot og repræsenterer én forbrugsenhed. Den fakturerede session starter, når et brugeremne udløses. Du kan finde flere oplysninger i Vise fakturerede sessioner (forhåndsversion).

  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 copiloten 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 copilot.

Du kan nu teste din copilot ved at gå til det websted, hvor du har installeret din copilots brugerdefinerede lærred. Du kan se copiloten starte samtalen ved automatisk at vise det nye emne.