Del via

Starte en agentsamtale automatisk

  • Artikkel

Du kan konfigurere agenten til å starte en samtale med en bruker. Du kan også kombinere den tilpassede hilsenen med tilpasning til agentens utseende og stil.

Viktig!

Når agenten starter, vises samtalen i statistikken, og antallet økter øker.

Hvis brukeren av agenten ikke kommuniserer med agenten (for eksempel når de laster inn siden, men ikke spør agenten om noe), blir økten merket som en uengasjert økt. Dette kan påvirke statistikken din.

Agenter som er opprettet med Copilot Studio og publisert på et nettsted, lastes inn uten en hilsen som standard, og venter passivt til brukeren starter samtalen.

Du kan imidlertid bruke egendefinert CSS-kode og JavaScript-kode for å få agenten til å starte samtalen automatisk når agenten lastes inn. Du kan for eksempel få agenten til å si «Hei, jeg heter Robert og er en virtuell agent» så snart agenten lastes inn.

Først må du distribuere et egendefinert lerret som inneholder argumenter som utløser hilsenen. Som standard kaller det egendefinerte lerretet på standardhilsen-emnet for systemet. Du kan imidlertid opprette et ny emne som skal brukes som hilsen. Du må revidere standard hilsningsemne for systemet til et nytt emne.

Viktig

Du kan installere og bruke eksempelkoden som er inkludert i denne dokumentasjonen, som bare kan brukes med Copilot Studio-produktet. Eksempelkoden er lisensiert «som den er», og utelates fra alle serviceavtaler eller kundestøttetjenester. Du bruker det på egen risiko.

Microsoft gir ingen uttrykkelige garantier eller vilkår, og ekskluderer alle underforståtte garantier, inkludert salgbarhet, anvendelighet for særskilte formål og ikke-krenkelse.

Hent tokenendepunkt

Hvis du vil tilpasse lerretet, enten det er standardlerretet eller et egendefinert lerret du kobler til, må du hente informasjon om agenten din.

  1. Velg Kanaler under Innstillinger på navigasjonsmenyen.

  2. Velg Mobilapp.

    Skjermbilde av kanalflis for mobilappen.

  3. Velg Kopier ved siden av Tokenendepunkt.

    Skjermbilde av token-ID for endepunkt.

Tilpasse standardlerretet (enkelt)

Konfigurer hvordan chattelerretet skal se ut, med enkelte enkle og brukervennlige CSS- og JavaScript-stilalternativer.

Først må du konfigurere hvor du skal distribuere robotlerretet.

  1. Opprett og publiser en agent.

  2. Kopier og lim inn HTML-koden som vises her, og lagre den som index.html.
    Du kan også kopiere og lime inn koden i w3schools.com HTML try it-redigeringsprogrammet. Du må fremdeles legge til tokenendepunktet.

    <!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 index.html-filen du oppretter angir du tokenendepunktet i linjen var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Åpne index.html i en moderne nettleser (for eksempel Microsoft Edge) for å åpne agenten i det egendefinerte lerretet.

  5. Test agenten for å sikre at du mottar svar fra agenten din, og at agenten fungerer som den skal.

    Hvis det oppstår problemer, må du sørge for at du har publisert agenten, og at tokenendepunktet er satt inn på riktig sted. Tokenendepunktet må komme etter likhetstegnet (=) på linjen var theURL = "<YOUR TOKEN ENDPOINT>", og stå omgitt av doble anførselstegn (").

Endre standardhilsenen for agenten

Koden i filen index. html fører til at et emne automatisk kalles opp når agenten lastes inn. Som standard kaller koden på systemhilsenemnet. Du kan også opprette et nytt emne og revidere standard hilsningsemne for systemet til det nye emnet.

I begge tilfeller gjør du endringer i emnet du vil kalle opp, som normalt.

Hvis du endrer eller oppretter et nytt hilsenemne, bør du inkludere en slags indikasjon på at brukeren snakker med en agent (eller "virtuell agent"). En slik indikasjon vil hjelpe brukeren å forstå at de ikke snakker med et menneske.

Vi anbefaler at du endrer systemhilsningsemnet, slik at du ikke trenger å redigere index.html-koden.

  1. Velg Emner på navigasjonsmenyen, og velg deretter emneraden Hilsen.

    Skjermbilde av Emner-siden med Hilsningsemne uthevet.

  2. Rediger teksten i Melding-nodene. Du kan også legge til eller slette flere noder.

  3. Velg Lagre.

  4. Publiser agenten din.

Nå kan du teste agenten din ved å gå til nettsiden der du har distribuert det egendefinerte lerretet for agenten. Du kan se at roboten starter samtalen ved automatisk å vise hilsningsemnet.

Opprett et nytt brukeremne

Advarsel!

Når du bruker et brukeremne til å starte en samtale, øker de fakturerte øktene. En fakturert økt er en samhandling mellom en kunde og en agent, og representerer én enhet av forbruk. Den fakturerte økten starter når et brukeremne utløses. Hvis du vil ha mer informasjon, kan du se Administrer meldingskapasitet.

  1. Velg Emner på navigasjonsmenyen.

  2. Velg Nytt emne, og gi det et navn.

  3. Legg til teksten i Meldinger-noden.

  4. Når du er ferdig med å redigere meldingen, velger du Lagre.

  5. Velg Emner på navigasjonsmenyen, og velg deretter emneraden Hilsen.

  6. Slett meldingsnodene på Hilsen-emnet.

  7. Hvis du vil at agenten automatisk skal sendes til et brukeremne, velger du Legg til node (+) for å legge til en node, og deretter går du til et annet emne.

  8. I undermenyen velger du brukeremnet du opprettet ovenfor.

  9. Når du er ferdig med å redigere meldingen, velger du Lagre.

  10. Publiser agenten din.

Nå kan du teste agenten din ved å gå til nettsiden der du har distribuert det egendefinerte lerretet for agenten. Du kan se at agenten starter samtalen ved automatisk å vise det nye emnet.