|
パラメーター |
タイプ |
説明 |
例 |
||||||
|---|---|---|---|---|---|---|---|---|---|
|
object |
AI エージェントテンプレートのパラメーターです。 |
||||||||
| Greeting |
string |
AI エージェントが会話に参加する際に再生するウェルカムメッセージです。変更は、以降の会話に適用されます。省略した場合、ウェルカムメッセージは再生されません。 |
你好 |
||||||
| WakeUpQuery |
string |
通話開始直後に AI エージェントが応答する、ユーザー指定のコマンドです。 |
今天天气怎么样? |
||||||
| MaxIdleTime |
integer |
AI エージェントが切断するまでの最大アイドル時間 (秒) です。この期間内にユーザーからの操作がない場合、エージェントはタスクを終了します。デフォルト値:600。 |
600 |
||||||
| UserOnlineTimeout |
integer |
AI エージェントがユーザーの参加を待つ時間 (秒) です。この時間内にユーザーが参加しない場合、エージェントはタスクを終了します。デフォルト値:60。 |
60 |
||||||
| UserOfflineTimeout |
integer |
ユーザーが会話から退出した後、AI エージェントがタスクを終了するまで待機する時間 (秒) です。デフォルト値:5。 |
5 |
||||||
| EnablePushToTalk |
boolean |
プッシュツートークモードを有効にするかどうかを指定します。デフォルト値:`false`。 |
false |
||||||
| GracefulShutdown |
boolean |
グレースフルシャットダウンを有効にするかどうかを指定します。デフォルト値:`false`。 有効にすると、タスクが停止された際に、AI エージェントは現在の発話を完了してから切断します。エージェントは 10 秒を超えて発話しません。 |
false |
||||||
| Volume |
integer |
AI エージェントの発話ボリュームです。
|
100 |
||||||
| WorkflowOverrideParams |
string |
デフォルトのワークフロー構成をオーバーライドするためのパラメーターを含む JSON 文字列です。 |
{} |
||||||
| AvatarUrl |
string |
音声通話中に表示するアバターの URL です。省略した場合、アバターは表示されません。 |
http://example.com/a.jpg |
||||||
| AvatarUrlType |
string |
アバター URL のタイプです。デフォルトでは、このパラメーターは設定されません。 |
USER |
||||||
| EnableIntelligentSegment |
boolean |
インテリジェントセグメンテーションを有効にするかどうかを指定します。有効にすると、ユーザーの短い発話が 1 つの文にマージされます。デフォルト値:`true`。 |
true |
||||||
| AsrConfig |
object |
自動音声認識 (ASR) の構成です。 |
|||||||
| AsrLanguageId |
string |
ASR の言語。有効な値:
|
zh_mandarin |
||||||
| AsrMaxSilence |
integer |
ASR エンジンが発話を確定するまでの無音の最大持続時間 (ミリ秒) です。この値より長い無音は、文の区切りと見なされます。範囲:200~1200。デフォルト値:400。 |
400 |
||||||
| AsrHotWords |
array |
ASR の精度を向上させるためのホットワードのリストです。最大 128 個のホットワードを指定できます。 |
|||||||
|
string |
ホットワードの文字列。長さ:1~10 文字。 |
检查 |
|||||||
| VadLevel |
integer |
割り込みのための音声アクティビティ検出 (VAD) のしきい値です。範囲:0~11。デフォルト値:11。
|
11 |
||||||
| CustomParams |
string |
独自の ASR 統合のためのパススルーパラメーターです。 |
mode=fast&sample=16000&format=wav |
||||||
| VadDuration |
integer |
割り込みをトリガーするために必要なユーザーの連続した発話の最小持続時間 (ミリ秒) です。これにより、割り込みの感度を制御します。値 0 はこの機能を無効にします。範囲:200~2000。一般的な範囲は 200~500 ms で、これは通常、中国語の 1~4 文字に相当します。省略した場合、この機能は無効になります。 |
300 |
||||||
| TtsConfig |
object |
音声合成 (TTS) の構成です。 |
|||||||
| VoiceId |
string |
プリセットされた TTS 音声の ID です。変更は次の発話から適用されます。省略した場合、AI エージェントテンプレートの音声が使用されます。ID の最大長は 64 文字です。利用可能な音声については、「インテリジェント音声サンプル」をご参照ください。 |
longcheng_v2 |
||||||
| VoiceIdList |
array |
利用可能な音声のリストです。 |
|||||||
|
string |
音声。 |
zhixiaoxia |
|||||||
| PronunciationRules |
array |
順に実行される TTS 発音ルールのリストです。最大 20 個のルールを指定できます。 |
|||||||
|
object |
TTS 発音ルールです。 |
||||||||
| Word |
string |
置き換え対象の単語です。長さは 1~9 文字の中国語で、スペースを含めることはできません。 |
一一零 |
||||||
| Pronunciation |
string |
置き換え後の発音です。長さは 1~9 文字の中国語で、スペースを含めることはできません。 |
幺幺零 |
||||||
| Type |
string |
発音ルールのタイプです。 有効な値:
|
replacement |
||||||
| ModelId |
string |
このパラメーターは Minimax プロバイダーにのみ適用されます。有効な値: `speech-01-turbo`、`speech-02-turbo` |
speech-01-turbo |
||||||
| LanguageId |
string |
このパラメーターは Minimax プロバイダー専用です。特定のリソースが少ない言語や方言の認識を強化します。言語が不明な場合は、`auto` に設定して自動検出します。デフォルトでは、このパラメーターは設定されません。サポートされている値は次のとおりです: |
Chinese |
||||||
| Emotion |
string |
このパラメーターは Minimax プロバイダーにのみ適用されます。サポートされている感情は次のとおりです:
|
happy |
||||||
| SpeechRate |
number |
話速です。値 1.0 が通常の速度です。サポートされる範囲はプロバイダーによって異なる場合があります。CosyVoice の場合、範囲は 0.5~2.0 (デフォルト:1.0) です。Minimax の場合、範囲は 0.5~2.0 (デフォルト:1.0) です。 |
1.0 |
||||||
| LlmConfig |
object |
大規模言語モデル (LLM) の構成です。 |
|||||||
| LlmHistory |
array |
LLM/MLLM のための会話履歴コンテキストです。 |
|||||||
|
object |
単一の対話ターンです。 |
||||||||
| Role |
string |
会話の参加者のロール。有効な値:
|
user |
||||||
| Content |
string |
このロールからのメッセージのテキストコンテンツです。 |
你好 |
||||||
| LlmHistoryLimit |
integer |
LLM/MLLM コンテキストに含める最新の対話ターンの最大数です。デフォルト値:10。 |
10 |
||||||
| LlmSystemPrompt |
string |
通話開始後の LLM のシステムプロンプトです。 |
你是一位友好且乐于助人的助手,专注于为用户提供准确的信息和建议。 |
||||||
| BailianAppParams |
string |
Alibaba Cloud Model Studio のパラメーターで、JSON 文字列として提供されます。パラメーターのフォーマットについては、 「Alibaba Cloud Model Studio パラメーター」をご参照ください。 |
"{\"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\":[\"文档ID1\",\"文档ID2\"],\"metadata_filter\":{\"name\":\"张三\"},\"structured_filter\":{\"key1\":\"value1\",\"key2\":\"value2\"},\"tags\":[\"标签1\",\"标签2\"]}}" |
||||||
| OpenAIExtraQuery |
string |
OpenAI 互換の LLM のための追加のクエリパラメーターです。パラメーターは URL クエリ文字列 (例:`key1=value1&key2=value2`) として提供する必要があります。すべての値は文字列でなければなりません。 |
api-version=2024-02-01&api-key=sk-xxx |
||||||
| LlmCompleteReply |
boolean |
`true` に設定すると、エージェントは LLM の応答をストリーミングするのではなく、完全に生成された後に単一のメッセージとして送信します。この設定は字幕のストリーミングには影響しません。 |
true |
||||||
| FunctionMap |
array |
エージェントのビルトイン関数をカスタム LLM 関数にマッピングします。現在、これはカスタムの OpenAI 互換 LLM の関数呼び出しのみをサポートしています。 |
|||||||
|
object |
単一のマッピングルールです。 |
||||||||
| Function |
string |
AI エージェントシステムが提供するビルトイン関数の名前です。現在、`hangup` のみがサポートされています。 |
hangup |
||||||
| MatchFunction |
string |
エージェントのビルトイン関数にマッピングされるカスタム LLM 関数の名前です。カスタム LLM プロトコルの詳細については、「LLM 標準インターフェース」をご参照ください。 |
hangup |
||||||
| OutputMinLength |
integer |
TTS エンジンに送信される前のテキストチャンクの最小文字数です。これより短いチャンクはバッファリングされます。範囲:0~100。値 `0` またはこのパラメーターを省略すると、バッファリングが無効になります。デフォルト:未設定。 |
5 |
||||||
| OutputMaxDelay |
integer |
`OutputMinLength` が満たされていない場合でも、バッファリングされたテキストが TTS エンジンに送信されるまでの最大遅延時間 (ミリ秒) です。範囲:1000~10000。値 `0` またはこのパラメーターを省略すると、遅延制限が無効になります。デフォルト:未設定。 |
2000 |
||||||
| HistorySyncWithTTS |
boolean |
LLM のメッセージ履歴を TTS (音声合成) によって再生されるコンテンツと同期させるかどうかを指定します。デフォルト値は `false` です。この機能を有効にすると、保存される LLM のメッセージが、TTS によって実際に再生されたコンテンツと一致するようになります。 説明
ユーザーがエージェントの応答に割り込んだ場合、割り込みが発生したポイントのメッセージ履歴に `<ims_agent_interrupted>` タグが挿入されます。これにより、次に LLM へ送信されるメッセージに影響が及びます。例: |
false |
||||||
| AvatarConfig |
object |
アバターの構成です。この設定は、ワークフローにアバターノードが含まれている場合にのみ有効です。 |
|||||||
| AvatarId |
string |
アバターのモデル ID です。 |
5257 |
||||||
| InterruptConfig |
object |
音声割り込みポリシーの構成です。 |
|||||||
| EnableVoiceInterrupt |
boolean |
音声割り込みを有効にするかどうかを指定します。デフォルト値:`true`。 |
true |
||||||
| InterruptWords |
array |
割り込みをトリガーする特定の単語またはフレーズのリストです。 |
|||||||
|
string |
割り込みをトリガーする特定の単語またはフレーズです。 |
打断一下 |
|||||||
| NoInterruptMode |
string |
エージェントの発話の割り込み不可の部分で発生したユーザーの発話をどのように処理するかを指定します。
デフォルト値:`cache`。 |
cache |
||||||
| KeepInterruptWordsForLLM |
boolean |
LLM に送信されるテキストに割り込みワードを含めるかどうかを指定します。デフォルト値:`false` (単語は破棄されます)。 説明
例えば、「hold on」が割り込みワードで、ユーザーが「hold on, what is the weather like today?」と発話した場合、これを `false` に設定すると、「what is the weather like today?」のみが LLM に送信されます。 |
true |
||||||
| VoiceprintConfig |
object |
ボイスプリント認識の構成です。 |
|||||||
| UseVoiceprint |
boolean |
ボイスプリント認識を有効にするかどうかを指定します。デフォルト値:`false`。`true` に設定した場合は、有効な `VoiceprintId` も提供する必要があります。 |
false |
||||||
| VoiceprintId |
string |
ボイスプリントの一意の識別子です。デフォルトでは設定されていません。ID は、ボイスプリント登録 API を使用して登録されたボイスプリントに対応している必要があります。詳細については、「ボイスプリントの登録」をご参照ください。 |
zhixiaoxia |
||||||
| RegistrationMode |
string |
ボイスプリントの登録モードです。デフォルト値:`Explicit`。
|
Explicit |
||||||
| TurnDetectionConfig |
object |
対話ターン検出の構成です。 |
|||||||
| TurnEndWords |
array |
ユーザーの対話ターンの終了を判断するために使用されるキーワードのリストです。 |
|||||||
|
string |
ユーザーの対話ターンの終了を判断するために使用されるキーワードです。 |
我说完了 |
|||||||
| Mode |
string |
対話ターン検出モードです。
|
Semantic |
||||||
| SemanticWaitDuration |
integer |
AI モードでの無音検出時間 (ミリ秒) です。デフォルト値:-1。
説明
このパラメーターは `Normal` モードでは効果がありません。 |
-1 |
||||||
| Eagerness |
string |
ユーザーの無音を検出した後のエージェントの応答速度を制御します。このパラメーターは `Semantic` モードでのみ適用されます。設定値を高くすると応答は速くなりますが、ユーザーに割り込むリスクが高まります:
このフィールドはデフォルトで空です。 |
High |
||||||
| ExperimentalConfig |
string |
実験的機能のパラメーターです。サポートにお問い合わせください。 |
"" |
||||||
| VcrConfig |
object |
ビデオコンテンツ認識の構成です。これにより、システムはビデオストリームで検出されたイベントについてクライアントにコールバックを送信できます。 |
|||||||
| StillFrameMotion |
object |
静止フレーム検出の構成です。 |
|||||||
| Enabled |
boolean |
静止フレーム検出を有効にするかどうかを指定します。デフォルト値:`false`。 |
false |
||||||
| CallbackDelay |
integer |
通知が送信される前にフレームが静止していなければならない持続時間 (ミリ秒) です。指定しない場合、コンソールからの設定が使用されます。範囲:200~5000。 |
3000 |
||||||
| InvalidFrameMotion |
object |
無効フレーム検出の構成です。 |
|||||||
| Enabled |
boolean |
無効フレーム検出を有効にするかどうかを指定します。 |
false |
||||||
| CallbackDelay |
integer |
通知が送信される前に無効なフレームが持続しなければならない時間 (ミリ秒) です。指定しない場合、コンソールからの設定が使用されます。範囲:200~5000。 |
3000 |
||||||
| PeopleCount |
object |
人数カウント機能の構成です。 |
|||||||
| Enabled |
boolean |
人数カウントを有効にするかどうかを指定します。デフォルト値:`false`。 |
false |
||||||
| Equipment |
object |
デバイス識別の構成です。 |
|||||||
| Enabled |
boolean |
デバイス識別を有効にするかどうかを指定します。デフォルト値:`false`。 |
false |
||||||
| HeadMotion |
object |
頭部動作検出の構成です。 |
|||||||
| Enabled |
boolean |
頭部動作検出を有効にするかどうかを指定します。デフォルト値:`false`。 |
false |
||||||
| LookAway |
object |
視線逸脱検出の構成です。 |
|||||||
| Enabled |
boolean |
視線逸脱検出を有効にするかどうかを指定します。デフォルト値:`false`。 |
true |
||||||
| AmbientSoundConfig |
object |
通話中の環境音の構成です。 |
|||||||
| ResourceId |
string |
環境音リソースの ID です。この ID は、コンソールのエージェント構成の高度な設定から取得できます。 |
f67901c595834************ |
||||||
| Volume |
integer |
環境音のボリュームです。範囲:0~100。値 0 は音を無効にします。 |
50 |
||||||
| AutoSpeechConfig |
object |
LLM のレイテンシーやユーザーの長時間の無音に対するプロンプトなど、エージェントの自動音声の構成です。 |
|||||||
| UserIdle |
object |
ユーザーが長時間無音の場合に再生するプロンプトの構成です。 |
|||||||
| WaitTime |
integer |
無音持続時間のしきい値 (ミリ秒) です。ユーザーがこの期間より長く無音の場合、プロンプトがトリガーされます。範囲:5000~600000。これは必須フィールドです。 |
5000 |
||||||
| MaxRepeats |
integer |
プロンプトを繰り返すことができる最大回数です。範囲:0~10。これは必須フィールドです。制限を超えると、通話は終了します。 |
5 |
||||||
| Messages |
array |
プロンプトメッセージのコレクションです。最大 10 個のメッセージがサポートされ、各メッセージは最大 100 文字です。すべての確率の合計は 100% になる必要があります。 |
|||||||
|
object |
プロンプトメッセージの構造です。 |
||||||||
| Text |
string |
プロンプトメッセージのテキスト。最大 100 文字です。 |
您还在吗? |
||||||
| Probability |
number |
このメッセージが選択される確率です。範囲:0~1 で、0%~100% に対応します。 |
0.5 |
||||||
| HangupEndWord |
string |
ユーザーの無操作により通話を切断する前に再生される別れのメッセージです。 |
|||||||
| LlmPending |
object |
LLM の応答レイテンシー中に再生するプロンプトの構成です。 |
|||||||
| WaitTime |
integer |
LLM 応答の待機時間のしきい値です。しきい値を超えると、プロンプトが再生されます。これは必須フィールドです。単位:ms。範囲:500~10000。ご利用の LLM の実際のパフォーマンスに基づいてこの値を設定してください。 |
3000 |
||||||
| Mode |
string |
LLM レイテンシープロンプトの処理モードです。`random`:リストからランダムなメッセージを再生します。`sequence`:メッセージを順に再生します。これは必須フィールドです。 |
|||||||
| Messages |
array |
プロンプトメッセージのコレクションです。最大 10 個のメッセージがサポートされ、各メッセージは最大 100 文字です。すべての確率の合計は 100% になる必要があります。 |
|||||||
|
object |
プロンプトメッセージの構造です。 |
||||||||
| Text |
string |
プロンプトメッセージのテキスト。最大 100 文字です。 |
稍等一下 |
||||||
| Probability |
number |
このメッセージが選択される確率です。範囲:0~1 で、0%~100% に対応します。 |
0.5 |
||||||
| BackChannelingConfigs |
array |
相槌の構成です。有効にすると、システムは特定のトリガーポイントで短い応答フレーズを再生します。 |
|||||||
|
object |
単一の相槌構成です。 |
||||||||
| Enabled |
boolean |
この相槌ルールを有効にするかどうかを指定します。これは必須フィールドです。 |
true |
||||||
| TriggerStage |
string |
相槌のトリガーです。有効な値:
|
pause_detected |
||||||
| Probability |
number |
トリガー確率です。範囲:0.0~1.0。これは必須フィールドです。 |
0.5 |
||||||
| Words |
array |
確認フレーズのコレクションです。最大 10 個のフレーズを指定できます。各フレーズは 20 文字以下で、それらの確率の合計は 1.0 になる必要があります。 |
|||||||
|
object |
応答フレーズの構成です。 |
||||||||
| Text |
string |
フレーズのテキスト。長さは 20 文字以下で、多言語をサポートします。必須項目です。 |
嗯嗯 |
||||||
| Probability |
number |
このフレーズのトリガー確率。範囲は 0.0~1.0 です。必須項目です。 |
0.3 |
||||||
| BackChannelingConfig |
array |
重要 非推奨です。BackChannelingConfigs を使用してください。 |
|||||||
|
object |
単一の相槌設定 |
||||||||
| Enabled |
boolean |
相槌機能を有効にするかどうか。必須項目です。値は true/false です。 |
true |
||||||
| TriggerStage |
string |
相槌がトリガーされるタイミング。選択可能な値:
|
pause_detected |
||||||
| Probability |
number |
機能のトリガー確率。範囲は 0.0~1.0 です。必須項目です。 |
0.5 |
||||||
| Words |
array |
相槌フレーズのコレクション。最大 10 個のフレーズを指定でき、各フレーズの長さは 20 文字以下、確率の合計は 1.0 にする必要があります。 |
|||||||
|
object |
相槌フレーズの設定 |
||||||||
| Text |
string |
フレーズのテキスト。長さは 20 文字以下で、多言語をサポートします。必須項目です。 |
嗯嗯 |
||||||
| Probability |
number |
このフレーズのトリガー確率。範囲は 0.0~1.0 です。必須項目です。 |
0.3 |