All Products
Search
Document Center

Intelligent Media Services:AIAgentConfig

Last Updated:Oct 09, 2026

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.

  • Jika tidak ditentukan: Mode volume adaptif yang direkomendasikan oleh Alibaba Cloud digunakan secara default.

  • Jika ditentukan: Rentang valid adalah 0 hingga 400. Volume keluaran = Volume keluaran ucapan di alur kerja × volume / 100. Contoh:

  1. Jika volume diatur ke 0, volume keluaran adalah 0.

  2. Jika volume diatur ke 100, volume keluaran adalah volume asli.

  3. Jika volume diatur ke 200, volume keluaran adalah dua kali volume asli.

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: Bahasa Mandarin.

  • en: Bahasa Inggris.

  • zh_en: Campuran Bahasa Mandarin dan Bahasa Inggris.

  • es: Bahasa Spanyol.

  • jp: Bahasa Jepang.

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.

  • 0: Menonaktifkan fitur voice activity detection (VAD).

  • 1 hingga 10: Nilai yang lebih tinggi menunjukkan bahwa lebih sulit untuk menginterupsi agen.

  • 11: Secara signifikan berbeda dari nilai sebelumnya, memberikan distorsi ucapan yang lebih rendah selama pra-pemrosesan dan kemampuan anti-interferensi yang lebih kuat.

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: Aturan yang secara langsung mengganti Word dengan Pronunciation.

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:

Bahasa yang didukung

  • Chinese: Bahasa Mandarin

  • Chinese,Yue: Bahasa Kanton

  • English: Bahasa Inggris

  • Arabic: Bahasa Arab

  • Russian: Bahasa Rusia

  • Spanish: Bahasa Spanyol

  • French: Bahasa Prancis

  • Portuguese: Bahasa Portugis

  • German: Bahasa Jerman

  • Turkish: Bahasa Turki

  • Dutch: Bahasa Belanda

  • Ukrainian: Bahasa Ukraina

  • Vietnamese: Bahasa Vietnam

  • Indonesian: Bahasa Indonesia

  • Japanese: Bahasa Jepang

  • Italian: Bahasa Italia

  • Korean: Bahasa Korea

  • Thai: Bahasa Thailand

  • Polish: Bahasa Polandia

  • Romanian: Bahasa Rumania

  • Greek: Bahasa Yunani

  • Czech: Bahasa Ceko

  • Finnish: Bahasa Finlandia

  • Hindi: Bahasa Hindi

  • auto: Deteksi otomatis

Chinese

Emotion

string

Emosi. Saat ini, hanya minimax yang didukung. minimax mendukung 7 emosi berikut:

  • happy: Senang

  • sad: Sedih

  • angry: Marah

  • fearful: Takut

  • disgusted: Jijik

  • surprised: Terkejut

  • calm: Tenang

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: Pengguna

  • assistant: Asisten

  • system: Sistem

  • function: Fungsi

  • plugin: Plugin

  • tool: Alat

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:

[
  {"role": "user", "content": "Tell me a story."},
  {"role": "assistant", "content": "Sure, let me tell you a story about the Romance of the Three Kingdoms. Do you<ims_agent_interrupted> want to listen?"},
  {"role": "user", "content": "Let's change to another one."}
]

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 .

  • cache: Meng-cache teks ASR. Setelah giliran saat ini berakhir, teks ASR yang di-cache akan diproses bersama pada giliran berikutnya.

  • discard: Membuang teks ASR secara langsung.

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.

ValueDescription
ExplicitMode pendaftaran eksplisit. Pengguna harus mengunggah audio melalui API pendaftaran voiceprint terlebih dahulu untuk menyelesaikan pendaftaran.
ImplicitMode pendaftaran implisit. Suara pengguna dikumpulkan secara otomatis selama percakapan untuk menghasilkan fitur voiceprint.

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.

  • Normal (default): Mode normal. AI tidak digunakan untuk menentukan semantik.

  • Semantic: Mode semantik. AI digunakan untuk menentukan apakah pengguna telah selesai berbicara berdasarkan semantik konteks.

Semantic

SemanticWaitDuration

integer

Waktu penentuan jeda dalam mode AI. Unit: milliseconds. Nilai default: -1.

  • -1: AI menentukan waktu tunggu yang sesuai secara otomatis.

  • 0 hingga 10000: Waktu tunggu kustom. Kami menyarankan Anda mengaturnya ke 0 hingga 1500 milidetik.

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:

  • "Low": Menunggu dengan sabar. Waktu tunggu maksimum adalah 6 detik, yang mengurangi risiko terinterupsi.

  • "Medium": Menunggu seimbang. Waktu tunggu maksimum adalah 4 detik, yang cocok untuk sebagian besar skenario.

  • "High": Respons cepat. Waktu tunggu maksimum adalah 2 detik, yang meningkatkan kecepatan tetapi dapat meningkatkan risiko pemotongan palsu.

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: Jeda singkat dalam ucapan terdeteksi.

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: Jeda singkat dalam ucapan terdeteksi.

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