Panduan memulai: Fulfillment

Panduan ini menunjukkan cara mengintegrasikan agen dengan layanan menggunakan fulfillment. Dengan mengintegrasikan layanan, Anda dapat mengambil tindakan berdasarkan ekspresi pengguna akhir dan mengirim respons dinamis kembali ke pengguna akhir.

Sebelum memulai

Jika tidak berencana menggunakan fulfillment, Anda dapat melewati panduan memulai ini.

Langkah-langkah ini menggunakan Cloud Functions dan mengasumsikan pengetahuan Node.js dasar. Jika Anda ingin membuat fulfillment menggunakan server Anda sendiri atau bahasa lain, lihat dokumentasi fulfillment yang lebih mendetail.

Anda harus melakukan hal berikut sebelum membaca panduan ini:

  1. Baca Dasar-dasar Dialogflow.
  2. Lakukan langkah-langkah penyiapan.
  3. Lakukan langkah-langkah dalam panduan memulai Mem-build agen. Langkah-langkah di bawah ini akan terus bekerja pada agen yang sama. Jika tidak lagi memiliki agen tersebut, Anda dapat mendownload build-agent-quickstart.zip dan mengimpor file.

Editor inline

Konsol Dialogflow memiliki editor kode bawaan, yang disebut editor langsung yang dapat Anda gunakan untuk membuat kode fulfillment dan men-deploy kode ke Cloud Functions. Cloud Functions memiliki tagihan terkait, tetapi layanan ini tersedia tanpa biaya hingga jumlah pemanggilan bulanan yang signifikan. Perhatikan bahwa Anda masih harus mendaftar dan memberikan akun penagihan yang valid. Batalkan kapan saja.

Saat Anda pertama kali mengaktifkan editor inline, kode fulfillment Node.js akan diisi otomatis dengan pengendali default untuk intent default yang disertakan untuk semua agen. Kode ini juga memiliki petunjuk berkomentar untuk menambahkan pengendali untuk intent yang ditentukan developer.

Editor inline ditujukan untuk pengujian dan pembuatan prototipe fulfillment sederhana. Setelah siap mem-build aplikasi produksi, Anda harus membuat layanan webhook.

Mengaktifkan dan men-deploy fulfillment dengan Editor Inline

Untuk mengaktifkan dan men-deploy kode fulfillment default menggunakan Editor Inline:

  1. Klik Fulfillment di menu sidebar kiri.
  2. Alihkan Inline Editor ke Enabled.
  3. Jika Anda tidak mengaktifkan penagihan di langkah penyiapan, Anda akan diminta untuk mengaktifkan penagihan sekarang. Cloud Functions memiliki tagihan terkait, tetapi layanan ini tersedia tanpa biaya hingga jumlah pemanggilan bulanan yang signifikan. Perhatikan bahwa Anda tetap harus mendaftar dan memberikan akun penagihan. Batalkan kapan saja.
  4. Klik Deploy di bagian bawah formulir, dan tunggu hingga dialog menunjukkan bahwa fungsi telah di-deploy.

Untuk setiap intent yang memerlukan fulfillment, Anda harus mengaktifkan fulfillment untuk intent tersebut. Untuk mengaktifkan fulfillment untuk Intent Selamat Datang Default:

  1. Klik Intent di menu sidebar kiri.
  2. Klik Default Welcome Intent.

  3. Scroll ke bawah ke bagian Fulfillment, lalu aktifkan Enable webhook call for this intent.

  4. Klik tombol Save dan tunggu hingga dialog Agent Training menunjukkan bahwa pelatihan telah selesai.

Sekarang Anda dapat menguji fulfillment di simulator. Masukkan Hi di simulator, dan simulator akan merespons dengan Welcome to my agent!. Respons ini dikirim dari webhook fulfillment yang baru saja Anda deploy. Secara khusus, respons berasal dari kode ini:

function welcome(agent) {
  agent.add(`Welcome to my agent!`);
}

Membuat pengendali fulfillment kustom

Langkah-langkah di atas menggunakan pengendali yang disediakan oleh kode editor inline default. Untuk membuat pengendali kustom:

  1. Aktifkan fulfillment untuk intent get-agent-name yang Anda buat di langkah sebelumnya.
  2. Klik Fulfillment di menu sidebar kiri, dan periksa kode di editor inline.

  3. Temukan baris ini:

    exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => {

    Fungsi onRequest menangani semua permintaan dari Dialogflow. Dalam isi fungsi ini, fungsi pengendali tertentu ditentukan. Fungsi pengendali ini dipanggil saat intent terkait dicocokkan. Misalnya, fungsi yang digunakan di bagian sebelumnya adalah function welcome(agent).

  4. Di bawah pengendali yang ada, tambahkan fungsi ini untuk intent get-agent-name:

    function getAgentNameHandler(agent) {
  agent.add('From fulfillment: My name is Dialogflow!');
}

  5. Di bawah definisi fungsi pengendali, terdapat panggilan intentMap.set(). Panggilan ini mengaitkan pengendali tertentu dengan intent berdasarkan namanya. Misalnya, intentMap.set('Default Welcome Intent', welcome) mengaitkan pengendali welcome dengan intent bernama Default Welcome Intent.

  6. Di bawah panggilan intentMap.set yang ada, tambahkan baris ini untuk intent get-agent-name:

    intentMap.set('get-agent-name', getAgentNameHandler);

  7. Klik Deploy di bagian bawah formulir.

  8. Masukkan What's your name? di simulator. Respons From fulfillment: My name is Dialogflow! dikirim dari pengendali baru Anda.

Mengakses parameter value

Pada langkah sebelumnya, Anda telah membuat intent set-language untuk mengidentifikasi bahasa manusia dan pemrograman. Intent menggunakan parameter language dan language-programming. Di bagian ini, Anda akan mengakses nilai untuk parameter ini di pengendali fulfillment.

Untuk menambahkan pengendali:

  1. Aktifkan fulfillment untuk intent set-language.
  2. Klik Fulfillment di menu sidebar kiri.

  3. Serupa dengan langkah-langkah di atas, tambahkan pengendali dan panggilan intentMap berikut:

    function languageHandler(agent) {
    const language = agent.parameters.language;
    const programmingLanguage = agent.parameters['language-programming'];
    if (language) {
        agent.add(`From fulfillment: Wow! I didn't know you knew ${language}`);
    } else if (programmingLanguage) {
        agent.add(`From fulfillment: ${programmingLanguage} is cool`);
    } else {
        agent.add(`From fulfillment: What language do you know?`);
    }
}

    intentMap.set('set-language', languageHandler);

  4. Klik Deploy.

Pengendali ini mengambil parameter language dan language-programming dan menyimpannya dalam variabel. Fungsi ini mengambil nilai ini dari atribut agent.parameters, yang merupakan objek yang berisi semua nama dan nilai parameter yang ditentukan pengguna akhir dalam permintaan mereka.

Untuk mencobanya, masukkan I know how to speak German di simulator.

Sebelumnya
Membuat agen
Berikutnya
Interaksi dengan integrasi