Bagikan melalui

Koneksi bot ke Alexa

  • Artikel

BERLAKU UNTUK: SDK v4

Anda dapat mengonfigurasi bot Anda untuk berkomunikasi dengan orang-orang melalui keterampilan kustom Alexa. Artikel ini menjelaskan cara membuat keterampilan Alexa menggunakan Alexa Developer Console, menghubungkan bot Anda ke keterampilan Alexa Anda di Azure, dan menguji bot Anda di Alexa.

Prasyarat

  • Langganan Azure. Jika Anda belum memilikinya, buat akun gratis sebelum memulai.
  • Bot yang diterbitkan ke Azure yang ingin Anda sambungkan ke Alexa.
  • Akun Amazon.

Penting

Bot Anda harus menggunakan Bot Framework SDK versi 4.8 atau yang lebih baru. Jika Anda memiliki bot yang sudah ada, Anda mungkin perlu memperbarui versi SDK dan menerbitkan ulang bot Anda.

Membuat keterampilan Alexa

  1. Masuk ke Konsol Pengembang Alexa dan pilih Buat Keterampilan.

  2. Pada halaman berikutnya:

    1. Masukkan nama untuk keterampilan baru Anda.
    2. Pastikan bahwa Pilih model untuk ditambahkan ke keterampilan Anda diatur ke Kustom.
    3. Pastikan bahwa Pilih metode untuk menghosting sumber daya backend keterampilan Anda diatur ke Provisikan milik Anda sendiri.
    4. Pilih Buat Keterampilan.

    Choose model and hosting

  3. Pada halaman berikutnya:

    1. Pastikan bahwa Pilih templat diatur ke Mulai dari awal
    2. Klik Pilih.

    Choose a template

  4. Pada dasbor keterampilan Anda di bawah Model Interaksi, pilih Editor JSON.

  5. Di editor JSON:

    1. Ganti konten yang ada dengan JSON berikut.

      {
    "interactionModel": {
        "languageModel": {
            "invocationName": "<your-skill-invocation-name>",
            "intents": [
                {
                    "name": "GetUserIntent",
                    "slots": [
                        {
                            "name": "phrase",
                            "type": "phrase"
                        }
                    ],
                    "samples": [
                        "{phrase}"
                    ]
                },
                {
                    "name": "AMAZON.StopIntent",
                    "samples": []
                }
            ],
            "types": [
                {
                    "name": "phrase",
                    "values": [
                        {
                            "name": {
                                "value": "<example-phrase>"
                            }
                        },
                        {
                            "name": {
                                "value": "<example-phrase>"
                            }
                        },
                        {
                            "name": {
                                "value": "<example-phrase>"
                            }
                        }
                    ]
                }
            ]
        }
    }
}

    2. Untuk invocationName, ubah <nama> pemanggilan keterampilan Anda menjadi nama yang akan digunakan pengguna untuk memanggil keterampilan Anda pada Alexa. Misalnya, jika nama pemanggilan keterampilan Anda adalah "pembantu adaptor", maka pengguna dapat mengatakan "Alexa, meluncurkan pembantu adaptor" untuk meluncurkan keterampilan.

    3. Dalam array di values bawah types, ganti tiga instans <example-phrase> dengan frasa yang dapat dikatakan pengguna untuk memicu keterampilan Anda. Misalnya, jika pengguna mengatakan "Alexa, minta pembantu adaptor untuk memberi saya detail adaptor alexa", salah satu contoh frasa bisa menjadi "beri saya detail adaptor alexa".

  6. Pilih Simpan Model, lalu pilih Bangun Model. Ini memperbarui konfigurasi keterampilan Anda pada Alexa.

Mengonfigurasi bot Anda di Azure

Untuk menyelesaikan langkah ini, Anda memerlukan ID Keterampilan Alexa Anda. Dapatkan ID baik dari URL di portal Alexa atau dengan masuk ke Konsol Pengembang Alexa dan pilih Salin ID Keterampilan. ID Keterampilan Alexa Anda harus menjadi nilai seperti "amzn1.ask.skill.<beberapa-guid>".

  1. Buka portal Microsoft Azure.
  2. Buka bilah sumber daya Azure Bot untuk bot Anda.
  3. Buka Saluran dan pilih Alexa.
  4. Di Konfigurasi Saluran Alexa, masukkan informasi yang Anda salin di langkah sebelumnya.
    1. Di Masukkan Id keterampilan, masukkan ID keterampilan Alexa yang Anda salin dari Konsol Pengembang Alexa.
    2. Pilih Terapkan.
    3. Salin URI titik akhir layanan Alexa yang dihasilkan Azure.

Memperbarui pendaftaran bot Alexa Anda

  1. Masuk ke Konsol Pengembang Alexa.

  2. Temukan dan buka halaman konfigurasi keterampilan Anda.

  3. Pilih Titik Akhir.

  4. Untuk Jenis Titik Akhir Layanan, pilih HTTPS.

  5. Untuk Wilayah Default:

    1. Masukkan URI titik akhir layanan Alexa yang Anda salin dari portal Azure.
    2. Di menu drop-down, pilih Titik akhir pengembangan saya adalah sub-domain domain yang memiliki sertifikat wildcard dari otoritas sertifikat.

    Set service endpoint and endpoint type

  6. Pilih Simpan Titik Akhir.

Menguji dan menerbitkan keterampilan Anda

Jika Anda memiliki perangkat Alexa, Anda dapat menguji keterampilan Anda sebelum menerbitkannya.

Lihat dokumentasi pengembang Alexa Skills Kit untuk keterampilan model suara kustom untuk informasi tentang cara menguji dan menerbitkan keterampilan Anda di platform mereka.

Informasi Tambahan

Untuk informasi selengkapnya tentang keterampilan Alexa, lihat dokumentasi pengembang Amazon:

Autentikasi pengguna di Alexa

Autentikasi pengguna di Alexa dilakukan dengan menyiapkan dan menggunakan Tautan Akun pada keterampilan Alexa. Untuk informasi selengkapnya, lihat Memahami Penautan Akun untuk Keterampilan Alexa. Anda dapat memerlukan penautan akun saat pengguna mengaktifkan keterampilan, atau Anda dapat mewajibkannya sebagai bagian dari alur percakapan.

Jika Anda menambahkan autentikasi pengguna sebagai bagian dari percakapan:

  1. Lampirkan kartu masuk pada aktivitas keluar. Ini akan dikonversi ke kartu Alexa LinkAccount yang meminta pengguna untuk masuk menggunakan aplikasi Alexa.

  2. Jika pengguna berhasil menautkan akun mereka ke dalam aplikasi, token kemudian tersedia pada permintaan berikutnya dalam data saluran.

Langkah berikutnya