Ringkasan Actions SDK (Dialogflow)

Actions on Google memungkinkan Anda memperluas fungsi Asisten Google dengan Actions. Action memungkinkan pengguna menyelesaikan berbagai hal melalui antarmuka percakapan yang dapat berkisar dari perintah cepat untuk menyalakan beberapa lampu atau percakapan yang lebih panjang, seperti bermain game trivia.

Actions SDK adalah metode pengembangan fulfillment percakapan tanpa menggunakan Dialogflow. Saat menggunakan Actions SDK, Anda menggunakan paket Action untuk memetakan intent ke fulfillment-nya. Anda juga harus menyediakan pola kueri dalam paket Action untuk menentukan contoh frasa yang mungkin diucapkan pengguna.

CLI gaksi

Saat mengembangkan dengan Actions SDK, Anda menggunakan antarmuka command line (CLI) gactions untuk menguji dan mengupdate project Actions. gactions CLI juga membantu Anda membuat dan mengelola paket Action untuk Action Percakapan Anda.

Membuat Action dalam paket Action Anda

Anda membuat Actions dalam paket Action Anda dengan memetakan intent ke fulfillment. Tindakan menentukan titik entri untuk memulai percakapan dengan ID unik yang disebut intent. Intent dipetakan ke fulfillment, yang memproses intent.

Misalnya, Anda ingin mem-build project yang berisi Actions untuk membeli beberapa barang, memeriksa status pesanan, dan menampilkan beberapa promo harian. Anda dapat menentukan intent yang dipicu dengan mengucapkan:

• "Ok Google, bicara dengan ExampleAction".
• "Ok Google, bicara dengan ExampleAction untuk membeli sepatu".
• "Ok Google, bicara dengan ExampleAction untuk memeriksa pesanan saya".
• "Ok Google, bicara dengan ExampleAction untuk menunjukkan promo hari ini".

File JSON paket Action akan terlihat seperti ini:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

Mem-build dan men-deploy webhook fulfillment

Saat Action dalam project Anda dipanggil, Actions on Google akan memanggil fulfillment Anda untuk memulai percakapan dengan pengguna untuk memenuhi Action.

Dalam setiap permintaan ke webhook fulfillment, Anda menerima input pengguna sebagai string teks. Untuk memproses intent, Anda biasanya mengurai input teks dan menampilkan respons. Pertukaran bolak-balik ini terjadi hingga percakapan Action Anda berakhir.

Mengupload paket Action Anda

Setelah membuat paket Action dan men-deploy fulfillment-nya, Anda dapat mengupload paket Action ke konsol Actions. Konsol Actions menggunakan project Action untuk mengelompokkan Action Percakapan Anda dengan metadata seperti status ulasan dan nama tampilan di direktori Asisten. Project ini juga memungkinkan Anda menentukan metadata tentang Action dan mengelola serta melacak Action Anda melalui proses persetujuan.

Setelah memiliki project, Anda dapat mengupload paket Action yang menentukan semua Action Anda menggunakan gactions CLI.

Kirim project Anda untuk mendapatkan persetujuan dan menyediakannya kepada pengguna

Contoh

Untuk mempelajari project yang sudah selesai, lihat contoh SDK Actions Node.js dan Java.