Udostępnij za pośrednictwem

Automatyczne rozpoczynanie konwersacji agent

  • Artykuł

Możesz skonfigurować swój agent tak, aby rozpocząć konwersację z użytkownikiem. Możesz także połączyć spersonalizowane powitanie z dostosowaniem do wyglądu i stylu agent.

Ważne

Rozpoczęcie rozmowy przez agent pojawia się w statystykach i zwiększa liczbę sesji.

Jeśli użytkownik Twojego agent nie wejdzie w interakcję z agent (na przykład wczyta stronę, ale nie o nic agent), sesja zostanie oznaczona jako sesja bez zaangażowania. To może wpłynąć na analizy.

Domyślnie agenci utworzeni za pomocą Copilot Studio witryny internetowej i opublikowani w niej są wczytywani bez powitania i pasywnie czekają, aż użytkownik rozpocznie konwersację.

Możesz jednak użyć kodu niestandardowego CSS i kodu JavaScript, aby agent automatycznie rozpoczynał konwersację po załadowaniu agent. Na przykład możesz sprawić, że Twój agent powie "Cześć, jestem Botty, a agent wirtualny", gdy tylko agent się załaduje.

Najpierw należy uruchomić kanwę niestandardową zawierają argumenty uruchamiające powitanie. Domyślnie na kanwie niestandardowej jest wywoływany domyślny systemowy temat powitalny. Można jednak utworzyć nowy temat, który będzie używany jako powitanie. Należy przekierować domyślny systemowy temat powitania do nowego tematu.

Ważne

Przykładowy kod zawarty w tej dokumentacji można zainstalować i używać wyłącznie do użytku z produktem Copilot Studio . Przykładowy kod jest licencjonowany „tak jak jest” i nie dotyczą go żadne umowy odnoszące się do poziomu usług lub usług pomocy technicznej. Ryzyko korzystania z niniejszego dokumentu ponosi użytkownik.

Firma Microsoft nie udziela żadnych wyraźnych rękojmi, warunków ani gwarancji i wyłącza użycie wszelkich domniemanych gwarancji, w tym dotyczących zbywalności, przydatności do określonego celu oraz nienaruszania praw osób trzecich.

Pobierz punkt końcowy tokena

Aby dostosować płótno, niezależnie od tego, czy jest to płótno domyślne, czy niestandardowe, z którym się łączysz, musisz pobrać szczegóły agent.

  1. W menu nawigacji w sekcji Ustawienia wybierz Kanały.

  2. Wybierz opcję Aplikacja mobilna.

    Zrzut ekranu przedstawiający kafelek kanału aplikacji mobilnej.

  3. Obok opcji Punkt końcowy tokenu wybierz opcję Kopiuj.

    Zrzut ekranu przedstawiający identyfikator tokenu punktu końcowego.

Dostosuj kanwę domyślną (proste)

Skonfiguruj sposób, w jaki kanwa czatu będzie wyglądała za pomocą prostych opcji stylów CSS i języka JavaScript.

Najpierw trzeba skonfigurować, w którym miejscu umieszczona zostanie kanwa bota.

  1. Utwórz i opublikuj agent.

  2. Skopiuj i wklej wyświetlany tutaj kod HTML i zapisz go jako index.html.
    Można także skopiować kod i wkleić go do edytora kodu HTML w3schools.com. Nadal trzeba dodać punkt końcowy 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. W utworzonym pliku index.html wprowadź swój punkt końcowy tokena w wierszu var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Otwórz index.html przy użyciu nowoczesnej przeglądarki (na przykład), Microsoft Edge aby otworzyć agent na niestandardowej kanwie.

  5. Przetestuj agent, aby upewnić się, że otrzymujesz odpowiedzi od swojego agent i że agent działa poprawnie.

    Jeśli napotkasz problemy, upewnij się, że opublikowałeś swój agent i że punkt końcowy tokenu jest wstawiony we właściwym miejscu. Punkt końcowy tokenu powinien być po znaku równości (=) w wierszu var theURL = "<YOUR TOKEN ENDPOINT>" i w otoczeniu cudzysłowów (").

Zmienianie domyślnego powitania agent

Kod w pliku index.html powoduje, że temat jest wywoływany automatycznie po załadowaniu agent. Domyślnie kod wywołuje systemowy temat powitalny. Istnieje również możliwość utworzenia nowego tematu i przekierowania domyślnego systemowego tematu powitalnego do nowego tematu.

W obu przypadkach wprowadzasz zmiany w temacie, który chcesz wywołać tak jak zwykle.

Jeśli zmodyfikujesz lub utworzysz nowy temat powitania, powinieneś dołączyć jakąś wskazówkę, że użytkownik rozmawia z agent (lub "agent wirtualny"). Takie wskazanie pomoże użytkownikowi zrozumieć, że nie rozmawia z ludźmi.

Zalecamy zmodyfikowanie domyślnego systemowego tematu powitalnego, aby nie trzeba było edytować kodu pliku index.html.

  1. W menu nawigacji wybierz opcję Tematy, a następnie wiersz tematu Powitanie.

    Zrzut ekranu przedstawiający stronę tematów z wyróżnionym tematem powitalnym.

  2. Dokonaj edycji tekstu znajdującego się w węzłach wiadomości. Istnieje również możliwość dodawania lub usuwania dodatkowych węzłów.

  3. Wybierz pozycję Zapisz.

  4. Opublikuj swój agent.

Teraz możesz przetestować swój agent, przechodząc do strony internetowej, na której wdrożono niestandardowe płótno agent. Zobaczysz, jak bot rozpoczyna konwersację, automatycznie pokazując temat powitalny.

Tworzenie nowego tematu użytkownika

Ostrzeżenie

Korzystanie z tematu użytkownika w celu rozpoczęcia konwersacji spowoduje zwiększenie liczby sesji rozliczonych. Rozliczana sesja to interakcja między klientem a agent i reprezentuje jedną jednostkę zużycia. Sesja rozliczona zaczyna się w momencie, gdy zostanie wyzwolony temat użytkownika. Aby uzyskać więcej informacji, zobacz temat Wyświetl rozliczone sesje (wersja zapoznawcza).

  1. W menu nawigacji wybierz Tematy.

  2. Wybierz opcję Nowy temat i nadaj jej nazwę.

  3. Dodaj tekst w węźle wiadomości.

  4. Po zakończeniu edytowania wiadomości wybierz pozycję Zapisz.

  5. W menu nawigacji wybierz opcję Tematy, a następnie wiersz tematu Powitanie.

  6. Usuń węzły wiadomości w temacie powitalnym.

  7. Aby automatycznie przekierować agent do temat użytkownika, wybierz pozycję Dodaj węzeł ( ), aby dodać węzeł+, a następnie przejdź do innego temat.

  8. W menu z oknem wysuwanym wybierz utworzony wcześniej temat użytkownika.

  9. Wybierz pozycję Zapisz po zakończeniu edytowania komunikatu.

  10. Opublikuj swój agent.

Teraz możesz przetestować swój agent, przechodząc do strony internetowej, na której wdrożono niestandardowe płótno agent. Możesz zobaczyć agent rozpocząć rozmowę, automatycznie pokazując nową temat.