Sdílet prostřednictvím

Automatické zahájení konverzace agenta

  • Článek

Agenta můžete nakonfigurovat tak, aby zahájil konverzaci s uživatelem. Můžete také kombinovat vlastní pozdrav s přizpůsobením vzhledu a chování agenta.

Důležité

Když agent zahájí konverzaci, zobrazí se v analýze a zvýší počet vašich relací.

Pokud se uživatel do konverzace s agentem nezapojí (například načte stránku, ale na nic se agenta neptá), je relace označena jako relace bez zapojení. To může ovlivnit vaši analýzu.

Ve výchozím nastavení se agenti vytvoření pomocí Copilot Studio a publikovaní na webu načtou se bez pozdravu a pasivně čekají, až uživatel zahájí konverzaci.

Můžete však použít vlastní kód CSS a JavaScript, aby agent automaticky zahájil konverzaci při svém načtení. Můžete například nechat svého agenta říct: „Ahoj, já jsem Botty, virtuální agent“, jakmile se agent načte.

Nejprve musíte nasadit vlastní plátno, které obsahuje argumenty, které aktivují pozdrav. Ve výchozím nastavení volá vlastní plátno výchozí systémové téma pozdrav. Můžete však vytvořit nové téma, který se použije jako pozdrav. Musíte přesměrovat výchozí systémové téma pozdravu na nové téma.

Důležité

Ukázkový kód obsažený v této dokumentaci můžete nainstalovat a používat pouze pro použití s produktem Copilot Studio. Ukázkový kód je licencován „tak, jak je“ a je vyloučen z jakýchkoli smluv o úrovni služeb nebo služeb podpory. Riziko spojené s jejich použitím nesete vy.

Společnost Microsoft neposkytuje žádné výslovné záruky ani podmínky a vylučuje jakékoliv předpokládané záruky, včetně obchodovatelnosti, vhodnosti pro určitý účel a neporušení předpisů.

Načtení koncového bodu tokenu

Chcete-li upravit své plátno, ať už je to výchozí plátno nebo vlastní plátno, ke kterému se připojíte, musíte získat podrobnosti o svém agentovi.

  1. V navigační nabídce pod Nastavení vyberte Kanály.

  2. Vyberte Mobilní aplikaci.

    Screenshot dlaždice kanálu mobilní aplikace.

  3. Vedle položky Koncový bod tokenu vyberte možnost Kopírovat.

    Screenshot ID tokenu koncového bodu.

Přizpůsobit výchozí plátno (jednoduché)

Konfigurujte vzhled plátna chatu pomocí jednoduchého CSS a možností stylů JavaScriptu.

Nejprve musíte nakonfigurovat, kde nasazujete plátno robota.

  1. Vytvořte a publikujte agenta.

  2. Zkopírujte a vložte zde uvedený HTML kód a uložte jej jako index.html.
    Můžete také zkopírovat a vložit kód do editoru w3schools.com HTML try it. Stále budete muset přidat koncový bod tokenu.

    <!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. V souboru index.html, který jste vytvořili, zadejte koncový bod tokenu do řádku var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Otevřete index.html pomocí moderního prohlížeče (např. Microsoft Edge) a otevřete agenta ve vlastním plátně.

  5. Otestujte agenta, abyste se ujistili, že od svého agenta dostáváte odpovědi a že agent funguje správně.

    Pokud narazíte na problémy, ujistěte se, že jste publikovali svého agenta a že koncový bod tokenu je vložen na správné místo. Koncový bod tokenu by být za znakem rovná se (=) na řádku var theURL = "<YOUR TOKEN ENDPOINT>" a uzavřen dvojitými uvozovkami (").

Změna výchozího pozdravu agenta

Kód v souboru index.html způsobí, že téma se automaticky zavolá při načtení agenta. Ve výchozím nastavení kód volá systémové téma pozdravu. Můžete také vytvořit nové téma a přesměrovat výchozí systémové téma pozdravu na nové téma.

V obou případech provádíte změny tématu, které chcete volat, jako byste to dělali normálně.

Pokud upravujete nebo vytváříte nové téma pozdravu, měli byste zahrnout nějaký druh indikace, že uživatel mluví s agentem (nebo "virtuálním agentem"). Taková indikace pomůže uživateli pochopit, že nemluví s člověkem.

Doporučujeme upravit systémový pozdrav téma, abyste nemuseli upravovat kód index.html.

  1. V navigační nabídce vyberte Témataa poté vyberte řádek tématu Pozdrav.

    Snímek obrazovky stránky Témata se zvýrazněným tématem Pozdrav.

  2. Upravte text v uzlech Zpráva. Můžete také přidat nebo odstranit další uzly.

  3. Zvolte Uložit.

  4. Publikujte agenta.

Nyní můžete svého agenta otestovat tak, že přejdete na webovou stránku, kde jste nasadili vlastní plátno agenta. Uvidíte, že kopilot zahájí konverzaci automatickým zobrazením tématu pozdravu.

Vytvoření nového tématu uživatele

Upozorňující

Použití uživatelského tématu k zahájení konverzace zvýší počet účtovaných relací. Fakturovaná relace je interakce mezi zákazníkem a agentem a představuje jednu jednotku spotřeby. Účtovaná relace začíná, když je spuštěno uživatelské téma. Další informace viz Správa kapacity zpráv.

  1. V navigační nabídce vyberte Témata.

  2. Vyberte Nové téma a pojmenujte ho.

  3. Přidejte text dovnitř uzlu Zpráva.

  4. Vyberte Uložit, až dokončíte úpravy zprávy.

  5. V navigační nabídce vyberte Témataa poté vyberte řádek tématu Pozdrav.

  6. Odstraňte uzly zpráv v tématu Pozdrav.

  7. Chcete-li, aby byl agent automaticky přesměrován do uživatelského tématu, vyberte Přidat uzel (+) pro přidání uzlu a poté přejděte na jiné téma.

  8. V plovoucí nabídce vyberte uživatelské téma, které jste vytvořili výše.

  9. Jakmile dokončíte úpravy zprávy, vyberte Uložit.

  10. Publikujte agenta.

Nyní můžete svého agenta otestovat tak, že přejdete na webovou stránku, kde jste nasadili vlastní plátno agenta. Uvidíte, že agent zahájí konverzaci automatickým zobrazením nového tématu.