Referensi Canvas API interaktif

Interactive Canvas API adalah library JavaScript yang Anda gunakan untuk membuat antarmuka dengan Action Percakapan menggunakan objek interactiveCanvas di aplikasi web Anda.

Untuk informasi selengkapnya tentang Canvas Interaktif, lihat Kanvas Interaktif dokumentasi tambahan.

Metode

siap

ready(callbacks) returns undefined

Dipanggil oleh aplikasi web Canvas Interaktif setelah dimuat untuk mendaftarkan callback.

Parameter
callbacks InteractiveCanvasCallbacks

Objek yang berisi callback metode.

sendTextQuery

sendTextQuery(textQuery) returns Promise<state>

Mengirim kueri teks ke tindakan percakapan.

Parameter
textQuery string

Kueri yang akan dikirim ke tindakan percakapan.

state string

Salah satu dari berikut ini:

READY: Permintaan dapat disetujui oleh platform.

BLOCKED: Ada kueri yang sedang diproses dan kueri baru tersebut akan dihapus.

UNKNOWN: Status kueri saat ini tidak dapat ditentukan.

getHeaderHeightPx

getHeaderHeightPx() returns Promise<height>

Menentukan tinggi {i>header<i} di bagian atas tampilan.

Parameter
height number

Tinggi dalam piksel.

outputTts

outputTts(text, openMic) returns undefined;

Memutar teks SSML.

Parameter
text string

String yang didukung SSML untuk diputar.

openMic boolean

Apakah akan membuka mikrofon setelah TTS diputar.

createIntentHandler

createIntentHandler(intentId, callback) returns IntentHandler

Membuat pengendali intent untuk intent kustom NLU.

Parameter
intentId string

Nama intent seperti yang ditentukan dalam Action Builder.

callback function(MatchedIntent)

Fungsi yang akan dieksekusi saat intent cocok.

IntentHandler object

Objek pengendali intent yang dapat didaftarkan menggunakan expect().

IntentHandler

Objek yang mewakili pengendali intent. Dapat didaftarkan menggunakan expect() atau prompt().

MatchedIntent

Objek yang berisi data untuk intent yang cocok.

Metode
getIntentArg(parameterName) function(string)

Metode untuk mendapatkan parameter intent dari intent yang cocok.

createNumberSlot

createNumberSlot(callback, hints?) returns Slot<number>

Membuat slot nomor jenis.

Parameter
callback function(FilledSlot)

Fungsi yang akan dieksekusi saat slot diisi.

hints Hints

Kata-kata singkat yang mungkin diucapkan pengguna saat mengisi slot. hints membantu sistem NLU memutuskan slot mana yang harus diisi.

Slot object

Objek slot yang dapat didaftarkan menggunakan prompt().

createTextSlot

createTextSlot(callback, hints?) returns Slot<string>

Membuat slot string jenis.

Parameter
callback function(FilledSlot)

Fungsi yang akan dieksekusi saat slot diisi.

hints Hints

Kata-kata singkat yang mungkin diucapkan pengguna saat mengisi slot. hints membantu sistem NLU memutuskan slot mana yang harus diisi.

Slot object

Objek slot yang dapat didaftarkan menggunakan prompt().

createConfirmationSlot

createConfirmationSlot(callback, hints?) returns Slot<boolean>

Membuat slot boolean jenis.

Parameter
callback function(FilledSlot)

Fungsi yang akan dieksekusi saat slot diisi.

hints Hints

Kata-kata singkat yang mungkin diucapkan pengguna saat mengisi slot. hints membantu sistem NLU memutuskan slot mana yang harus diisi.

Slot object

Objek slot yang dapat didaftarkan menggunakan prompt().

createOptionsSlot

createOptionsSlot(options, callback, hints?) returns Slot<string>

Membuat slot dari daftar opsi yang telah ditentukan.

Parameter
options array<Option>

Fungsi yang akan dieksekusi saat slot diisi.

callback function(FilledSlot)

Fungsi yang akan dieksekusi saat slot diisi.

hints Hints

Kata-kata singkat yang mungkin diucapkan pengguna saat mengisi slot. hints membantu sistem NLU memutuskan slot mana yang harus diisi.

Slot object

Objek slot yang dapat didaftarkan menggunakan prompt().

Slot

Objek yang mewakili slot yang akan diisi. Dapat didaftarkan menggunakan expect() atau prompt().

FilledSlot&lt;T&gt;

Objek yang mewakili slot yang terisi.

Parameter
T boolean|number|string

Jenis slot.

Opsi

Objek yang mewakili entri jenis slot.

Kolom
key string

ID unik untuk entri jenis slot.

synonyms array<string>

Daftar kata yang digunakan untuk memilih opsi slot.

Petunjuk

Objek yang mewakili petunjuk untuk slot.

Kolom
associatedWords array<string>

Daftar kata yang digunakan untuk membantu sistem NLU memutuskan slot mana yang harus diisi.

harapkan

expect(expectation) returns HandlerRegistration

Mencatat ekspektasi pada klien. Dapat dipanggil di slot dan pengendali intent.

Parameter
expectation IntentHandler|Slot

Slot atau pengendali intent yang akan didaftarkan.

HandlerRegistration object

Slot atau pengendali intent yang terdaftar.

HandlerRegistration

Objek yang mewakili pengendali intent terdaftar.

Metode
deleteHandler() function

Membatalkan pendaftaran pengendali intent yang diharapkan.

clearExpectations

clearExpectations() returns undefined;

Menghapus semua ekspektasi dengan menghapus semua slot dan pengendali intent yang terdaftar sebelumnya.

perintah

prompt(tts, expectation) returns Promise<Answer<T>>

Memberi tahu pengguna dengan string TTS yang disediakan, dan mendaftarkan ekspektasi pada klien. Dapat dipanggil di slot dan pengendali intent.

Parameter
tts string

String TTS yang digunakan untuk meminta pengguna memberikan ekspektasi yang diberikan.

expectation IntentHandler|Slot

Slot atau pengendali intent yang akan didaftarkan.

Answer<T> object

Jawaban yang diberikan pengguna untuk dialog tersebut.

Jawaban<T>

Objek yang mewakili jawaban yang diberikan pengguna untuk sebuah perintah.

Kolom
value boolean|number|string

Nilai jawaban yang diberikan pengguna.

status string

Status jawaban.

Salah satu dari berikut ini:

ANSWERED: Pengguna merespons perintah dengan sebuah jawaban.

NO_MATCH: Pengguna dimintai jawaban dan merespons dengan jawaban yang tidak cocok dengan jawaban yang diharapkan atau niat lain yang diharapkan.

YIELD: Pengguna merespons perintah dengan niat yang berbeda.

triggerScene

triggerScene(sceneName) returns Promise<TriggerSceneStatus>

Memicu scene.

Parameter
sceneName string

Nama scene yang akan dipicu.

TriggerSceneStatus string

Status panggilan ke triggerScene().

Salah satu dari berikut ini:

SUCCESS: Permintaan berhasil diproses oleh server.

BLOCKED: Permintaan diblokir oleh kueri yang ada yang sedang berlangsung.

UNKNOWN: Status permintaan tidak diketahui.

setUserParam

setUserParam(key, value) returns Promise<undefined>;

Menetapkan pasangan nilai kunci yang diteruskan dan dipertahankan di antara percakapan.

Parameter
key string

Kunci parameter.

value object|array|boolean|number|string

Nilai parameter.

getUserParam

getUserParam(key) returns Promise<object|array|boolean|number|string>;

Mendapatkan nilai parameter untuk kunci yang diberikan jika ada dan status pemanggilan.

Parameter
key string

Kunci parameter.

resetUserParam

resetUserParam() returns Promise<void>;

Menghapus semua parameter pengguna.

setHomeParam

setHomeParam(key, value) returns Promise<undefined>;

Menetapkan pasangan nilai kunci yang diteruskan dan dipertahankan di antara percakapan.

Parameter
key string

Kunci parameter.

value object|array|boolean|number|string

Nilai parameter.

getHomeParam

getHomeParam(key) returns Promise<object|array|boolean|number|string>;

Mendapatkan nilai parameter untuk kunci yang diberikan jika ada dan status pemanggilan.

Parameter
key string

Kunci parameter.

resetHomeParam

resetHomeParam() returns Promise<void>;

Menghapus semua parameter pengguna.

setCanvasState

setCanvasState(state) returns undefined

Memberi tahu Asisten bahwa aplikasi web Canvas telah memperbarui statusnya. Tujuan setCanvasState ini tidak menghasilkan nilai. Payload status dapat diakses melalui Properti conv.context.canvas.state.

Parameter
state Object

Status aplikasi Canvas yang diperbarui sebagai objek JSON.

InteractiveCanvasCallbacks

Callback ini memberikan cara bagi Anda untuk merespons informasi atau permintaan dari Action Percakapan Anda sementara metode tersebut menyediakan cara untuk mengirim informasi atau permintaan ke Action Percakapan Anda.

onUpdate

onUpdate(data) returns Promise|undefined

Dipanggil saat respons Canvas dikirim dari Action Percakapan. TTS akan dimulai saat Promise yang ditampilkan akan diselesaikan, atau habis waktu tunggu setelah 10 detik.

Parameter
data Object

Data yang diperbarui dikirim oleh webhook.

onTtsMark

onTtsMark(markName) returns undefined

Callback yang dipanggil selama pemutaran TTS.

Tanda khusus yang selalu dipicu:

  • START menunjukkan awal TTS.
  • END menunjukkan akhir TTS.
  • ERROR menunjukkan error saat memutar TTS.

Anda juga dapat menentukan tanda kustom menggunakan SSML dan tag <mark>, seperti <mark name="custom"/>.

Parameter
markName string

Tandai nama yang dipanggil selama pemutaran TTS.

onInputStatusChanged

onInputStatusChanged(inputStatus) returns undefined

Memberi tahu aplikasi Canvas bahwa status input Asisten telah berubah.

Parameter
inputStatus Enum

Status pemrosesan input suara dan/atau teks di perangkat. Kaleng adalah sebagai berikut:

  • LISTENING : Mikrofon aktif.
  • IDLE : Mikrofon ditutup.
  • PROCESSING : Asisten saat ini sedang menjalankan kueri (mikrofon ditutup).