|
Parameter |
Type |
Description |
Example |
||||||
|---|---|---|---|---|---|---|---|---|---|
|
object |
Parameter templat Agen. |
||||||||
| Greeting |
string |
Pesan salam. Perubahan berlaku pada sesi berikutnya. Nilai default: none. |
hello |
||||||
| WakeUpQuery |
string |
Instruksi pengguna sebelum panggilan dimulai. Agen merespons instruksi ini segera setelah panggilan dimulai. |
How’s the weather today? |
||||||
| MaxIdleTime |
integer |
Waktu idle maksimum tanpa interaksi dengan agen. Agen akan offline saat waktu habis. Unit: seconds. Nilai default: 600. |
600 |
||||||
| UserOnlineTimeout |
integer |
Periode waktu habis bagi agen untuk menutup tugas jika pengguna tidak bergabung ke sesi. Unit: seconds. Nilai default: 60. |
60 |
||||||
| UserOfflineTimeout |
integer |
Periode waktu habis bagi agen untuk menutup tugas setelah pengguna meninggalkan sesi. Unit: seconds. Nilai default: 5. |
5 |
||||||
| EnablePushToTalk |
boolean |
Apakah akan mengaktifkan mode dorong-untuk-berbicara. Nilai default: false. |
false |
||||||
| GracefulShutdown |
boolean |
Apakah akan mengaktifkan shutdown yang mulus. Nilai default: false. shutdown yang mulus: Saat agen dihentikan, agen menyelesaikan penyiaran ucapan saat ini sebelum berhenti, dengan durasi maksimum 10 detik. |
false |
||||||
| Volume |
integer |
Volume ucapan agen.
|
100 |
||||||
| WorkflowOverrideParams |
string |
Parameter override alur kerja. Nilai default: none. |
{} |
||||||
| AvatarUrl |
string |
URL avatar agen untuk panggilan suara. Nilai default: none. |
http://example.com/a.jpg |
||||||
| AvatarUrlType |
string |
Tipe URL avatar agen. Nilai default: none. |
USER |
||||||
| EnableIntelligentSegment |
boolean |
Apakah akan mengaktifkan segmentasi cerdas. Setelah fitur ini diaktifkan, kalimat terfragmentasi yang diucapkan oleh pengguna akan digabungkan secara cerdas menjadi satu kalimat. Nilai default: true. |
true |
||||||
| AsrConfig |
object |
Konfigurasi automatic speech recognition (ASR). |
|||||||
| AsrLanguageId |
string |
ID bahasa ASR. Nilai valid:
|
zh_mandarin |
||||||
| AsrMaxSilence |
integer |
Ambang batas durasi keheningan untuk segmentasi ucapan. Keheningan yang melebihi ambang batas ini dianggap sebagai jeda kalimat. Nilai valid: 200 hingga 1200. Unit: milliseconds. Nilai default: 400. |
400 |
||||||
| AsrHotWords |
array |
Daftar hot word ASR. Daftar ini mendukung maksimum 128 hot word. |
|||||||
|
string |
Hot word bertipe string. Panjang: 1 hingga 10 karakter. |
check |
|||||||
| VadLevel |
integer |
Parameter ambang batas interupsi. Nilai valid: 0 hingga 11. Nilai default: 11.
|
11 |
||||||
| CustomParams |
string |
Parameter pass-through untuk integrasi ASR proprietari. |
mode=fast&sample=16000&format=wav |
||||||
| VadDuration |
integer |
Ambang batas durasi minimum untuk voice activity detection, yang digunakan untuk mengontrol sensitivitas interupsi. Nilai 0 menonaktifkan fitur ini. Nilai valid: 200 hingga 2000. Unit: milliseconds. Nilai umum: 200 hingga 500, yang sesuai dengan 1 hingga 4 kata. Nilai default: empty (tidak berlaku). |
300 |
||||||
| TtsConfig |
object |
Konfigurasi Sintesis suara. |
|||||||
| VoiceId |
string |
ID suara. Perubahan berlaku pada kalimat berikutnya. Jika tidak ditentukan, ID suara yang dikonfigurasi di templat agen akan digunakan. Parameter ini hanya berlaku untuk TTS preset. Panjang maksimum: 64 karakter. Untuk nilai valid, lihat Contoh efek ucapan cerdas. |
longcheng_v2 |
||||||
| VoiceIdList |
array |
Daftar suara yang tersedia. |
|||||||
|
string |
Suara. |
zhixiaoxia |
|||||||
| PronunciationRules |
array |
Aturan pelafalan TTS. Panjang array tidak boleh melebihi 20. Aturan dijalankan secara berurutan. |
|||||||
|
object |
Aturan pelafalan TTS. |
||||||||
| Word |
string |
Kata yang akan diganti. Panjangnya harus kurang dari 10 karakter. Harus terdiri dari karakter Mandarin dan tidak boleh mengandung spasi. |
110 |
||||||
| Pronunciation |
string |
Pelafalan target. Panjangnya harus kurang dari 10 karakter. Harus terdiri dari karakter Mandarin dan tidak boleh mengandung spasi. |
110 |
||||||
| Type |
string |
Tipe aturan pelafalan spesifik. Nilai valid:
|
replacement |
||||||
| ModelId |
string |
ID model. Saat ini, hanya minimax yang didukung. Nilai valid: speech-01-turbo atau speech-02-turbo. |
speech-01-turbo |
||||||
| LanguageId |
string |
ID bahasa. Saat ini, hanya minimax yang didukung. Nilai default: empty. Parameter ini meningkatkan kemampuan pengenalan untuk bahasa minoritas dan dialek tertentu. Setelah dikonfigurasi, parameter ini meningkatkan kinerja ucapan dalam skenario bahasa minoritas atau dialek tertentu. Jika tipe bahasa minoritas tidak jelas, Anda dapat mengatur parameter ini ke "auto", dan model akan menentukan tipe bahasa secara otomatis. Nilai valid: |
Chinese |
||||||
| Emotion |
string |
Emosi. Saat ini, hanya minimax yang didukung. minimax mendukung 7 emosi berikut:
|
happy |
||||||
| SpeechRate |
number |
Laju ucapan. Didukung di semua platform. Untuk cosyvoice, nilai default adalah 1.0, dan rentang valid adalah 0.5 hingga 2.0. Untuk minimax, nilai default adalah 1.0, dan rentang valid adalah 0.5 hingga 2.0. |
1.0 |
||||||
| LlmConfig |
object |
Konfigurasi Tingkat Tinggi model bahasa (LLM). |
|||||||
| LlmHistory |
array |
Konteks percakapan historis LLM atau multimodal LLM (MLLM). |
|||||||
|
object |
Satu percakapan. |
||||||||
| Role |
string |
Peran peserta percakapan. Nilai valid:
|
user |
||||||
| Content |
string |
Konten teks aktual percakapan, yang mencatat ekspresi atau tanggapan spesifik peran dalam percakapan. |
hello |
||||||
| LlmHistoryLimit |
integer |
Jumlah maksimum giliran yang dipertahankan untuk konteks percakapan historis LLM atau MLLM. Nilai default: 10. |
10 |
||||||
| LlmSystemPrompt |
string |
System prompt untuk LLM setelah panggilan dimulai. |
You are the 1 friendly and helpful assistant, focused on providing accurate information and advice to users. |
||||||
| BailianAppParams |
string |
Parameter untuk Alibaba Studio Model Studio Application Center. Tipe-nya adalah string JSON. Untuk format parameter, lihat: Parameter Alibaba Studio Model Studio Application Center. |
"{\"biz_params\":{\"user_defined_params\":{\"your_plugin_id\":{\"article_index\":2}}},\"memory_id\":\"your_memory_id\",\"image_list\":[\"https://your_image_url\"],\"rag_options\":{\"pipeline_ids\":[\"your_id\"],\"file_ids\":[\"DocumentID1\",\"DocumentID2\"],\"metadata_filter\":{\"name\":\"ZhangSan\"},\"structured_filter\":{\"key1\":\"value1\",\"key2\":\"value2\"},\"tags\":[\"Tag1\",\"Tag2\"]}}" |
||||||
| OpenAIExtraQuery |
string |
Parameter kueri tambahan untuk LLM yang kompatibel dengan OpenAI. Parameter harus dalam format key=value. Beberapa parameter dihubungkan dengan tanda dan (&). Semua nilai harus bertipe string. |
api-version=2024-02-01&api-key=sk-xxx |
||||||
| LlmCompleteReply |
boolean |
Setelah fitur ini diaktifkan, agen mengirimkan hasil LLM lengkap ke klien setelah LLM menghasilkan tanggapan penuh. Sakelar ini tidak memengaruhi pembuatan subtitle secara streaming. |
true |
||||||
| FunctionMap |
array |
Daftar pemetaan fungsi, yang digunakan untuk memetakan kemampuan agen ke fungsi LLM. Saat ini, hanya pemanggilan fungsi dengan LLM yang kompatibel dengan OpenAI yang ditentukan pengguna yang didukung. |
|||||||
|
object |
Satu aturan pemetaan. |
||||||||
| Function |
string |
Nama fitur bawaan yang disediakan oleh sistem agen Alibaba Cloud. Saat ini, hanya hangup (menutup panggilan) yang didukung. |
hangup |
||||||
| MatchFunction |
string |
Nama fungsi LLM yang sesuai dengan fitur ini. Nama ini dikustomisasi oleh pengguna dan digunakan untuk memanggil fitur yang sesuai di LLM. Untuk protokol LLM yang ditentukan pengguna, lihat Jenis Penyimpanan Standar LLM API. |
hangup |
||||||
| OutputMinLength |
integer |
Panjang minimum keluaran teks dalam karakter. Teks yang lebih pendek dari panjang ini akan di-cache dan menunggu penggabungan. Nilai valid: 0 hingga 100. Nilai 0 atau empty menunjukkan tidak ada batas. Nilai default: empty. |
5 |
||||||
| OutputMaxDelay |
integer |
Waktu penundaan maksimum untuk keluaran teks dalam milidetik. Jika waktu ini terlampaui, teks yang di-cache akan dikeluarkan secara paksa. Nilai valid: 1000 hingga 10000. Nilai 0 atau empty menunjukkan tidak ada batas. Nilai default: empty. |
2000 |
||||||
| HistorySyncWithTTS |
boolean |
Apakah riwayat pesan LLM konsisten dengan konten pemutaran TTS. Nilai default: false. Setelah fitur ini diaktifkan, pesan LLM yang disimpan konsisten dengan konten pemutaran TTS. Catatan
Dalam riwayat pesan LLM, saat pengguna menginterupsi agen, pesan berikutnya yang dikirim ke LLM akan menyisipkan tag <ims_agent_interrupted> pada posisi interupsi. Contoh: |
false |
||||||
| AvatarConfig |
object |
Konfigurasi manusia digital. Konfigurasi ini hanya berlaku saat alur kerja menyertakan node manusia digital. |
|||||||
| AvatarId |
string |
ID model manusia digital. |
5257 |
||||||
| InterruptConfig |
object |
Konfigurasi kebijakan interupsi suara. |
|||||||
| EnableVoiceInterrupt |
boolean |
Apakah akan mendukung interupsi suara. Nilai default: true. |
true |
||||||
| InterruptWords |
array |
Daftar kata atau frasa spesifik yang memicu interupsi percakapan. |
|||||||
|
string |
Kata atau frasa spesifik yang memicu interupsi percakapan. |
Excuse me |
|||||||
| NoInterruptMode |
string |
Kebijakan pemrosesan ASR dalam mode
Kebijakan default adalah meng-cache teks ASR. |
cache |
||||||
| KeepInterruptWordsForLLM |
boolean |
Apakah akan mempertahankan kata interupsi saat mengirim teks ke LLM. Nilai default: discard. Catatan
Contoh: Jika kata interupsi adalah "wait", kalimat "wait how is the weather today" menjadi "how is the weather today" setelah kata interupsi dibuang dan dikirim ke LLM. |
true |
||||||
| VoiceprintConfig |
object |
Konfigurasi voiceprint. |
|||||||
| UseVoiceprint |
boolean |
Apakah akan mengaktifkan pengenalan voiceprint. Nilai default: false. Saat pengenalan voiceprint diaktifkan, ID voiceprint yang valid harus diteruskan. |
false |
||||||
| VoiceprintId |
string |
ID identitas unik untuk pengenalan voiceprint. Nilai default: empty. ID voiceprint yang diteruskan harus telah terdaftar melalui API pendaftaran voiceprint. Untuk dokumentasi API, lihat Register voiceprint. |
zhixiaoxia |
||||||
| RegistrationMode |
string |
Mode pendaftaran voiceprint. Nilai default: Explicit.
|
Explicit |
||||||
| TurnDetectionConfig |
object |
Konfigurasi deteksi giliran percakapan. |
|||||||
| TurnEndWords |
array |
Daftar kata kunci yang digunakan untuk menentukan akhir giliran pengguna. |
|||||||
|
string |
Kata kunci yang digunakan untuk menentukan akhir giliran pengguna. |
I'm done |
|||||||
| Mode |
string |
Mode deteksi giliran.
|
Semantic |
||||||
| SemanticWaitDuration |
integer |
Waktu penentuan jeda dalam mode AI. Unit: milliseconds. Nilai default: -1.
Catatan
Parameter ini tidak valid dalam mode normal. |
-1 |
||||||
| Eagerness |
string |
Tingkat eagerness. Parameter ini hanya berlaku dalam mode Semantic. Parameter ini mengontrol kecepatan tanggapan setelah AI mendeteksi jeda:
Nilai default: empty. |
High |
||||||
| ExperimentalConfig |
string |
Parameter fitur eksperimental. Hubungi dukungan teknis jika Anda memiliki persyaratan apa pun. |
"" |
||||||
| VcrConfig |
object |
Konfigurasi fitur pengenalan konten video. Konfigurasi ini mendukung callback konten yang dikenali oleh algoritma dalam video ke klien. |
|||||||
| StillFrameMotion |
object |
Konfigurasi deteksi frame diam. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan deteksi frame diam. Nilai default: false. |
false |
||||||
| CallbackDelay |
integer |
Penundaan untuk notifikasi deteksi frame diam. Setelah parameter ini diatur, notifikasi akan dipicu setelah frame diam berlangsung selama periode waktu tertentu. Unit: milliseconds. Nilai default: empty. Jika empty, konfigurasi di konsol digunakan selama panggilan. Nilai valid: 200 hingga 5000. |
3000 |
||||||
| InvalidFrameMotion |
object |
Pengaturan parameter deteksi frame tidak valid. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan deteksi frame tidak valid. |
false |
||||||
| CallbackDelay |
integer |
Penundaan untuk notifikasi deteksi frame tidak valid. Setelah parameter ini diatur, notifikasi akan dipicu setelah frame tidak valid berlangsung selama periode waktu tertentu. Unit: milliseconds. Nilai default: empty. Jika empty, konfigurasi di konsol digunakan selama panggilan. Nilai valid: 200 hingga 5000. |
3000 |
||||||
| PeopleCount |
object |
Konfigurasi fitur penghitungan orang. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan fitur ini. Nilai default: false. |
false |
||||||
| Equipment |
object |
Konfigurasi pengenalan peralatan. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan deteksi peralatan terlarang. Nilai default: false. |
false |
||||||
| HeadMotion |
object |
Konfigurasi pengenalan gerakan kepala. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan pengenalan gerakan kepala. Nilai default: false. |
false |
||||||
| LookAway |
object |
Konfigurasi deteksi pandangan menjauh. |
|||||||
| Enabled |
boolean |
Apakah akan mengaktifkan deteksi pandangan menjauh. Nilai default: false. |
true |
||||||
| AmbientSoundConfig |
object |
Konfigurasi suara latar untuk panggilan. |
|||||||
| ResourceId |
string |
ID suara latar untuk panggilan. Anda dapat memperoleh ID ini di pengaturan lanjutan konfigurasi agen di konsol. |
f67901c595834************ |
||||||
| Volume |
integer |
Volume suara latar untuk panggilan. Nilai valid: 0 hingga 100. Nilai 0 menunjukkan bahwa suara latar dinonaktifkan. |
50 |
||||||
| AutoSpeechConfig |
object |
Modul konfigurasi ucapan otomatis untuk agen, termasuk prompt tunggu LLM dan pertanyaan selama keheningan pengguna yang berkepanjangan. |
|||||||
| UserIdle |
object |
Konfigurasi prompt pertanyaan selama keheningan pengguna yang berkepanjangan. |
|||||||
| WaitTime |
integer |
Ambang batas durasi keheningan dalam milidetik. Parameter ini wajib diisi. Pertanyaan akan menjadi Pemicu ketika durasi keheningan melebihi ambang batas ini. Nilai valid: 5000 hingga 600000. |
5000 |
||||||
| MaxRepeats |
integer |
Jumlah maksimum pertanyaan. Parameter ini wajib diisi. Nilai valid: 0 hingga 10. Setelah jumlah maksimum tercapai, tidak ada lagi Pemicu dan panggilan diputus. |
5 |
||||||
| Messages |
array |
Kumpulan prompt pertanyaan. Maksimum 10 prompt didukung. Setiap prompt dapat memiliki panjang hingga 100 karakter. Jumlah probabilitas harus 100%. |
|||||||
|
object |
Struktur prompt pertanyaan. |
||||||||
| Text |
string |
Teks prompt pertanyaan. Panjang maksimum: 100 karakter. |
Are you still there? |
||||||
| Probability |
number |
Probabilitas pemilihan prompt. Nilai valid: 0 hingga 1, yang sesuai dengan 0% hingga 100%. |
0.5 |
||||||
| HangupEndWord |
string |
Ucapan penutup Hang. Ucapan ini disiarkan sebelum panggilan diputus setelah periode ketidakresponsifan pengguna yang berkepanjangan. Panjang maksimum: 200 karakter. |
I'm hanging up, bye |
||||||
| LlmPending |
object |
Konfigurasi prompt selama penundaan tanggapan LLM. |
|||||||
| WaitTime |
integer |
Ambang batas pengatur waktu tunggu untuk tanggapan LLM dalam milidetik. Parameter ini wajib diisi. Prompt akan menjadi Pemicu ketika pengatur waktu tunggu melebihi ambang batas ini. Nilai valid: 500 hingga 10000. Atur nilai ini berdasarkan pengatur waktu tanggapan aktual LLM. |
3000 |
||||||
| Mode |
string |
||||||||
| Messages |
array |
Kumpulan prompt pertanyaan. Maksimum 10 prompt didukung. Setiap prompt dapat memiliki panjang hingga 100 karakter. Jumlah probabilitas harus 100%. |
|||||||
|
object |
Struktur prompt pertanyaan. |
||||||||
| Text |
string |
Teks prompt pertanyaan. Panjang maksimum: 100 karakter. |
Just a moment |
||||||
| Probability |
number |
Probabilitas pemilihan prompt. Nilai valid: 0 hingga 1, yang sesuai dengan 0% hingga 100%. |
0.5 |
||||||
| BackChannelingConfigs |
array |
Modul konfigurasi backchanneling. Saat diaktifkan, sistem secara acak menyiarkan kata-kata backchanneling pendek pada tahap pemicu tertentu. |
|||||||
|
object |
Konfigurasi untuk satu item backchanneling. |
||||||||
| Enabled |
boolean |
Apakah akan mengaktifkan fitur backchanneling. Parameter ini wajib diisi. Nilai valid: true dan false. |
true |
||||||
| TriggerStage |
string |
Tahap pemicu untuk backchanneling. Nilai valid:
|
pause_detected |
||||||
| Probability |
number |
Probabilitas pemicu fitur. Nilai valid: 0.0 hingga 1.0. Parameter ini wajib diisi. |
0.5 |
||||||
| Words |
array |
Kumpulan frasa backchanneling. Maksimum 10 frasa didukung. Setiap frasa dapat memiliki panjang hingga 20 karakter. Jumlah probabilitas harus 1.0. |
|||||||
|
object |
Konfigurasi untuk frasa backchanneling. |
||||||||
| Text |
string |
Teks frasa. Panjang maksimum: 20 karakter. Beberapa bahasa didukung. Parameter ini wajib diisi. |
ok |
||||||
| Probability |
number |
Probabilitas pemicu frasa. Nilai valid: 0.0 hingga 1.0. Parameter ini wajib diisi. |
0.3 |
||||||
| BackChannelingConfig |
array |
Penting [Ditinggalkan] Gunakan BackChannelingConfigs sebagai gantinya. |
|||||||
|
object |
Konfigurasi untuk satu item backchanneling. |
||||||||
| Enabled |
boolean |
Apakah akan mengaktifkan fitur backchanneling. Parameter ini wajib diisi. Nilai valid: true dan false. |
true |
||||||
| TriggerStage |
string |
Tahap pemicu untuk backchanneling. Nilai valid:
|
pause_detected |
||||||
| Probability |
number |
Probabilitas pemicu fitur. Nilai valid: 0.0 hingga 1.0. Parameter ini wajib diisi. |
0.5 |
||||||
| Words |
array |
Kumpulan frasa backchanneling. Maksimum 10 frasa didukung. Setiap frasa dapat memiliki panjang hingga 20 karakter. Jumlah probabilitas harus 1.0. |
|||||||
|
object |
Konfigurasi untuk frasa backchanneling. |
||||||||
| Text |
string |
Teks frasa. Panjang maksimum: 20 karakter. Beberapa bahasa didukung. Parameter ini wajib diisi. |
ok |
||||||
| Probability |
number |
Probabilitas pemicu frasa. Nilai valid: 0.0 hingga 1.0. Parameter ini wajib diisi. |
0.3 |