すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:AIAgentConfig

最終更新日:Oct 09, 2026

パラメーター

タイプ

説明

例

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

エージェントの音声のボリューム。

  • 指定しない場合: デフォルトで Alibaba Cloud が推奨する適応型ボリュームモードが使用されます。

  • 指定する場合: 有効値は 0 から 400 です。出力ボリューム = ワークフロー内の音声出力ボリューム × volume / 100。例:

  1. volume を 0 にセットすると、出力ボリュームは 0 になります。

  2. volume を 100 にセットすると、出力ボリュームは元のボリュームになります。

  3. volume を 200 にセットすると、出力ボリュームは元のボリュームの 2 倍になります。

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: 中国語。

  • en: 英語。

  • zh_en: 中国語と英語の混合。

  • es: スペイン語。

  • jp: 日本語。

zh_mandarin

AsrMaxSilence

integer

音声セグメンテーションのサイレンス持続時間のしきい値。このしきい値を超えるサイレンスは文の中断とみなされます。有効な値: 200 から 1200。単位: ミリ秒。デフォルト値: 400。

400

AsrHotWords

array

ASR ホットワードリスト。リストは最大値 128 個のホットワードをサポートします。

string

ホットワード文字列。長さ: 1 から 10 文字。

check

VadLevel

integer

割り込みしきい値パラメーター。有効な値: 0 から 11。デフォルト値: 11。

  • 0: 音声活動検出 (VAD) 特徴を無効にします。

  • 1 から 10: 値が大きいほど、エージェントへの割り込みが難しくなります。

  • 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: Word を Pronunciation に直接置換するルール。

replacement

ModelId

string

モデル ID。現在、minimax のみがサポートされています。有効な値: speech-01-turbo または speech-02-turbo。

speech-01-turbo

LanguageId

string

言語 ID。現在、minimax のみがサポートされています。デフォルト値: 空。このパラメーターは、指定された少数民族言語および方言の認識機能を強化します。構成後、指定された少数民族言語または方言のシナリオにおける音声パフォーマンスが向上します。少数民族言語のタイプが不明な場合は、このパラメーターを "auto" にセットすると、モデルが言語タイプを自動的に判断します(呼び出し)。有効な値: <詳細> <まとめ>サポートされている言語</まとめ>

  • Chinese: 中国語

  • Chinese,Yue: 広東語

  • English: 英語

  • Arabic: アラビア語

  • Russian: ロシア語

  • Spanish: スペイン語

  • French: フランス語

  • Portuguese: ポルトガル語

  • German: ドイツ語

  • Turkish: トルコ語

  • Dutch: オランダ語

  • Ukrainian: ウクライナ語

  • Vietnamese: ベトナム語

  • Indonesian: インドネシア語

  • Japanese: 日本語

  • Italian: イタリア語

  • Korean: 韓国語

  • Thai: タイ語

  • Polish: ポーランド語

  • Romanian: ルーマニア語

  • Greek: ギリシャ語

  • Czech: チェコ語

  • Finnish: フィンランド語

  • Hindi: ヒンディー語

  • auto: 自動検出 </詳細>

Chinese

Emotion

string

感情。現在、minimax のみがサポートされています。minimax は次の 7 つの感情をサポートしています。

  • happy: 喜び

  • sad: 悲しみ

  • angry: 怒り

  • fearful: 恐れ

  • disgusted: 嫌悪

  • surprised: 驚き

  • calm: 平静

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: ユーザー

  • assistant: アシスタント

  • system: システム

  • function: 関数

  • plugin: プラグイン

  • tool: ツール

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> タグが挿入されます。例:

[
  {"ロール": "user", "content": "物語を教えてください。"},
  {"ロール": "assistant", "content": "はい、三国志演義の物語をお話ししましょう。<ims_agent_interrupted>聴きたいですか?"},
  {"ロール": "user", "content": "別のものに変えましょう。"}
]

false

AvatarConfig

object

デジタルヒューマンの構成。この構成は、ワークフローにデジタルヒューマンノードが含まれている場合にのみ効果を発揮します。

AvatarId

string

デジタルヒューマンのモデル ID。

5257

InterruptConfig

object

音声割り込みポリシーの構成。

EnableVoiceInterrupt

boolean

音声割り込みをサポートするかどうかを指定します。デフォルト値: true。

true

InterruptWords

array

会話の割り込みをトリガーする特定の単語またはフレーズのリスト。

string

会話の割り込みをトリガーする特定の単語またはフレーズ。

Excuse me

NoInterruptMode

string

<割り込みなし> モードでの ASR 処理ポリシー。

  • cache: ASR テキストをキャッシュします。現在のターンが終了した後、キャッシュされた ASR テキストは次のターンで一緒に処理されます。

  • discard: 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明示的登録モード。ユーザーは事前にボイスプリント登録 API 呼び出しを通じて音声をアップロードし、登録を完了する必要があります。
Implicit暗黙的登録モード。会話中にユーザーの音声が自動的に収集され、ボイスプリント特徴をレート生成します。

Explicit

TurnDetectionConfig

object

会話ターン検出の構成。

TurnEndWords

array

ユーザーのターンの終了を判断するために使用されるキーワードのリスト。

string

ユーザーのターンの終了を判断するために使用されるキーワード。

I'm done

Mode

string

ターン検出モード。

  • 法線 (デフォルト): 法線モード。セマンティクスの判断に AI は使用されません。

  • Semantic: セマンティックモード。コンテキストのセマンティクスに基づいて、ユーザーの発話が終了したかどうかを判断するために AI が使用されます。

Semantic

SemanticWaitDuration

integer

AI モードでの一時停止判断時間。単位: ミリ秒。デフォルト値: -1。

  • -1: AI が適切な待機時間を自動的に判断します(呼び出し)。

  • 0 から 10000: カスタム待機時間。0 から 1500 ミリ秒にセットすることをお勧めします。

説明

このパラメーターは法線モードでは無効です。

-1

Eagerness

string

熱意レベル。このパラメーターはセマンティックモードでのみ効果を発揮します。AI が一時停止を検出した後の応答速度をコントロールします。

  • "Low": 辛抱強い待機。最大値の待機時間は 6 秒で、割り込まれるリスクを低減します。

  • "Medium": バランスの取れた待機。最大値の待機時間は 4 秒で、ほとんどのシナリオに適しています。

  • "High": 高速応答。最大値の待機時間は 2 秒で、速度は向上しますが、誤った区切りのリスクが高まる可能性があります。

デフォルト値: 空。

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: 音声の短い一時停止が検出された場合。

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: 音声の短い一時停止が検出された場合。

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