Bagikan melalui

Memulai percakapan agen secara otomatis

  • Artikel

Anda dapat mengonfigurasi agen Anda untuk memulai percakapan percakapan dengan pengguna. Anda juga dapat menggabungkan salam yang disesuaikan dengan penyesuaian tampilan dan nuansa agen.

Penting

Membuat agen memulai percakapan muncul di analitik Anda dan meningkatkan jumlah sesi Anda.

Jika pengguna agen Anda tidak berinteraksi dengan agen (misalnya, mereka memuat halaman tetapi tidak menanyakan apa pun kepada agen), sesi ditandai sebagai sesi yang tidak terlibat. Hal ini dapat berdampak pada analisis Anda.

Secara default, agen yang dibuat dengan dan Copilot Studio dipublikasikan ke situs web dimuat tanpa salam, dan secara pasif menunggu pengguna memulai percakapan.

Namun, Anda dapat menggunakan kode kustom CSS dan JavaScript agar agen memulai percakapan secara otomatis saat agen dimuat. Misalnya, Anda dapat meminta agen Anda mengatakan, "Hai, saya Botty, agen virtual" segera setelah agen dimuat.

Pertama, Anda perlu menyebarkan kanvas kustom yang menyertakan argumen yang memicu salam. Secara default, kanvas kustom memanggil topik salam sistem default. Namun, Anda dapat membuat topik baru untuk digunakan sebagai salam. Anda perlu mengalihkan topik salam sistem default ke topik baru.

Penting

Anda dapat menginstal dan menggunakan kode sampel yang disertakan dalam dokumentasi ini hanya untuk digunakan dengan Copilot Studio produk. Kode sampel dilisensikan "sebagaimana adanya" dan dikecualikan dari perjanjian tingkat layanan atau layanan dukungan. Anda menanggung risiko penggunaan.

Microsoft tidak memberikan jaminan, garansi, atau ketentuan tersurat dan mengecualikan semua jaminan tersirat, termasuk kelayakan untuk diperdagangkan, kesesuaian untuk tujuan tertentu, dan tidak adanya pelanggaran.

Ambil titik akhir token

Untuk menyesuaikan kanvas Anda, baik itu kanvas default atau kanvas kustom yang Anda sambungkan, Anda perlu mengambil detail agen Anda.

  1. Di menu navigasi di bawah Pengaturan, pilih Saluran.

  2. Pilih Aplikasi seluler.

    Cuplikan layar ubin saluran aplikasi seluler.

  3. Di samping Titik Akhir Token, pilih Salin.

    Screenshot id token titik akhir.

Sesuaikan kanvas default (sederhana)

Konfigurasikan tampilan kanvas obrolan dengan beberapa opsi gaya JavaScript dan sederhana CSS .

Pertama, Anda harus mengkonfigurasi tempat Anda menyebarkan kanvas bot Anda.

  1. Buat dan publikasikan agen.

  2. Salin dan tempel kode HTML yang ditampilkan di sini dan simpan sebagai index.html.
    Anda juga dapat menyalin dan menempelkan kode ke dalam editor coba HTML w3schools.com. Anda masih perlu menambahkan titik akhir token Anda.

    <!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. Dalam file index.html yang Anda buat, masukkan titik akhir token Anda di baris var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Buka index.html menggunakan browser modern (misalnya,) Microsoft Edge untuk membuka agen di kanvas kustom.

  5. Uji agen untuk memastikan bahwa Anda menerima respons dari agen Anda dan bahwa agen berfungsi dengan benar.

    Jika Anda mengalami masalah, pastikan Anda telah menerbitkan agen Anda, dan bahwa titik akhir token Anda dimasukkan di tempat yang benar. Titik akhir token harus berada setelah tanda sama dengan (=) pada garis var theURL = "<YOUR TOKEN ENDPOINT>", dan dikelilingi oleh tanda kutip ganda (").

Mengubah salam default agen

Kode dalam file index.html menyebabkan topik dipanggil secara otomatis saat agen dimuat. Secara default, kode memanggil topik salam sistem. Anda juga dapat membuat topik baru dan mengalihkan topik salam sistem default ke topik baru tersebut.

Dalam kedua kasus tersebut, Anda membuat perubahan pada topik yang ingin Anda panggil seperti biasanya.

Jika Anda memodifikasi atau membuat topik ucapan baru, Anda harus menyertakan semacam indikasi bahwa pengguna sedang berbicara dengan agen (atau "agen virtual"). Indikasi seperti itu akan membantu pengguna memahami bahwa mereka tidak berbicara dengan manusia.

Kami menyarankan Anda memodifikasi topik ucapan sistem sehingga Anda tidak perlu mengedit kode index.html .

  1. Di menu navigasi, pilih Topik, lalu pilih baris topik salam.

    Screenshot halaman Topik, dengan topik Salam disorot.

  2. Edit teks di dalam simpul Pesan . Anda juga dapat menambahkan atau menghapus node tambahan.

  3. Pilih Simpan.

  4. Publikasikan agen Anda.

Anda sekarang dapat menguji agen Anda dengan membuka halaman web tempat Anda menyebarkan kanvas kustom agen Anda. Anda dapat melihat bot memulai percakapan dengan secara otomatis menampilkan topik salam.

Buat topik Pengguna baru

Peringatan

Menggunakan topik pengguna untuk memulai percakapan akan meningkatkan sesi yangditagih. Sesi yang ditagih adalah interaksi antara pelanggan dan agen dan mewakili satu unit konsumsi. Sesi yang ditagih dimulai saat topik pengguna dipicu. Untuk informasi selengkapnya, lihat Mengelola kapasitas pesan.

  1. Di menu navigasi, pilih Topik.

  2. Pilih Topik baru, dan beri nama.

  3. Tambahkan teks di dalam simpul Message .

  4. Pilih Simpan setelah Anda selesai mengedit pesan.

  5. Di menu navigasi, pilih Topik, lalu pilih baris topik salam.

  6. Hapus simpul pesan pada topik Salam.

  7. Untuk secara otomatis mengalihkan agen ke topik pengguna, pilih Tambahkan node (+) untuk menambahkan node, lalu Buka topik lain.

  8. Di menu flyout, pilih pengguna topik yang anda buat di atas.

  9. Pilih Simpan setelah Anda selesai mengedit pesan.

  10. Publikasikan agen Anda.

Anda sekarang dapat menguji agen Anda dengan membuka halaman web tempat Anda menyebarkan kanvas kustom agen Anda. Anda dapat melihat agen memulai percakapan dengan menampilkan topik baru secara otomatis.