Windows.ApplicationModel.ConversationalAgent Ruang nama

Menyediakan aplikasi kemampuan untuk mengekspos fungsionalitas melalui asisten digital apa pun yang didukung oleh platform Agen Percakapan Windows.

Penting

API Windows.ApplicationModel.ConversationalAgent adalah bagian dari Fitur Akses Terbatas (lihat kelas LimitedAccessFeatures). Untuk informasi selengkapnya atau untuk meminta token pembuka kunci, hubungi Dukungan Microsoft.

Kelas

ActivationSignalDetectionConfiguration	Menyediakan detail konfigurasi untuk satu sinyal yang didukung oleh detektor sinyal aktivasi. Misalnya, kata kunci "Hey Cortana" dalam bahasa Inggris AS.
ActivationSignalDetectionConfigurationCreationResult	Memberikan hasil saat ActivationSignalDetector membuat ActivationSignalDetectionConfiguration.
ActivationSignalDetector	Mewakili komponen perangkat keras dan perangkat lunak yang dapat menghasilkan sinyal aktivasi berdasarkan input dari lingkungan pengguna, seperti kata kunci lisan, deteksi suara, atau tekan tombol.
ConversationalAgentDetectorManager	Menyediakan akses ke pendeteksi sinyal dan definisi konfigurasi yang ada dari asisten digital.
ConversationalAgentSession	Saluran komunikasi antara asisten digital dan platform Agen Percakapan Windows.
ConversationalAgentSessionInterruptedEventArgs	Menyediakan data peristiwa untuk peristiwa SessionInterrupted .
ConversationalAgentSignal	Sinyal yang terdeteksi oleh agen yang sesuai dengan ActivationSignalDetectionConfiguration. Sinyal ini menunjukkan bahwa agen yang cocok harus diaktifkan untuk menangani interaksi.
ConversationalAgentSignalDetectedEventArgs	Menyediakan data peristiwa untuk peristiwa SignalDetected .
ConversationalAgentSystemStateChangedEventArgs	Menyediakan data peristiwa untuk peristiwa SystemStateChanged .
DetectionConfigurationAvailabilityChangedEventArgs	Menyediakan data peristiwa untuk peristiwa ActivationSignalDetectionConfiguration.AvailabilityChanged .
DetectionConfigurationAvailabilityInfo	Menyediakan detail ketersediaan untuk ActivationSignalDetector.

Enum

ActivationSignalDetectionConfigurationCreationStatus	Menentukan kemungkinan hasil saat membuat ActivationSignalDetectionConfiguration untuk asisten digital.
ActivationSignalDetectionConfigurationRemovalResult	Menentukan kemungkinan hasil saat menghapus ActivationSignalDetectionConfiguration dari asisten digital.
ActivationSignalDetectionConfigurationSetModelDataResult	Menentukan kemungkinan hasil yang dikembalikan saat mengatur data konfigurasi model dari ActivationSignalDetectionConfiguration untuk asisten digital.
ActivationSignalDetectionConfigurationStateChangeResult	Menentukan kemungkinan hasil yang dikembalikan saat mengaktifkan atau menonaktifkan ActivationSignalDetectionConfiguration untuk asisten digital.
ActivationSignalDetectionTrainingDataFormat	Menentukan format data pelatihan sinyal aktivasi yang didukung oleh ActivationSignalDetector untuk asisten digital.
ActivationSignalDetectorKind	Menentukan jenis ActivationSignalDetector yang didukung.
ActivationSignalDetectorPowerState	Menentukan mode daya, didukung oleh ActivationSignalDetector, yang menjelaskan kondisi terkait daya di mana detektor diizinkan untuk beroperasi.
ConversationalAgentActivationKind	Menentukan jenis aktivasi agen yang didukung.
ConversationalAgentActivationResult	Menentukan nilai hasil permintaan aktivasi agen yang didukung.
ConversationalAgentSessionUpdateResponse	Menentukan setiap respons yang mungkin untuk pembaruan ConversationalAgentSession .
ConversationalAgentState	Menentukan setiap kemungkinan AgentState untuk asisten digital.
ConversationalAgentSystemStateChangeType	Menentukan kemungkinan perubahan status untuk peristiwa SystemStateChanged .
ConversationalAgentVoiceActivationPrerequisiteKind	Menentukan kemungkinan pengaturan yang diperlukan agar aktivasi suara berfungsi.
DetectionConfigurationAvailabilityChangeKind	Menentukan tingkat izin yang diberikan oleh pengguna untuk setiap ActivationSignalDetectionConfiguration dari ActivationSignalDetector.
DetectionConfigurationTrainingStatus	Menentukan status data pelatihan suara yang dikenali oleh ActivationSignalDetector untuk asisten digital. Catatan Penentuan ini dibuat oleh algoritma pelatihan pendeteksi sinyal individu dan mungkin khusus untuk implementasi perangkat keras atau perangkat lunak detektor.
SignalDetectorResourceKind	Menentukan jenis sumber daya sistem yang mungkin dilaporkan tidak tersedia untuk ActivationSignalDetectionConfiguration.

Keterangan

Pengguna dapat mengaktifkan sinyal deteksi tingkat platform untuk agen percakapan di Pengaturan. Sinyal ini dapat mencakup ucapan kata kunci, transmisi Bluetooth, akselerator keyboard sistem, pengenalan ucapan dalam aplikasi, atau suara lainnya (bantingan pintu, detektor asap). Misalnya, kata kunci "Hey Cortana" yang memulai interaksi suara dengan Cortana.

Detektor sinyal tingkat platform bertindak sebagai filter "first-pass" dan dapat mengakibatkan terlalu banyak aktivasi yang tidak diinginkan. Untuk alasan ini, kami sarankan Anda mempertimbangkan verifikasi tambahan sinyal aktivasi, seperti menggunakan detektor kata kunci yang lebih ketat dari konteks aplikasi agen.

Jika ConversationalAgentSignal terdeteksi saat aplikasi tidak berjalan, atau tidak dapat menanggapi peristiwa ConversationalAgentSession.SignalDetected , aplikasi diaktifkan di latar belakang menggunakan tugas yang terdaftar dengan ConversationalAgentTrigger.

Jika ConversationalAgentSignal terdeteksi saat aplikasi dapat merespons peristiwa ConversationalAgentSession.SignalDetected (dengan memanggil ConversationalAgentSession.RequestAgentStateChangeAsync), tidak ada aktivasi latar belakang yang terjadi, karena sinyal telah ditangani.

Jika ConversationalAgentSignal terdeteksi untuk agen percakapan saat sesi yang dapat diinterupsi (lihat RequestInterruptableAsync) sudah aktif, sesi akan menerima peristiwa ConversationalAgentSession.SessionInterrupted untuk menunjukkan bahwa peristiwa sinyal baru telah dinaikkan.

Catatan

Beberapa sesi asisten digital tidak dapat terganggu oleh sinyal lain. Misalnya, Cortana mengharuskan pengguna untuk mengeluarkan perintah batalkan atau hentikan untuk mengakhiri sesi saat ini (pengguna tidak dapat berada dalam sesi Cortana dan mengeluarkan perintah ke Alexa).