Share via

Automatycznie rozpoczynanie konwersacji

  • Artykuł

Ważne

Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.

Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.

Można skonfigurować pomocnika do uruchamiania rozmowy z użytkownikiem. Można również połączyć dostosowane powitanie z dostosowaniem do wyglądu i sposobu działania bota.

Ważne

Rozpoczynanie konwersacji przez pomocnika będzie wyświetlane w analityce i spowoduje zwiększenie liczby sesji.

Jeśli użytkownik pomocnika nie nawiązał kontaktu z pomocnikiem (na przykład załadował stronę, ale nie pytał o nic pomocnika), sesja będzie oznaczona jako sesja bez interakcji. To może wpłynąć na analizy.

Domyślnie pomocnicy utworzeni w Microsoft Copilot Studio i opublikowani w witrynie sieci Web ładują się bez powitania, a następnie pasywnie czekają, aż użytkownik rozpocznie rozmowę.

Można jednak użyć niestandardowego kodu CSS i JavaScript, aby pomocnik uruchamiał rozmowę automatycznie po załadowaniu. Na przykład zaraz po załadowaniu pomocnik może powiedzieć „Cześć, nazywam się Botty, agent wirtualny”.

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 dołączony do niniejszej dokumentacji można zainstalować i wykorzystać wyłącznie w celu użycia go z produktem Microsoft 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ć kanwę, niezależnie od tego, czy jest to kanwa domyślna czy niestandardowa, z którą się łączysz, należy pobrać informacje szczegółowe o pomocniku.

  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. Tworzenie i publikowanie bota.

  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, używając nowoczesnej przeglądarki (na przykład Microsoft Edge), aby otworzyć pomocnika na kanwie niestandardowej.

  5. Przetestuj pomocnika, aby mieć pewność, że otrzymujesz od niego odpowiedzi i że pomocnik działa poprawnie.

    W przypadku napotkania problemów upewnij się, że pomocnik został opublikowany i że urządzenie końcowe dla tokenu jest wstawione w poprawnym 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 (").

Zmiana domyślnego powitania pomocnika

Kod w pliku index.html powoduje, że tematy są wywoływane automatycznie po załadowaniu pomocnika. 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 użytkownik zmodyfikuje lub utworzy nowy temat z powitaniem powinien zawierać jakieś wskazanie, że użytkownik rozmawia z pomocnikiem (czyli „agentem wirtualnym”). 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 swojego pomocnika.

Teraz można przetestować pomocnika, przechodząc na stronę sieci Web, na której wdrożono niestandardową kanwę pomocnika. 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. Sesja rozliczana to interakcja między klientem a pomocnikiem reprezentująca jedną jednostkę zużycia. Sesja rozliczona zaczyna się w momencie, gdy zostanie wyzwolony temat użytkownika. Aby uzyskać więcej informacji, zobacz temat Analizowanie informacji o sesjach rozliczanych.

  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 skierować pomocnika do tematu użytkownika, wybierz Dodaj węzeł (+) w celu dodania węzła, a następnie Przejdź do innego tematu.

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

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

  10. Opublikuj swojego pomocnika.

Teraz można przetestować pomocnika, przechodząc na stronę sieci Web, na której wdrożono niestandardową kanwę pomocnika. Zobaczysz, jak pomocnik rozpoczyna konwersację, automatycznie pokazując nowy temat.