Jaa

Agenttikeskustelun automaattinen aloittaminen

  • Artikkeli

Voit määrittää agentin aloittamaan keskustelun käyttäjän kanssa. Voit myös yhdistää mukautetun tervehdyksen agentin yleisen ulkoasun mukauttamisen kanssa.

Tärkeää

Se, että agentti aloittaa keskustelun, näkyy analytiikassa ja lisää istuntojen määrää.

Jos agentin käyttäjä ei ole vuorovaikutuksessa agentin kanssa (esimerkiksi lataa sivun, muttei kysy agentilta mitään), istunto merkitään istunnoksi, johon ei osallistuttu. Tämä voi vaikuttaa analytiikkaan.

Oletusarvoisesti Copilot Studiossa luodut ja sivustossa julkaistut agentit latautuvat ilman tervehdystä ja odottavat passiivisesti sitä, että käyttäjä aloittaa keskustelun.

Voit kuitenkin käyttää mukautettua CSS- ja JavaScript-koodia siten, että agentti aloittaa keskustelun automaattisesti agentin latautuessa. Voit esimerkiksi määrittää agentin sanomaan "Hei, olen Bottinen, virtuaalinen asiakaspalvelija" heti, kun agentti latautuu.

Ensin sinun on otettava käyttöön mukautettu pohja, joka sisältää tervehdyksen käynnistävät argumentit. Oletusarvoisesti mukautettu pohja kutsuu oletusarvoisen järjestelmän tervehdysaiheen. Voit kuitenkin luoda uuden aiheen, jota käytetään tervehdyksenä. Sinun on siirrettävä oletusarvoinen järjestelmän tervehdysaihe uuteen aiheeseen.

Tärkeää

Voit asentaa ja käyttää tässä dokumentaatiossa olevaa näytekoodia vain Copilot Studio -tuotteessa. Näytekoodilla on käyttöoikeus sellaisenaan, ja se jätetään kaikkien palvelutasosopimusten ja tukipalvelujen ulkopuolelle. Käytöstä aiheutuvat riskit ovat omalla vastuullasi.

Microsoft ei anna mitään suoria takuita, vakuutuksia tai ehtoja ja kiistää kaikki epäsuorat takuut, mukaan lukien takuut soveltuvuudesta kaupankäynnin kohteeksi, tiettyyn käyttötarkoitukseen tai oikeuksien rikkomattomuudesta.

Nouda tunnuksen päätepiste

Jos haluat mukauttaa pohjaa, oli kyseessä sitten oletuspohja tai mukautettu pohja, johon muodostat yhteyden, sinun on noudettava agenttisi tiedot.

  1. Valitse siirtymisvalikon Asetukset-kohdasta Kanavat.

  2. Valitse Mobiilisovellus.

    Näyttökuvassa mobiilisovelluksen kanavaruutu

  3. Valitse Tunnuksen päätepiste -kohdan vierestä Kopioi.

    Näyttökuvassa päätepistetunnuksen tunniste

Oletuspohjan mukauttaminen (yksinkertainen)

Määritä keskustelupohjan ulkoasu yksinkertaisten CSS- ja JavaScript-muotoiluasetusten avulla.

Aluksi sinun on määritettävä, missä otat bottipohjasi käyttöön.

  1. Agentin luominen ja julkaiseminen.

  2. Kopioi ja liitä tässä näkyvä HTML-koodi ja tallenna se muotoon index.html.
    Voit myös kopioida ja liittää koodin w3schools.com HTML try it -editoriin. Sinun on tästä huolimatta tunnuksen päätepiste.

    <!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. Syötä tunnuksesi päätepiste luomasi index.html-tiedoston riville var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Avaa index.html käyttämällä modernia selainta (kuten Microsoft Edgeä) avataksesi agentin mukautetussa pohjassa.

  5. Testaa agentti varmistaaksesi, että saat siltä vastauksia ja että se toimii oikein.

    Jos ongelmia ilmenee, varmista, että olet julkaissut agentin ja että tunnuksen päätepiste on lisätty oikeaan paikkaan. Tunnuksen päätepisteen pitäisi tulla yhtäläisyysmerkin (=) jälkeen rivillä var theURL = "<YOUR TOKEN ENDPOINT>", ja sen ympärillä pitäisi olla lainausmerkit (").

Agentin oletustervehdyksen muuttaminen

Koodi, joka on index.html-tiedostossa, kutsuu aihetta automaattisesti agentin latauksen yhteydessä. Oletusarvoisesti koodi kutsuu järjestelmän tervehdysaiheen. Voit myös luoda uuden aiheen ja siirtää oletusarvoisen järjestelmän tervehdysaiheen kyseiseen uuteen aiheeseen.

Molemmissa tapauksissa teet muutoksia aiheeseen, jonka haluat yleensä kutsua.

Jos muokkaat tai luot uuden tervehdysaiheen, sinun on sisällytettävä jonkinlainen osoitus siitä, että käyttäjä puhuu asiakaspalvelijan (tai "virtuaalisen asiakaspalvelijan") kanssa. Tällainen viittaus auttaa käyttäjää ymmärtämään, että hän ei puhu ihmisen kanssa.

Suosittelemme muokkaamaan järjestelmän tervehdysaihetta, jotta sinun ei tarvitse muokata index.html-koodia.

  1. Valitse siirtymisvalikosta Aiheet ja sitten Tervehdys-aiherivi.

    Näyttökuva Aihe-sivusta, jossa Tervehdys-aihe on korostettuna.

  2. Mokkaa Viesti-solmuissa olevaa tekstiä. Voit myös lisätä tai poistaa solmuja .

  3. Valitse Tallenna.

  4. Agentin julkaiseminen.

Nyt voit testata agenttia siirtymällä verkkosivulle, jolla agentin mukautettu kaavio on otettu käyttöön. Näet, miten botti aloittaa keskustelun näyttämällä automaattisesti tervehdysaiheen.

Uuden käyttäjäaiheen luominen

Varoitus

Käyttäjäaiheen käyttö keskustelun aloittamiseen lisää laskutettavia istuntoja. Laskutettu istunto on asiakkaan ja agentin välinen vuorovaikutus, ja se edustaa yhtä kulutusyksikköä. Laskutettu istunto alkaa, kun käyttäjäaihe käynnistyy. Lisätietoja: Vistikapasiteetin hallinta.

  1. Valitse sivulla olevan siirtymisvalikon Aiheet-kohta.

  2. Valitse Uusi aihe ja anna sille nimi.

  3. Lisää teksti Viesti-solmuun.

  4. Valitse Tallenna, kun olet lopettanut viestin muokkaamisen.

  5. Valitse siirtymisvalikosta Aiheet ja sitten Tervehdys-aiherivi.

  6. Poista viestisolmutTervehdys-aiheesta.

  7. Jos haluat siirtää agentin automaattisesti käyttäjän aiheeseen, lisää solmu valitsemalla Lisää solmu (+). Valitse sitten Siirry toiseen aiheeseen.

  8. Valitse pikaikkunan valikosta käyttäjäaihe, jonka loit yllä.

  9. Valitse Tallenna, kun olet lopettanut viestin muokkaamisen.

  10. Agentin julkaiseminen.

Nyt voit testata agenttia siirtymällä verkkosivulle, jolla agentin mukautettu kaavio on otettu käyttöön. Näet, miten agentti aloittaa keskustelun näyttämällä automaattisesti uuden aiheen.