Intent bawaan (Dialogflow)

Intent bawaan adalah ID unik yang dapat Anda tentukan untuk memberi tahu Asisten Google bahwa Action Anda dapat memenuhi kategori permintaan pengguna tertentu. Misalnya, berikut beberapa contoh kueri pengguna yang cocok dengan Asisten dengan intent bawaan:

• Intent bawaan"Mainkan game": "Ok Google. Mainkan game memori"
• Niat bawaan"Dapatkan horoskop": "Ok Google. Dapatkan horoskopku"

Selama Penemuan Action, Asisten dapat menggunakan metadata tentang Action Anda, termasuk intent bawaan yang telah Anda tentukan, untuk merekomendasikan Action kepada pengguna. Untuk meminimalkan perjalanan bolak-balik percakapan, Asisten juga mencoba memindai parameter dari kueri pengguna dan meneruskannya ke Action.

Untuk melihat daftar lengkap intent bawaan yang didukung Asisten, termasuk parameternya dan contoh kueri pengguna, lihat Referensi intent bawaan.

Mengintegrasikan intent bawaan

Bergantung pada cara Anda membuat Action, ada berbagai cara untuk mengintegrasikan intent bawaan.

Dialogflow

Jika menggunakan Dialogflow untuk membuat Action, Anda dapat melampirkan intent bawaan secara grafis dari konsol Dialogflow.

Untuk melampirkan intent bawaan dengan Dialogflow, ikuti langkah-langkah berikut:

1. Buka konsol Dialogflow, pilih agen Anda, lalu buka layar Intent.

2. Buat atau pilih intent yang dipicu agen Anda saat menerima intent bawaan tertentu. Buka bagian Peristiwa, lalu klik Tambahkan Peristiwa.

   

3. Di kolom Events, ketik nama peristiwa intent bawaan untuk agen Anda (misalnya, actions_intent_PLAY_GAME).

   

4. Klik Simpan.

Actions SDK

Jika menggunakan Actions SDK untuk membuat Action, Anda harus menentukan pemetaan antara intent bawaan dan Action dalam paket Action Anda.

Untuk melampirkan intent bawaan dengan Actions SDK, ikuti langkah-langkah berikut:

1. Tentukan intent bawaan di kolom nama dalam definisi Action Anda.
2. Upload paket tindakan Anda ke project Action menggunakan alat gactions, seperti yang dijelaskan dalam Ringkasan Action SDK.

Misalnya, cuplikan berikut menunjukkan cara menambahkan intent bawaan CHECK_AIR_QUALITY:

{
   "actions":[
      {
         "description":"Default Welcome Intent",
         "name":"MAIN",
         "fulfillment":{
            "conversationName":"conversation_1"
         },
         "intent":{
            "name":"actions.intent.MAIN"
         }
      },
      {
         "description":"Check Air Quality",
         "name":"CHECK_AIR_QUALITY",
         "fulfillment":{
            "conversationName":"conversation_1"
         },
         "intent":{
            "name":"actions.intent.CHECK_AIR_QUALITY"
         }
      }
   ],
   "conversations":{
      "conversation_1":{
         "name":"conversation_1",
         "url":"https://example.com/fulfillment",
         "fulfillmentApiVersion":2
      }
   }
}

Menangani parameter intent bawaan

Saat Action dipanggil melalui intent bawaan, fulfillment Anda mungkin menerima parameter tambahan. Skema intent menentukan nama parameter dan jenisnya sebagai jenis primitif atau entity schema.org. Untuk melihat skema intent bawaan Action Percakapan, lihat Referensi intent bawaan.

Parameter untuk intent bawaan bersifat opsional. Asisten menangani pengisian parameter dengan nilai jika nilai tersebut dapat diekstrak dari pemanggilan intent bawaan pengguna.

Misalnya, skema intent bawaan actions.intent.CHECK_AIR_QUALITY menentukan empat parameter opsional:

Cuplikan kode berikut menampilkan contoh permintaan webhook percakapan (JSON) saat pengguna memanggil Action Anda dengan mengatakan "Berapa kualitas udara di San Francisco besok?":

"inputs":[
      {
         "intent":"actions.intent.CHECK_AIR_QUALITY",
         "rawInputs":[
            {
               "inputType":"VOICE",
               "query":"what is the air quality in san francisco tomorrow"
            }
         ],
         "arguments":[
            {
               "name":"location",
               "structuredValue":{
                  "geo":{
                     "longitude":-122.41941550000001,
                     "latitude":37.7749295
                  },
                  "@context":"https://schema.org",
                  "@type":"Place",
                  "name":"san francisco"
               }
            },
            {
               "name":"temporalCoverage",
               "rawText":"2018-04-25",
               "textValue":"2018-04-25"
            }
         ]
      }
   ]

Dalam contoh ini, parameter mengambil nilai berikut:

• Parameter location berisi nilai schema.org/Place untuk "San Francisco".
• Parameter temporalCoverage berisi nilai schema.org/Duration untuk tanggal besok yang relatif terhadap waktu pemanggilan.
• Tidak ada nilai untuk parameter attributes dan timeIndicator karena frasa panggilan pengguna tidak menyertakan informasi tersebut.

Jika Anda menggunakan Library Klien Actions on Google untuk Node.js, Anda dapat mengambil nilai parameter seperti yang ditunjukkan dalam cuplikan berikut:

app.intent('actions.intent.CHECK_AIR_QUALITY', (conv) => {
  const attributes = conv.arguments.get('attributes');
  const location = conv.arguments.get('location');
  const temporal_coverage = conv.arguments.get('temporalCoverage');
  Const time_indicator = conv.arguments.get('timeIndicator')

  // Your Action logic. If you need to use any of the parameter values,
  // you should check first that it is defined. Arguments.get returns
  // undefined if it can't find a value for a parameter.

});

Menguji integrasi dengan intent bawaan

Ikuti langkah-langkah berikut untuk menguji integrasi Anda:

1. Buka simulator Action dengan Action pengujian diaktifkan, atau buka Asisten di perangkat Anda.
2. Ucapkan atau ketik kueri yang terkait dengan intent bawaan tersebut. Misalnya, “Saya ingin bermain game”.
3. Dari dialog pemilihan aplikasi yang ditampilkan, temukan Action Anda.
4. Pilih aplikasi Anda untuk mengirimkan intent ke aplikasi Anda.

Praktik terbaik untuk menggunakan intent bawaan

Anda harus mengikuti praktik terbaik ini saat menggunakan intent bawaan:

• Memetakan intent bawaan ke tindakan tertentu: Jika intent bawaan tertentu memicu Action Anda, arahkan pengguna ke intent dan fungsi spesifik dalam Action Anda dengan sesedikit mungkin hambatan. Misalnya, jika Action Anda mendukung intent bawaan PLAY_GAME dan menerima intent tersebut, Anda harus segera mengarahkan pengguna ke fitur game Action Anda. Hindari menanyakan lagi kepada pengguna apakah mereka ingin bermain game.
• Menangani parameter intent bawaan: Pastikan untuk menggunakan parameter value intent bawaan yang dikirim Asisten ke fulfillment Anda. Hindari meminta ulang nilai tersebut kepada pengguna.