|
パラメーター |
タイプ |
説明 |
例 |
||||||
|---|---|---|---|---|---|---|---|---|---|
|
object |
エージェントテンプレートのパラメーター。 |
||||||||
| Greeting |
string |
挨拶のメッセージ。一部サービス停止は次の会話で効果を発揮します。デフォルト値: なし。 |
hello |
||||||
| WakeUpQuery |
string |
呼び出し開始前のユーザーの命令。エージェントは呼び出し開始直後にこの命令に応答します。 |
How’s the weather today? |
||||||
| MaxIdleTime |
integer |
エージェントとの対話がない場合のアイドル時間の最大値。タイムアウト時にエージェントはオフラインになります。単位: 秒。デフォルト値: 600。 |
600 |
||||||
| UserOnlineTimeout |
integer |
ユーザーが会話に参加しない場合にエージェントがタスクをクローズするまでのタイムアウト期間。単位: 秒。デフォルト値: 60。 |
60 |
||||||
| UserOfflineTimeout |
integer |
ユーザーが会話から退出した後にエージェントがタスクをクローズするまでのタイムアウト期間。単位: 秒。デフォルト値: 5。 |
5 |
||||||
| EnablePushToTalk |
boolean |
プッシュトゥートークモードを有効にするかどうかを指定します。デフォルト値: false。 |
false |
||||||
| GracefulShutdown |
boolean |
グレースフルシャットダウンを有効にするかどうかを指定します。デフォルト値: false。 グレースフルシャットダウン: エージェントが停止する際、現在の音声のブロードキャストを完了してから停止します。最大値 10 秒間です。 |
false |
||||||
| Volume |
integer |
エージェントの音声のボリューム。
|
100 |
||||||
| WorkflowOverrideParams |
string |
ワークフローのオーバーライドパラメーター。デフォルト値: なし。 |
{} |
||||||
| AvatarUrl |
string |
音声呼び出し用エージェントのアバター URL。デフォルト値: なし。 |
http://example.com/a.jpg |
||||||
| AvatarUrlType |
string |
エージェントのアバター URL のタイプ。デフォルト値: なし。 |
USER |
||||||
| EnableIntelligentSegment |
boolean |
インテリジェントセグメンテーションを有効にするかどうかを指定します。この特徴が有効にされると、ユーザーが発話した断片的な文がインテリジェントに 1 つの文に結合されます。デフォルト値: true。 |
true |
||||||
| AsrConfig |
object |
自動音声認識 (ASR) の構成。 |
|||||||
| AsrLanguageId |
string |
ASR 言語 ID。有効な値:
|
zh_mandarin |
||||||
| AsrMaxSilence |
integer |
音声セグメンテーションのサイレンス持続時間のしきい値。このしきい値を超えるサイレンスは文の中断とみなされます。有効な値: 200 から 1200。単位: ミリ秒。デフォルト値: 400。 |
400 |
||||||
| AsrHotWords |
array |
ASR ホットワードリスト。リストは最大値 128 個のホットワードをサポートします。 |
|||||||
|
string |
ホットワード文字列。長さ: 1 から 10 文字。 |
check |
|||||||
| VadLevel |
integer |
割り込みしきい値パラメーター。有効な値: 0 から 11。デフォルト値: 11。
|
11 |
||||||
| CustomParams |
string |
独自 ASR 統合用のパススルーパラメーター。 |
mode=fast&sample=16000&format=wav |
||||||
| VadDuration |
integer |
音声活動検出の最小値の持続時間しきい値。割り込みの秘密度をコントロールするために使用されます。値 0 はこの特徴を無効にします。有効な値: 200 から 2000。単位: ミリ秒。一般的な値: 200 から 500 (1 から 4 語に相当)。デフォルト値: 空 (効果を発揮しません)。 |
300 |
||||||
| TtsConfig |
object |
音声合成の構成。 |
|||||||
| VoiceId |
string |
音声 ID。一部サービス停止は次の文で効果を発揮します。指定しない場合、エージェントテンプレートで設定された音声 ID が使用されます。このパラメーターは、プリセット TTS に対してのみ有効です。長さの最大値: 64 文字。有効な値については、インテリジェント音声効果の例 を参照してください。 |
longcheng_v2 |
||||||
| VoiceIdList |
array |
利用可能な音声のリスト。 |
|||||||
|
string |
音声。 |
zhixiaoxia |
|||||||
| PronunciationRules |
array |
TTS 発音ルール。配列の長さは 20 を超えることはできません。ルールはシーケンスで実行されます。 |
|||||||
|
object |
TTS 発音ルール。 |
||||||||
| Word |
string |
置換対象の単語。長さは 10 文字未満である必要があります。漢字で構成され、スペースを含めることはできません。 |
110 |
||||||
| Pronunciation |
string |
置換後の発音。長さは 10 文字未満である必要があります。漢字で構成され、スペースを含めることはできません。 |
110 |
||||||
| Type |
string |
特定の発音ルールタイプ。 有効な値:
|
replacement |
||||||
| ModelId |
string |
モデル ID。現在、minimax のみがサポートされています。有効な値: speech-01-turbo または speech-02-turbo。 |
speech-01-turbo |
||||||
| LanguageId |
string |
言語 ID。現在、minimax のみがサポートされています。デフォルト値: 空。このパラメーターは、指定された少数民族言語および方言の認識機能を強化します。構成後、指定された少数民族言語または方言のシナリオにおける音声パフォーマンスが向上します。少数民族言語のタイプが不明な場合は、このパラメーターを "auto" にセットすると、モデルが言語タイプを自動的に判断します(呼び出し)。有効な値: <詳細> <まとめ>サポートされている言語</まとめ>
|
Chinese |
||||||
| Emotion |
string |
感情。現在、minimax のみがサポートされています。minimax は次の 7 つの感情をサポートしています。
|
happy |
||||||
| SpeechRate |
number |
音声レート。すべてのプラットフォームでサポートされています。 cosyvoice の場合、デフォルト値は 1.0、有効値は 0.5 から 2.0 です。 minimax の場合、デフォルト値は 1.0、有効値は 0.5 から 2.0 です。 |
1.0 |
||||||
| LlmConfig |
object |
large 言語モデル (LLM) の構成。 |
|||||||
| LlmHistory |
array |
LLM またはマルチモーダル LLM (MLLM) の過去の会話コンテキスト。 |
|||||||
|
object |
単一の会話。 |
||||||||
| Role |
string |
会話参加者のロール。有効な値:
|
user |
||||||
| Content |
string |
会話の実際のテキストコンテンツ。会話におけるロールの特定の式または応答を記録します。 |
hello |
||||||
| LlmHistoryLimit |
integer |
LLM または MLLM の過去の会話コンテキストの保持される最大値のターン数。デフォルト値: 10。 |
10 |
||||||
| LlmSystemPrompt |
string |
呼び出し開始後の LLM のシステムプロンプト。 |
You are the 1 friendly and helpful assistant, focused on providing accurate information and advice to users. |
||||||
| 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\":[\"DocumentID1\",\"DocumentID2\"],\"metadata_filter\":{\"name\":\"ZhangSan\"},\"structured_filter\":{\"key1\":\"value1\",\"key2\":\"value2\"},\"tags\":[\"Tag1\",\"Tag2\"]}}" |
||||||
| OpenAIExtraQuery |
string |
OpenAI 互換 LLM の追加クエリパラメーター。パラメーターは キー=value フォーマットである必要があります。複数のパラメーターはアンパサンド (&) で接続します。すべての値は文字列タイプである必要があります。 |
api-version=2024-02-01&api-key=sk-xxx |
||||||
| LlmCompleteReply |
boolean |
この特徴が有効にされると、LLM が完全な応答をレート生成した後、エージェントは完全な LLM 結果をクライアントに送信します。このスイッチは、字幕のストリーミング生成には影響しません。 |
true |
||||||
| FunctionMap |
array |
関数マッピングリスト。エージェントの機能を LLM 関数にマップするために使用されます。現在、ユーザー定義の OpenAI 互換 LLM を使用した関数呼び出しのみがサポートされています。 |
|||||||
|
object |
単一のマッピングルール。 |
||||||||
| Function |
string |
Alibaba Cloud エージェントシステムが提供する組み込み特徴の名前。現在、hangup (一部サービス停止) のみがサポートされています。 |
hangup |
||||||
| MatchFunction |
string |
この特徴に対応する LLM 関数の名前。この名前はユーザーがカスタマイズし、LLM で対応する特徴の呼び出しに使用されます。ユーザー定義の LLM プロトコルについては、標準 LLM API を参照してください。 |
hangup |
||||||
| OutputMinLength |
integer |
テキスト出力の最小値の長さ (文字数)。この長さより短いテキストはキャッシュされ、結合を待機します。有効な値: 0 から 100。値 0 または空は制限なしを示します。デフォルト値: 空。 |
5 |
||||||
| OutputMaxDelay |
integer |
テキスト出力の最大値の遅延時間 (ミリ秒)。この時間を超えると、キャッシュされたテキストが強制的に出力されます。有効な値: 1000 から 10000。値 0 または空は制限なしを示します。デフォルト値: 空。 |
2000 |
||||||
| HistorySyncWithTTS |
boolean |
LLM メッセージリストが TTS 再生コンテンツと一致しているかどうかを指定します。デフォルト値: false。この特徴が有効にされると、保存された LLM メッセージが TTS 再生コンテンツと一致します。 説明
LLM メッセージリストにおいて、ユーザーがエージェントに割り込んだ場合(一部サービス停止)、LLM に送信される次のメッセージの割り込み位置に <ims_agent_interrupted> タグが挿入されます。例: |
false |
||||||
| AvatarConfig |
object |
デジタルヒューマンの構成。この構成は、ワークフローにデジタルヒューマンノードが含まれている場合にのみ効果を発揮します。 |
|||||||
| AvatarId |
string |
デジタルヒューマンのモデル ID。 |
5257 |
||||||
| InterruptConfig |
object |
音声割り込みポリシーの構成。 |
|||||||
| EnableVoiceInterrupt |
boolean |
音声割り込みをサポートするかどうかを指定します。デフォルト値: true。 |
true |
||||||
| InterruptWords |
array |
会話の割り込みをトリガーする特定の単語またはフレーズのリスト。 |
|||||||
|
string |
会話の割り込みをトリガーする特定の単語またはフレーズ。 |
Excuse me |
|||||||
| NoInterruptMode |
string |
<割り込みなし> モードでの ASR 処理ポリシー。
デフォルトポリシーは、ASR テキストをキャッシュすることです。 |
cache |
||||||
| KeepInterruptWordsForLLM |
boolean |
LLM にテキストを送信する際に割り込み単語を保持するかどうかを指定します。デフォルト値: discard。 説明
例: 割り込み単語が "wait" の場合、"wait how is the weather today" という文は、割り込み単語が破棄されて LLM に送信された後、"how is the weather today" になります。 |
true |
||||||
| VoiceprintConfig |
object |
ボイスプリントの構成。 |
|||||||
| UseVoiceprint |
boolean |
ボイスプリント認識を有効にするかどうかを指定します。デフォルト値: false。ボイスプリント認識が有効な場合、有効なボイスプリント ID を渡す必要があります。 |
false |
||||||
| VoiceprintId |
string |
ボイスプリント認識の一意の ID。デフォルト値: 空。渡されるボイスプリント ID は、ボイスプリント登録 API を通じて登録されている必要があります。API ドキュメントについては、ボイスプリントの登録 を参照してください。 |
zhixiaoxia |
||||||
| RegistrationMode |
string |
ボイスプリント登録モード。デフォルト値: Explicit。
|
Explicit |
||||||
| TurnDetectionConfig |
object |
会話ターン検出の構成。 |
|||||||
| TurnEndWords |
array |
ユーザーのターンの終了を判断するために使用されるキーワードのリスト。 |
|||||||
|
string |
ユーザーのターンの終了を判断するために使用されるキーワード。 |
I'm done |
|||||||
| Mode |
string |
ターン検出モード。
|
Semantic |
||||||
| SemanticWaitDuration |
integer |
AI モードでの一時停止判断時間。単位: ミリ秒。デフォルト値: -1。
説明
このパラメーターは法線モードでは無効です。 |
-1 |
||||||
| Eagerness |
string |
熱意レベル。このパラメーターはセマンティックモードでのみ効果を発揮します。AI が一時停止を検出した後の応答速度をコントロールします。
デフォルト値: 空。 |
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 文字。 |
Are you still there? |
||||||
| Probability |
number |
プロンプトの選択確率。有効な値: 0 ~ 1。これは 0% ~ 100% に対応します。 |
0.5 |
||||||
| HangupEndWord |
string |
一部サービス停止時の終了挨拶。この挨拶は、ユーザーの無応答が長期間続いた後に呼び出しが切断される前にブロードキャストされます。最大長: 200 文字。 |
I'm hanging up, bye |
||||||
| LlmPending |
object |
LLM の応答遅延時のプロンプトの構成。 |
|||||||
| WaitTime |
integer |
LLM の応答の待機時間のしきい値 (ミリ秒単位)。このパラメーターは必須です。待機時間がこのしきい値を超えると、プロンプトがトリガーされます。有効な値: 500 ~ 10000。LLM の実際の応答時間に基づいてこの値を設定します。 |
3000 |
||||||
| Mode |
string |
||||||||
| Messages |
array |
問いかけプロンプトのコレクション。最大値 10 個のプロンプトがサポートされています。各プロンプトの長さは最大 100 文字です。確率の合計は 100% である必要があります。 |
|||||||
|
object |
問いかけプロンプトの構造。 |
||||||||
| Text |
string |
問いかけプロンプトのテキスト。最大長: 100 文字。 |
Just a moment |
||||||
| Probability |
number |
プロンプトの選択確率。有効な値: 0 ~ 1。これは 0% ~ 100% に対応します。 |
0.5 |
||||||
| BackChannelingConfigs |
array |
バックチャネリング構成モジュール。有効にすると、システムは特定のトリガータグで短いバックチャネリングワードをランダムにブロードキャストします。 |
|||||||
|
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 文字。複数の言語がサポートされています。このパラメーターは必須です。 |
ok |
||||||
| 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 文字。複数の言語がサポートされています。このパラメーターは必須です。 |
ok |
||||||
| Probability |
number |
フレーズのトリガー確率。有効な値: 0.0 ~ 1.0。このパラメーターは必須です。 |
0.3 |