> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 新しいブランチを作成

POST https://api.elevenlabs.io/v1/convai/agents/{agent_id}/branches
Content-Type: application/json

任意のブランチの指定バージョンから新しいブランチを作成します

Reference: https://elevenlabs.io/docs/api-reference/agents/branches/create

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `agent_id` (string, required) — エージェントのID。エージェント作成時に返されます。

### Body (application/json)

This endpoint expects a Body_Create_a_new_branch_v1_convai_agents__agent_id__branches_post.

- `parent_version_id` (string, required) — ブランチの元にするバージョンのID
- `name` (string, required) — ブランチの名前。エージェント内で一意です。
- `description` (string, required) — ブランチの説明
- `conversation_config` (map from string to any, optional, nullable) — 会話設定に適用する変更
- `platform_settings` (map from string to any, optional, nullable) — プラットフォーム設定に適用する変更
- `workflow` (AgentWorkflowRequestModel, optional, nullable) — 更新後のワークフロー定義
- `include_draft` (boolean, optional, default: false) — trueの場合、新しいブランチはブランチ先端ではなく呼び出し元のドラフト手順セットを使用します。parent_version_idはブランチ先端である必要があります。

## Response

### 200

成功レスポンス。

- `created_branch_id` (string, required) — 作成されたブランチのID
- `created_version_id` (string, required) — 作成されたブランチの最初のバージョンのID

## Errors

### 422 Unprocessable Entity Error

検証エラー

- `detail` (list of ValidationError, optional)

## Types

### AgentWorkflowRequestModel

- `edges` (map from string to WorkflowEdgeModel-Input, optional)
- `nodes` (map from string to AgentWorkflowRequestModelNodes, optional)
- `prevent_subagent_loops` (boolean, optional, default: false) — ワークフロー実行時のループを防止するかどうか。

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### WorkflowEdgeModel-Input

- `source` (string, required) — ソースノードのID。
- `target` (string, required) — ターゲットノードのID。
- `forward_condition` (WorkflowEdgeModelInputForwardCondition, optional, nullable) — エッジを順方向（ソースからターゲット）にたどるために満たす必要がある条件。
- `backward_condition` (WorkflowEdgeModelInputBackwardCondition, optional, nullable) — エッジを逆方向（ターゲットからソース）にたどるために満たす必要がある条件。

### AgentWorkflowRequestModelNodes

- `type`: `end` (WorkflowEndNodeModel)
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `outcome` (enum, optional, default: success) — このEndノードに到達したときに、会話を成功または失敗として終了するかどうか。
    - Allowed values: `success`, `failure`
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
- `type`: `override_agent` (WorkflowOverrideAgentNodeModel)
  - `label` (string, required) — UI全体で使用する、人間が読めるノードラベルです。
  - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — サブエージェントがアクセスできる追加のナレッジベースドキュメントです。メインエージェントのドキュメントに加えて使用されます。
  - `additional_prompt` (string, optional) — このサブエージェントの具体的な目標です。システムプロンプトに追加され、この特定のコンテキストにおけるエージェントの動作をさらに調整するために使用できます。
  - `additional_tool_ids` (list of string, optional) — サブエージェントがアクセスできる追加ツールのID。メインエージェントのツールに加えて使用されます。
  - `conversation_config` (ConversationalConfigAPIModelWorkflowOverride-Input, optional) — サブエージェントが会話を行っている間に適用される設定のオーバーライド。
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `entry_behavior` (enum, optional, default: auto) — このノードに入った直後にレスポンスを生成するか、ユーザー入力を待つかを指定します。"auto"に設定すると、直前のノードのタイプに応じて動作が決まります。"say"ノードおよび"start"ノードの後は"wait_for_user"、それ以外は"generate_immediately"になります。
    - Allowed values: `generate_immediately`, `wait_for_user`, `auto`
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
- `type`: `phone_number` (WorkflowPhoneNumberNodeModel)
  - `transfer_destination` (WorkflowPhoneNumberNodeModelInputTransferDestination, required)
  - `custom_sip_headers` (list of WorkflowPhoneNumberNodeModelInputCustomSipHeadersItems, optional) — 通話転送時に含めるカスタムSIPヘッダー。各ヘッダーには静的な値または動的変数参照を指定できます。
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
  - `post_dial_digits` (WorkflowPhoneNumberNodeModelInputPostDialDigits, optional, nullable) — 通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）。静的値または動的変数参照を指定できます。0.5秒の一時停止には'w'を使用します。Twilio転送でのみサポートされます。
  - `sip_refer_play_dialtone` (boolean, optional, default: true) — Trueの場合、SIP REFER転送の完了中に、元の通話レッグで呼び出し音が再生されます。この音はRTP経由でREFERを実行するSIPピアに送られるため、受信システム（SBCやコンタクトセンターなど）でこの音を聞かせたくない場合は無効にしてください。無効にすると、転送が完了するまで発信者には無音が聞こえます。SIP REFER転送でのみ使用できます。
  - `transfer_type` (enum, optional, default: conference)
    - Allowed values: `blind`, `conference`, `sip_refer`
  - `uui` (UUITransferConfig, optional, nullable) — SIP REFER転送に添付するUser-to-User Information（RFC 7433）。CRM識別子やエスカレーション理由などの通話コンテキストを、転送の境界を越えて引き継ぎます。
- `type`: `standalone_agent` (WorkflowStandaloneAgentNodeModel)
  - `agent_id` (string, optional, nullable) — 会話の転送先エージェントのID。Noneは現在のエージェント内で転送することを意味します。
  - `branch_id` (string, optional, nullable) — 対象エージェントの任意のブランチIDです。Noneの場合は対象エージェントのトラフィックデプロイメントに従います。node_idが設定されている場合は、そのメインブランチを使用します。
  - `delay_ms` (integer, optional, default: 0) — 会話を転送する前に適用する人工的な遅延（ミリ秒）。
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `enable_transferred_agent_first_message` (boolean, optional, default: false) — 転送後、転送先エージェントが設定済みの最初のメッセージを送信できるようにするかどうか。
  - `node_id` (string, optional, nullable) — 送信先エージェントのワークフロー内にある任意の対象ノードID。設定すると、デフォルトのエントリノードではなく、このノードから転送を開始します。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
  - `preserve_client_tts_overrides` (boolean, optional, default: false) — TTSクライアントのオーバーライドを転送先のエージェントに引き継ぐかどうかを定義します。
  - `preserve_voice_settings` (boolean, optional, default: false) — ベース音声、TTSモデル、音声設定を転送先のエージェントに引き継ぐかどうかを定義します。
  - `transfer_message` (string, optional, nullable) — 転送を開始する前にユーザーへ送信する任意のメッセージです。
- `type`: `start` (WorkflowStartNodeModel)
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
- `type`: `tool` (WorkflowToolNodeModel)
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
  - `tools` (list of WorkflowToolLocator, optional) — 並列実行するツールのリスト。すべてのツールが正常に実行された場合、ノード全体が成功と見なされます。
- `type`: `say` (WorkflowSayNodeModel)
  - `label` (string, required) — UI全体で使用する、人間が読めるノードラベルです。
  - `message` (WorkflowSayNodeModelInputMessage, required) — このノードが発話するメッセージです。正確なテキストには `literal` を使用し、説明からLLMにメッセージを生成させるには `prompt` を使用します。
  - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — このノードがメッセージを生成する際に、エージェントのドキュメントに加えてLLMが利用できるナレッジベースのドキュメントです。
  - `additional_prompt` (string, optional) — サブエージェントノードとの一貫性のために受け付けられますが、使用されません。メッセージは `message.prompt` に記述するか、システムプロンプトを `conversation_config.agent.prompt.prompt` に置き換えてください。
  - `additional_tool_ids` (list of string, optional) — サブエージェントノードとの一貫性のために受け付けられますが、使用されません。sayノードはツールを呼び出せません。
  - `conversation_config` (ConversationalConfigAPIModelWorkflowOverride-Input, optional) — このノードの発話中に適用される設定のオーバーライドです。音声や、プロンプトメッセージの場合はLLMとシステムプロンプトが含まれます。
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。
  - `wait_for_speech_completion` (boolean, optional, default: false) — trueの場合、メッセージを最後まで発話してからワークフローが次のノードに移動します。
  - `wait_for_user_response` (boolean, optional, default: false) — trueの場合、ノードはメッセージを発話した後、出力エッジを評価する前にユーザーの応答を待ちます。これにより、応答に応じてエッジを分岐できます。ユーザーが応答しない場合、ターンのタイムアウト後にワークフローが進みます。
- `type`: `update_state` (WorkflowUpdateStateNodeModel)
  - `label` (string, required) — UI全体で使用する、人間が読めるノードラベルです。
  - `updates` (list of WorkflowStateUpdate-Input, required) — ワークフローがこのノードに到達したときに適用される状態更新です。1つのノードで受け付けられる更新は最大50件です。
  - `edge_order` (list of string, optional) — 評価順の出力エッジID。
  - `position` (Position-Input, optional) — ワークフロー内のノード位置。

### ValidationErrorLocItems

### WorkflowEdgeModelInputForwardCondition

エッジを順方向（ソースからターゲット）にたどるために満たす必要がある条件。

- `type`: `expression` (WorkflowExpressionConditionModel)
  - `expression` (ASTNode-Input, required) — 評価する式です。
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `llm` (WorkflowLLMConditionModel)
  - `condition` (string, required) — 評価する条件
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `result` (WorkflowResultConditionModel)
  - `successful` (boolean, required) — 前回実行されたツールノード内のすべてのツールが正常に実行されたかどうか。
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `unconditional` (WorkflowUnconditionalModel)
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。

### WorkflowEdgeModelInputBackwardCondition

エッジを逆方向（ターゲットからソース）にたどるために満たす必要がある条件。

- `type`: `expression` (WorkflowExpressionConditionModel)
  - `expression` (ASTNode-Input, required) — 評価する式です。
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `llm` (WorkflowLLMConditionModel)
  - `condition` (string, required) — 評価する条件
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `result` (WorkflowResultConditionModel)
  - `successful` (boolean, required) — 前回実行されたツールノード内のすべてのツールが正常に実行されたかどうか。
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。
- `type`: `unconditional` (WorkflowUnconditionalModel)
  - `label` (string, optional, nullable) — UI全体で使用する条件の、人が読める任意のラベルです。

### Position-Input

- `x` (double, optional, default: 0)
- `y` (double, optional, default: 0)

### KnowledgeBaseLocator

- `type` (enum, required) — ナレッジベースのタイプ
  - Allowed values: `file`, `url`, `text`, `folder`
- `name` (string, required) — ナレッジベースの名前。
- `id` (string, required) — ナレッジベースのID
- `usage_mode` (enum, optional, default: auto) — ナレッジベースの使用モード
  - Allowed values: `prompt`, `auto`

### ConversationalConfigAPIModelWorkflowOverride-Input

- `asr` (ASRConversationalConfigWorkflowOverride, optional, nullable) — 会話用文字起こしの設定
- `turn` (TurnConfigWorkflowOverride, optional, nullable) — ターン検出の設定
- `tts` (TTSConversationalConfigWorkflowOverride-Input, optional, nullable) — 会話用テキスト読み上げの設定
- `conversation` (ConversationConfigWorkflowOverride-Input, optional, nullable) — 会話イベントの設定
- `language_presets` (map from string to LanguagePreset-Input, optional, nullable) — 会話用の言語プリセット
- `vad` (VADConfigWorkflowOverride, optional, nullable) — 音声アクティビティ検出の設定
- `agent` (AgentConfigAPIModelWorkflowOverride-Input, optional, nullable) — エージェント固有の設定

### WorkflowPhoneNumberNodeModelInputTransferDestination

- `type`: `phone` (PhoneNumberTransferDestination)
  - `phone_number` (string, required)
- `type`: `phone_dynamic_variable` (PhoneNumberDynamicVariableTransferDestination)
  - `phone_number` (string, required)
- `type`: `sip_uri` (SIPUriTransferDestination)
  - `sip_uri` (string, required)
- `type`: `sip_uri_dynamic_variable` (SIPUriDynamicVariableTransferDestination)
  - `sip_uri` (string, required)

### WorkflowPhoneNumberNodeModelInputCustomSipHeadersItems

- `type`: `dynamic` (CustomSIPHeaderWithDynamicVariable)
  - `key` (string, required) — SIPヘッダー名（例：'X-Customer-ID'）
  - `value` (string, required) — 解決する動的変数名
- `type`: `static` (CustomSIPHeader)
  - `key` (string, required) — SIPヘッダー名（例：'X-Customer-ID'）
  - `value` (string, required) — ヘッダー値

### WorkflowPhoneNumberNodeModelInputPostDialDigits

通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）。静的値または動的変数参照を指定できます。0.5秒の一時停止には'w'を使用します。Twilio転送でのみサポートされます。

- `type`: `dynamic` (PostDialDigitsDynamicVariable)
  - `value` (string, required) — 解決する動的変数名
- `type`: `static` (PostDialDigitsStatic)
  - `value` (string, required) — 通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）

### UUITransferConfig

SIP REFER転送用のUser-to-User Informationエンベロープ（RFC 7433）。 送信ペイロードは16進数でエンコードされます（RFC 7433で定義されている唯一のエンコード方式です）。 プロトコル識別子の軸により、プラットフォームごとの形式（Talkdesk、Genesysなど）を、分散した転送フラグではなく設定で表現できます。転送モデルを変更せずに、 追加の軸（ASCIIエンコード、ヘッダー名、目的／コンテンツパラメータ）をここに追加できます。

- `data` (string, required) — SIP REFER転送時に送信するUUIペイロード。インライン動的変数をサポートし、転送時に16進数でエンコードされます。
- `protocol_discriminator` (string, optional, nullable) — 任意の1オクテットプロトコル識別子（16進数2桁、例：'00'）です。Genesys Cloudなど、指定しない場合にペイロードの先頭オクテットを削除するプラットフォームでは必須です。裸の16進ペイロードを期待するTalkdeskなどのプラットフォームでは設定しないでください。
- `protocol_discriminator_mode` (enum, optional, default: prefix) — protocol\_discriminatorの付加方法です。'prefix'は16進ペイロードの先頭にオクテットを追加します（User-to-User=XX\<hex>;encoding=hex）。'pd\_parameter'は別のパラメーターとして送信します（User-to-User=\<hex>;pd=XX;encoding=hex）。protocol\_discriminatorが未設定の場合は無視されます。
  - Allowed values: `prefix`, `pd_parameter`

### WorkflowToolLocator

- `tool_id` (string, required)
- `schema_overrides` (map from string to WorkflowToolLocatorSchemaOverrides, optional, nullable) — ツール固有の設定に加えて適用されるノードごとのパラメーターオーバーライド。キーはドット区切りのパラメーターパスです（Webhookツールでは、キーにpath_params./query_params./request_body.のプレフィックスが付きます）。ツール自体にすでに定義されているオーバーライドより優先されます。

### WorkflowSayNodeModelInputMessage

このノードが発話するメッセージです。正確なテキストには `literal` を使用し、説明からLLMにメッセージを生成させるには `prompt` を使用します。

- `type`: `literal` (SayNodeLiteralMessage)
  - `text` (string, required) — エージェントが発話する正確なテキストです。`{{variable_name}}` の動的変数プレースホルダーに対応しています。
  - `text_translations` (map from string to TranslatedString, optional) — 言語コードをキーとする `text` の翻訳です。会話言語に対応するエントリがある場合は、`text` の代わりにその値が発話されます。
- `type`: `prompt` (SayNodePromptMessage)
  - `prompt` (string, required) — LLMが生成するメッセージの説明です。このノードがアクティブな間、エージェントのシステムプロンプトに追加されます。

### WorkflowStateUpdate-Input

- `variable_name` (string, required) — 割り当てる動的変数の名前です。
- `expression` (ASTNode-Input, required) — 結果が変数に割り当てられる式です。定数、他の動的変数、LLMで抽出した値、演算子を組み合わせられます。
- `type` ("dynamic_variable", optional, default: dynamic_variable)
- `required` (boolean, optional, default: true) — falseの場合、LLMはこの更新が依存する値を省略することがあります。その場合、更新はスキップされ、変数は現在の値を維持します。

### ASTNode-Input

- `type`: `add_operator` (ASTAdditionOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `and_operator` (ASTAndOperatorNode)
  - `children` (list of ASTNode-Input, required) — 論理演算子の子ノード。
- `type`: `boolean_literal` (ASTBooleanNode)
  - `value` (boolean, required) — このリテラルの値。
- `type`: `conditional_operator` (ASTConditionalOperatorNode)
  - `condition` (ASTNode-Input, required) — どの式を選択するかを決定する条件。
  - `falseExpression` (ASTNode-Input, required) — 条件がfalseの場合に選択される式です。
  - `trueExpression` (ASTNode-Input, required) — 条件がtrueの場合に選択される式です。
- `type`: `div_operator` (ASTDivisionOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `dynamic_variable` (ASTDynamicVariableNode)
  - `name` (string, required) — 動的変数の名前。
- `type`: `eq_operator` (ASTEqualsOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `gt_operator` (ASTGreaterThanOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `gte_operator` (ASTGreaterThanOrEqualsOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `llm` (llm)
- `type`: `lt_operator` (ASTLessThanOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `lte_operator` (ASTLessThanOrEqualsOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `mul_operator` (ASTMultiplicationOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `neq_operator` (ASTNotEqualsOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。
- `type`: `null_literal` (ASTNullNode)
- `type`: `number_literal` (ASTNumberNode)
  - `value` (AstNumberNodeInputValue, required) — このリテラルの値。
- `type`: `or_operator` (ASTOrOperatorNode)
  - `children` (list of ASTNode-Input, required) — 論理演算子の子ノード。
- `type`: `string_literal` (ASTStringNode)
  - `value` (string, required) — このリテラルの値。
- `type`: `sub_operator` (ASTSubtractionOperatorNode)
  - `left` (ASTNode-Input, required) — 二項演算子の左オペランド。
  - `right` (ASTNode-Input, required) — 二項演算子の右オペランド。

### ASRConversationalConfigWorkflowOverride

- `quality` (enum, optional, nullable, default: high) — 文字起こしの品質
  - Allowed values: `high`
- `provider` (enum, optional, nullable, default: scribe_realtime) — 文字起こしサービスのプロバイダー
  - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo`
- `user_input_audio_format` (enum, optional, nullable, default: pcm_16000) — 文字起こしするオーディオの形式
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `keywords` (list of string, optional, nullable) — 予測確率を高めるキーワード

### TurnConfigWorkflowOverride

- `turn_timeout` (double, optional, nullable) — ユーザーに再度働きかけるまでの、ユーザーからの返信の最大待機時間
- `initial_wait_time` (double, optional, nullable) — 最初のメッセージが空の場合に、エージェントがユーザーの会話開始を待機する時間です。設定しない場合は、通常のturn_timeoutを使用します。
- `silence_end_call_timeout` (double, optional, nullable) — 通話を終了するまでの、ユーザーが最後に発話してからの最大待機時間
- `turn_eagerness` (enum, optional, nullable, default: normal) — エージェントがどの程度積極的に応答するかを制御します。Low＝積極性が低い（より長く待機）、Standard＝デフォルトの積極性、High＝積極性が高い（より早く応答）
  - Allowed values: `patient`, `normal`, `eager`
- `spelling_patience` (enum, optional, nullable, default: auto) — ユーザーが数字や固有表現をつづっている際に、エージェントがより長く待機するかどうかを制御します。Auto＝モデルに基づいて判断、Off＝追加で待機しません。
  - Allowed values: `auto`, `off`
- `speculative_turn` (boolean, optional, nullable) — 有効にすると、ターンの信頼度が完全に確定する前の無音中にLLM応答の生成を開始し、体感レイテンシーを削減します。LLMのコストが増加する可能性があります。
- `retranscribe_on_turn_timeout` (boolean, optional, nullable) — 有効にすると、VADが音声を検出しなかった場合、ターンのタイムアウト時に蓄積されたオーディオの再文字起こしを試みます。アクティブなエージェントまたはワークフローノードで有効な間は、無音割引の請求が無効になります。
- `turn_model` (enum, optional, nullable, default: turn_v3) — 使用するターン検出モデルのバージョン。
  - Allowed values: `turn_v2`, `turn_v3`
- `interruption_ignore_terms` (list of string, optional, nullable) — ユーザーが発話しても割り込みをトリガーしない用語のリスト（例：'gotcha'、'understood'）。大文字・小文字を区別しない完全一致を使用します。
- `interruption_ignore_term_languages` (list of string, optional, nullable) — プリセットの無視タームカテゴリが有効化されている言語コードです。表示がタームの重複から推測されないよう、明示的に保存されます。
- `merge_with_default_ignore_terms` (boolean, optional, nullable) — 有効にすると、interruption_ignore_termsに加えて、interruption_ignore_term_languages用に厳選されたデフォルト用語が使用されます。
- `transcribe_on_disabled_interruptions` (boolean, optional, nullable) — 割り込みが無効な場合でも、次のターンに引き継げるようユーザーの発話を文字起こしします。無効の場合、割り込み不可のターン中のユーザー発話は無視され、ターンは開始されません。
- `soft_timeout_config` (SoftTimeoutConfigWorkflowOverride, optional, nullable) — ソフトタイムアウト機能の設定です。長いLLMレスポンスの処理中に即時フィードバックを提供します。

### TTSConversationalConfigWorkflowOverride-Input

- `model_id` (enum, optional, nullable, default: eleven_v4_turbo) — TTSに使用するモデル。
  - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo`
- `voice_id` (string, optional, nullable) — TTSに使用する音声ID
- `supported_voices` (list of SupportedVoice, optional, nullable) — エージェントで追加対応する音声
- `expressive_mode` (boolean, optional, nullable) — 有効にすると、表現豊かなオーディオタグのプロンプトを適用します。v3以外のモデルでは自動的に無効になります。
- `suggested_audio_tags` (list of SuggestedAudioTag, optional, nullable) — 表現力豊かな音声を強化するための推奨オーディオタグ（eleven_v3およびeleven_v3_conversationalモデル用）。エージェントは、ここに記載されていない他のタグも使用できます。
- `agent_output_audio_format` (enum, optional, nullable, default: pcm_16000) — TTSに使用するオーディオ形式
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `optimize_streaming_latency` (enum, optional, nullable) — 非推奨：このフィールドは何も行わず、無視されます。
  - Allowed values: `0`, `1`, `2`, `3`, `4`
- `stability` (double, optional, nullable) — 生成された音声の安定性
- `speed` (double, optional, nullable) — 生成された音声の速度
- `similarity_boost` (double, optional, nullable) — 生成された音声の類似性ブースト
- `text_normalisation_type` (enum, optional, nullable, default: system_prompt) — テキストを音声に変換する前に数字を単語に変換する方法。SYSTEM_PROMPTに設定すると、正規化の指示を含むようシステムプロンプトが更新されます。ELEVENLABSに設定すると、生成後にテキストが正規化されるため、わずかに追加のレイテンシーが発生します。
  - Allowed values: `system_prompt`, `elevenlabs`
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional, nullable) — 発音辞書ロケーター
- `enable_phoneme_tags` (boolean, optional, nullable) — V3モデルでのSSML音素タグ処理を有効にします。有効にすると、音素タグ（インラインおよび発音辞書由来）はモデルに送信される前にインラインIPAへ解析されます。
- `audio_effects` (EffectsSpec-Input, optional, nullable) — 任意のTTSエフェクト指定：フィルタープリセット、距離（近接EQ）、環境（コンボリューションリバーブ）。

### ConversationConfigWorkflowOverride-Input

- `text_only` (boolean, optional, nullable) — 有効にするとオーディオは処理されず、テキストのみが使用されます。オーディオ料金を回避するために使用します。
- `max_duration_seconds` (integer, optional, nullable) — 会話の最大時間（秒）。
- `client_events` (list of enum, optional, nullable) — クライアントに送信されるイベント
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `file_input` (FileInputConfigWorkflowOverride, optional, nullable) — 会話中のファイル入力（画像／PDFアップロード）の設定。
- `monitoring_enabled` (boolean, optional, nullable) — WebSocket経由の会話のリアルタイム監視を有効にします
- `monitoring_events` (list of enum, optional, nullable) — モニタリング接続に送信されるイベント。
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `dtmf_input_settings` (DTMFInputConfig, optional, nullable) — 電話中のDTMF（キーパッド）入力収集を設定する
- `background_sound` (BackgroundSoundConfigWorkflowOverride, optional, nullable) — 会話中のバックグラウンドサウンドの設定。
- `source_attribution` (boolean, optional, nullable) — 有効にし、ナレッジベースのコンテンツが存在する場合、LLMは使用したソースを報告するよう指示されます。

### LanguagePreset-Input

- `overrides` (ConversationConfigClientOverride-Input, required) — 言語プリセットのオーバーライド設定
- `first_message_translation` (LanguagePresetTranslation, optional, nullable) — 最初のメッセージの翻訳
- `soft_timeout_translation` (LanguagePresetTranslation, optional, nullable) — ソフトタイムアウトメッセージの翻訳

### VADConfigWorkflowOverride

### AgentConfigAPIModelWorkflowOverride-Input

- `first_message` (string, optional, nullable) — 空でない場合、エージェントが最初に発するメッセージです。空の場合、エージェントはユーザーが会話を開始するのを待ちます。
- `language` (string, optional, nullable) — エージェントの言語（ASRおよびTTSで使用）
- `hinglish_mode` (boolean, optional, nullable) — 有効にすると、エージェントはヒンディー語、マラヤーラム語、テルグ語、カンナダ語での応答に英単語や英語のフレーズを混在させます。
- `dynamic_variables` (DynamicVariablesConfigWorkflowOverride, optional, nullable) — 動的変数の設定
- `disable_first_message_interruptions` (boolean, optional, nullable) — trueの場合、最初のメッセージの配信中はユーザーがエージェントを中断できません。
- `max_conversation_duration_message` (string, optional, nullable) — 空でない場合、会話の最大時間に達したときにエージェントが送信するメッセージです。
- `text_behavior_overrides` (map from string to BehaviorOverride, optional, nullable) — テキスト会話におけるチャネルごとの応答動作オーバーライド。未設定の場合、組み込みチャネルのデフォルトが適用されます。
- `prompt` (PromptAgentAPIModelWorkflowOverride-Input, optional, nullable) — エージェント用のプロンプト

### WorkflowToolLocatorSchemaOverrides

- `source`: `constant` (ConstantSchemaOverride)
  - `constant_value` (WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue, required, nullable) — 使用する定数値
- `source`: `dynamic_variable` (DynamicVariableSchemaOverride)
  - `dynamic_variable` (string, required) — 使用する動的変数の名前。
- `source`: `llm` (LLMSchemaOverride)
  - `prompt` (string, optional, nullable) — LLMのプロンプトオーバーライド。指定しない場合は、元のスキーマの説明が使用されます。
- `source`: `omit` (OmitSchemaOverride)

### TranslatedString

- `value` (string, required)

### AstNumberNodeInputValue

このリテラルの値。

### SoftTimeoutConfigWorkflowOverride

- `timeout_seconds` (double, optional, nullable) — LLMの応答を待つ間に定義済みメッセージを表示するまでの時間（秒）。無効にするには-1を設定します。
- `message` (string, optional, nullable) — LLM応答の待機中に最初のソフトタイムアウトに達したときに表示するメッセージ。動的変数（例：\{\{system\_\_time}}、\{\{custom\_variable}}）に対応しています。
- `additional_soft_timeout_messages` (list of string, optional, nullable) — 同じLLM生成内で後続のソフトタイムアウト時に使用する追加の固定フィラーメッセージです。最初のタイムアウトでは`message`を使用します。設定されているメッセージ数が`max_soft_timeouts_per_generation`より少ない場合は、最後に設定されたメッセージを繰り返します。それ以外の場合は、組み込みのフィラーを使用します。
- `use_llm_generated_message` (boolean, optional, nullable) — 有効にすると、静的メッセージの代わりにソフトタイムアウトメッセージが動的に生成されます。
- `randomize_fillers` (boolean, optional, nullable) — 有効にすると、各ターンの開始時に静的なソフトタイムアウトメッセージの順序を1回シャッフルします。use_llm_generated_messageがfalseの場合にのみ適用されます。
- `max_soft_timeouts_per_generation` (integer, optional, nullable) — 1件のLLM応答を待機している間に送信するフィラーメッセージの最大数。LLMがコンテンツのストリーミングを開始するか、この上限に達するまで、timeout_secondsごとに送信されます。
- `llm_generated_message_prompt_override` (string, optional, nullable) — use\_llm\_generated\_messageが有効な場合に、ソフトタイムアウト用のフィラーメッセージを生成するカスタムプロンプト。直近の会話コンテキストは別のユーザーメッセージとして提供されます。未設定の場合はデフォルトのプロンプトが使用されます。動的変数（例：\{\{system\_\_time}}、\{\{custom\_variable}}）をサポートします。
- `disable_until_first_user_message` (boolean, optional, nullable) — trueの場合、会話に実際のユーザーメッセージが少なくとも1つ含まれるまで、ソフトタイムアウトのフィラーを抑制します。エージェントの開始ターン中（例：ワークフローの即時生成や、ユーザーの発話前のツール呼び出し）にフィラーが入るのを防ぎます。

### SupportedVoice

- `label` (string, required)
- `voice_id` (string, required)
- `description` (string, optional, nullable)
- `language` (string, optional, nullable)
- `model_family` (enum, optional, nullable)
  - Allowed values: `turbo`, `flash`, `multilingual`, `v3_conversational`, `v4`, `v4_turbo`
- `optimize_streaming_latency` (enum, optional, nullable)
  - Allowed values: `0`, `1`, `2`, `3`, `4`
- `stability` (double, optional, nullable)
- `speed` (double, optional, nullable)
- `similarity_boost` (double, optional, nullable)

### SuggestedAudioTag

- `tag` (string, required) — 使用するオーディオタグ（最適なパフォーマンスのため、1～2語。例：'happy'、'excited'）
- `description` (string, optional, nullable) — このタグを使用するタイミングに関する任意の説明

### PydanticPronunciationDictionaryVersionLocator

他のドキュメントが特定の辞書とそのバージョンを参照できるようにするロケーターです。 これはPronunciationDictionaryVersionLocatorDBModelのPydanticバージョンです。 他のエージェントデータモデルとの互換性を確保するために必要です。

- `pronunciation_dictionary_id` (string, required) — 発音辞書のID
- `version_id` (string, required, nullable) — 発音辞書バージョンのID

### EffectsSpec-Input

生成された音声に適用するオーディオエフェクトです。フィルタープリセット、知覚距離、リバーブ 環境、バックグラウンドノイズベッド、ステレオパンニングを含みます。未処理のオーディオを取得するには、すべてのフィールドをデフォルト値のままにしてください。

- `filter_preset_id` (string, optional, nullable) — `phone` や `old_radio` など、音声の音色を変えるフィルタープリセットのID。有効なIDは `GET /v1/audio-effects/catalog` で取得できます。
- `distance` (double, optional, default: 0) — 話者がマイクからどの程度離れて聞こえるかを指定します。0（近い、変更なし）から1（遠い）までです。値を大きくすると低域と高域が減衰し、環境が設定されている場合は、ドライ音声からリバーブへのバランスが移動します。
- `environment_id` (string, optional, nullable) — `small_room` や `hall` など、音声を空間内に配置するリバーブ環境のID。有効なIDは `GET /v1/audio-effects/catalog` で取得できます。リバーブはステレオでレンダリングされ、音声終了後に最大数秒の残響が追加されます。
- `background_noise_id` (string, optional, nullable) — `cafe` や `keyboard` など、音声の下でループ再生するバックグラウンドノイズベッドのID。有効なIDは `GET /v1/audio-effects/catalog` で取得できます。
- `send_level` (double, optional, default: 1) — 音声をどの程度リバーブに送るかを指定します。0（なし）から1（最大）までです。`environment_id` が設定されている場合にのみ適用されます。0ではリバーブが無効になります。
- `pan` (double, optional, default: 0) — 音声のステレオ位置。-1（左端）から0（中央）を経て1（右端）まで指定します。パンニングされるのは音声のみで、リバーブとバックグラウンドノイズは中央のままです。

### FileInputConfigWorkflowOverride

- `enabled` (boolean, optional, nullable) — 有効にすると、LLMがマルチモーダル入力をサポートしている場合、ユーザーはチャットで画像、PDF、またはテキストファイルを添付できます。
- `max_files_in_memory` (integer, optional, nullable) — 会話中にメモリに保持する最新ファイル数です。古いファイルは要約され、そのバイトデータは解放されます。
- `max_files_per_conversation` (integer, optional, nullable) — 1回の会話でユーザーがアップロードできるファイルの合計数。アップロードはファイルごとに課金されます。無制限の場合は-1、またはmax_files_in_memory以上の値を使用します。

### DTMFInputConfig

電話中のDTMF（キーパッド）入力収集の設定。

- `dtmf_input_timeout` (double, optional, default: 2) — 追加のDTMF数字を待機するタイムアウト（秒）
- `hash_terminator` (boolean, optional, default: true) — trueの場合、#を押すと直ちにDTMF入力が完了します
- `redact_input` (boolean, optional, default: false) — trueの場合、発信者のDTMF（キーパッド）入力を文字起こし、会話ログ、分析内でマスキングマーカーに置き換えます。エージェントが復唱する数字やツールに渡す数字は影響を受けません。

### BackgroundSoundConfigWorkflowOverride

- `source_type` (enum, optional, nullable) — バックグラウンドサウンドのソースタイプです。
  - Allowed values: `preset`
- `source_id` (enum, optional, nullable) — サウンドソースの識別子。
  - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `volume` (double, optional, nullable) — バックグラウンドサウンドの音量レベル（0.01～1.0）。
- `crossfade_loop` (boolean, optional, nullable) — サウンドのループ時にポップノイズが聞こえるのを防ぐため、ループ境界にクロスフェードを適用します。

### ConversationConfigClientOverride-Input

- `asr` (ASRConversationalConfigOverride, optional, nullable) — 会話用文字起こしの設定
- `turn` (TurnConfigOverride, optional, nullable) — ターン検出の設定
- `tts` (TTSConversationalConfigOverride, optional, nullable) — 会話用テキスト読み上げの設定
- `conversation` (ConversationConfigOverride, optional, nullable) — 会話イベントの設定
- `agent` (AgentConfigOverride-Input, optional, nullable) — エージェント固有の設定

### LanguagePresetTranslation

- `source_hash` (string, required)
- `text` (string, required)

### DynamicVariablesConfigWorkflowOverride

- `dynamic_variable_placeholders` (map from string to any, optional, nullable) — 動的変数プレースホルダーとその値の辞書です。

### BehaviorOverride

- `verbosity` (enum, optional, nullable) — 詳細度のオーバーライド。未設定の場合は基となるデフォルトが適用されます。
  - Allowed values: `auto`, `concise`, `thorough`
- `output_format` (enum, optional, nullable) — 出力形式のオーバーライド。未設定の場合は、基になるデフォルトが適用されます。
  - Allowed values: `mp3_22050_32`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `mp3_44100_128`, `mp3_44100_192`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `ulaw_8000`
- `interaction_budget` (enum, optional, nullable) — インタラクション予算の上書きです。未設定の場合は基盤となるデフォルトが適用されます。
  - Allowed values: `realtime`, `5_minutes`, `10_minutes`, `1_hour`

### PromptAgentAPIModelWorkflowOverride-Input

- `prompt` (string, optional, nullable) — エージェント用のプロンプト
- `llm` (enum, optional, nullable) — プロンプトとチャット履歴を使用してクエリするLLM。データレジデンシーを使用する場合、LLMはデータレジデンシー環境でサポートされている必要があります。
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `reasoning_effort` (enum, optional, nullable) — モデルの推論量。一部のモデルでのみ利用できます。
  - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`
- `thinking_budget` (integer, optional, nullable) — 思考に使用する最大トークン数。モデルが対応している場合は、0を指定すると無効になります。
- `enable_reasoning_summary` (boolean, optional, nullable) — モデルの推論要約を有効にします。無効にすると、TTFBを高速化するため、可能な場合はプロバイダーに要約をリクエストしません。ZRMには対応していません。
- `temperature` (double, optional, nullable) — LLMのtemperature。デフォルトは0です。nullに設定すると、LLMリクエストからこのパラメータを完全に省略します（temperatureフィールドを受け付けないカスタムLLMで有用です）。
- `max_tokens` (integer, optional, nullable) — 0より大きい場合、LLMが予測できるトークンの最大数
- `tool_ids` (list of string, optional, nullable) — エージェントが使用するツールIDのリストです。
- `tool_ids_strict` (boolean, optional, nullable) — 会話のオーバーライドとしてのみ適用され、tool_idsのオーバーライドが許可される場合に使用できます。trueの場合、オーバーライドされたtool_idsは、ワークフローノード上のツールを含む、その会話で許可されるツールの完全な一覧です。エージェントに設定した場合は無視されます。
- `built_in_tools` (BuiltInToolsWorkflowOverride-Input, optional, nullable) — エージェントが使用する組み込みシステムツール
- `enable_parallel_tool_calls` (boolean, optional, nullable) — 並列ツール呼び出しを有効にします。有効にすると、エージェントは1つのターン内で複数のツールを並列実行できます。すべてのモデルでサポートされているわけではありません。
- `mcp_server_ids` (list of string, optional, nullable) — エージェントが使用するMCPサーバーIDの一覧
- `native_mcp_server_ids` (list of string, optional, nullable) — エージェントが使用するネイティブMCPサーバーIDの一覧
- `knowledge_base` (list of KnowledgeBaseLocator, optional, nullable) — エージェントが使用するナレッジベースの一覧
- `custom_llm` (CustomLLM, optional, nullable) — LLMフィールドが'CUSTOM_LLM'に設定されている場合のカスタムLLMの定義
- `ignore_default_personality` (boolean, optional, nullable) — システムプロンプトからデフォルトの人格に関する行を削除するかどうか
- `rag` (RagConfigWorkflowOverride-Input, optional, nullable) — RAGの設定
- `timezone` (string, optional, nullable) — システムプロンプトで現在時刻を表示するためのタイムゾーン。設定すると、このタイムゾーンを使用した現在時刻がシステムプロンプトに含まれます。有効なタイムゾーン名（例：'America/New_York'、'Europe/London'、'UTC'）を指定する必要があります。正確な時刻認識応答のために推奨されます。設定しない場合、動的変数またはツールで現在日時を提供しない限り、エージェントは現在日時を認識できず、不正確な時刻参照やハルシネーションにつながる可能性があります。
- `backup_llm_config` (PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig, optional, nullable) — バックアップLLMカスケードの設定です。無効化するか、システムのデフォルトを使用するか、カスタムの順序を指定できます。
- `cascade_timeout_seconds` (double, optional, nullable) — バックアップLLMに切り替えるまでの時間（秒）。2～15秒である必要があります。
- `tools` (list of PromptAgentApiModelWorkflowOverrideInputToolsItems, optional, nullable) — エージェントが会話中に使用できるツールの一覧です。代わりにtool_idsを使用してください。

### WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue

使用する定数値

### ASRConversationalConfigOverride

- `keywords` (list of string, optional, nullable) — 予測確率を高めるキーワード

### TurnConfigOverride

- `soft_timeout_config` (SoftTimeoutConfigOverride, optional, nullable) — ソフトタイムアウト機能の設定です。長いLLMレスポンスの処理中に即時フィードバックを提供します。

### TTSConversationalConfigOverride

- `model_id` (enum, optional, nullable, default: eleven_v4_turbo) — TTSに使用するモデル。
  - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo`
- `voice_id` (string, optional, nullable) — TTSに使用する音声ID
- `supported_voices` (list of SupportedVoice, optional, nullable) — エージェントで追加対応する音声
- `stability` (double, optional, nullable) — 生成された音声の安定性
- `speed` (double, optional, nullable) — 生成された音声の速度
- `similarity_boost` (double, optional, nullable) — 生成された音声の類似性ブースト
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional, nullable) — 発音辞書ロケーター

### ConversationConfigOverride

- `text_only` (boolean, optional, nullable) — 有効にするとオーディオは処理されず、テキストのみが使用されます。オーディオ料金を回避するために使用します。
- `max_duration_seconds` (integer, optional, nullable) — 会話の最大時間（秒）。

### AgentConfigOverride-Input

- `first_message` (string, optional, nullable) — 空でない場合、エージェントが最初に発するメッセージです。空の場合、エージェントはユーザーが会話を開始するのを待ちます。
- `language` (string, optional, nullable) — エージェントの言語（ASRおよびTTSで使用）
- `max_conversation_duration_message` (string, optional, nullable) — 空でない場合、会話の最大時間に達したときにエージェントが送信するメッセージです。
- `prompt` (PromptAgentAPIModelOverride-Input, optional, nullable) — エージェント用のプロンプト

### BuiltInToolsWorkflowOverride-Input

- `transfer_to_agent` (SystemToolConfig, optional, nullable) — エージェント転送ツール
- `end_call` (SystemToolConfig, optional, nullable) — 通話終了ツール
- `language_detection` (SystemToolConfig, optional, nullable) — 言語検出ツール。
- `transfer_to_number` (SystemToolConfig, optional, nullable) — 電話番号転送ツール
- `skip_turn` (SystemToolConfig, optional, nullable) — ターンスキップツール
- `play_keypad_touch_tone` (SystemToolConfig, optional, nullable) — DTMF再生ツール
- `voicemail_detection` (SystemToolConfig, optional, nullable) — 留守番電話検出ツール

### CustomLLM

- `url` (string, required) — Chat Completions互換エンドポイントのURL
- `model_id` (string, optional, nullable) — URLが複数のモデルを提供する場合に使用するモデルID。
- `api_key` (CustomLlmApiKey, optional, nullable) — 認証用のAPIキーです。ワークスペースシークレット参照\{'secret\_id': '...'}または環境変数参照\{'env\_var\_label': '...'}のいずれかです。
- `auth_connection` (CustomLlmAuthConnection, optional, nullable) — 認証用の任意のワークスペース認証接続。Authorization Bearerトークンを生成する認証接続のみサポートされます。Basic認証、mTLS、カスタムヘッダー、URLシークレットの認証接続はサポートされません。
- `request_headers` (map from string to CustomLlmRequestHeaders, optional) — リクエストに含めるヘッダー
- `api_version` (string, optional, nullable) — リクエストに使用するAPIバージョン。
- `api_type` (enum, optional, default: chat_completions) — 使用するAPIタイプ（chat_completions、responses、またはwebsocket）。
  - Allowed values: `chat_completions`, `responses`, `websocket`

### RagConfigWorkflowOverride-Input

- `enabled` (boolean, optional, nullable)
- `embedding_model` (enum, optional, nullable, default: e5_mistral_7b_instruct)
  - Allowed values: `e5_mistral_7b_instruct`, `multilingual_e5_large_instruct`
- `max_vector_distance` (double, optional, nullable) — 取得したチャンクの最大ベクトル距離。
- `max_documents_length` (integer, optional, nullable) — RAGから取得するドキュメントチャンクの合計長の上限。
- `max_retrieved_rag_chunks_count` (integer, optional, nullable) — ベクトルストアから最初に取得するRAGドキュメントチャンクの最大数。その後、ベクトル距離と合計長に基づいてさらにフィルタリングされます。
- `num_candidates` (integer, optional, nullable) — ANNベクトル検索で評価する候補数です。数が多いほど結果は改善しますが、レイテンシーも増加します。推奨される最小値は100です。無効にした場合は、デフォルト値が使用されます。
- `query_rewrite_prompt_override` (string, optional, nullable) — RAG検索前にユーザークエリを書き換えるためのカスタムプロンプト。会話履歴は末尾に自動で追加されます。未設定の場合はデフォルトのプロンプトが使用されます。
- `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional, nullable) — 設定すると、エージェントは従来のknowledge_base_ragツールではなくknowledge_baseツールを使用します。Noneは、エージェントがオプトインしていないことを意味します。

### PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig

バックアップLLMカスケードの設定です。無効化するか、システムのデフォルトを使用するか、カスタムの順序を指定できます。

### PromptAgentApiModelWorkflowOverrideInputToolsItems

ツールのタイプ

- `type`: `api_integration_webhook` (ApiIntegrationWebhookToolConfig)
  - `api_integration_connection_id` (string, required)
  - `api_integration_id` (string, required)
  - `description` (string, required) — ツールを使用するタイミングと機能の説明。
  - `name` (string, required)
  - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional, nullable) — ベースapi_schemaに適用されるユーザーオーバーライド
  - `assignments` (list of DynamicVariableAssignment, optional) — ツールレスポンスから値を抽出し、動的変数に割り当てるための設定
  - `dynamic_variables` (DynamicVariablesConfig, optional) — 動的変数の設定
  - `execution_mode` (enum, optional, default: immediate) — ツールをいつ、どのように実行するかを決定します。'immediate'はLLMから要求されるとすぐにツールを実行し、'post_tool_speech'はエージェントが話し終えるまで待ってから実行し、'async'はブロックせずにバックグラウンドでツールを実行します。長時間の処理に最適です。
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `interruption_mode` (enum, optional, default: allow) — このツール呼び出し中にユーザーがエージェントを中断できるかどうかを制御します。'allow'（デフォルト）はユーザーによる中断をいつでも許可します。'disable_during_tool'はツールの実行中のみ中断を抑制し、'disable_during_tool_and_turn'はツールの実行中と、その後に続くエージェントの応答中に中断を抑制します。
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — このツールを呼び出す前にエージェントが話すかどうかを制御します。'auto'（デフォルト）は直近のツールレイテンシーに基づいて判断し、'force'は常にエージェントに話すよう求め、'off'はレイテンシーにかかわらず完全に無効化します。
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — ツール呼び出しの完了を待機する最大時間（秒）。5秒から300秒の範囲で指定します（両端を含む）。
  - `tool_call_sound` (enum, optional, nullable) — ツール実行中に再生する定義済みツール呼び出しサウンドの種類。指定しない場合、ツール呼び出しサウンドは再生されません。
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — ツール呼び出し音をいつ再生するかを決定します。'auto'はツール実行前の発話がある場合にのみ再生し、'always'はすべてのツール呼び出しで再生します。
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — エージェントと共有する前にツールエラーを処理する方法を制御します。'auto'はツールの種類に応じて処理方法を決定します（ネイティブインテグレーションでは要約、その他では非表示）。'summarized'はLLM生成の要約を送信し、'passthrough'は未加工のエラーを送信し、'hide'はエージェントとエラーを共有しません。
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `tool_version` (string, optional, default: 1.0.0) — APIインテグレーションツールのバージョン
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`interruption_mode`を使用してください。trueの場合、このツールの実行中は、ユーザーはエージェントを中断できません。
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`pre_tool_speech`を使用してください。trueの場合、エージェントはツール呼び出し前に発話します。
- `type`: `client` (ClientToolConfig)
  - `description` (string, required) — ツールを使用するタイミングと機能の説明。
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — ツールレスポンスから値を抽出し、動的変数に割り当てるための設定
  - `dynamic_variables` (DynamicVariablesConfig, optional) — 動的変数の設定
  - `execution_mode` (enum, optional, default: immediate) — ツールをいつ、どのように実行するかを決定します。'immediate'はLLMから要求されるとすぐにツールを実行し、'post_tool_speech'はエージェントが話し終えるまで待ってから実行し、'async'はブロックせずにバックグラウンドでツールを実行します。長時間の処理に最適です。
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `expects_response` (boolean, optional, default: false) — trueの場合、このツールの呼び出しは、LLMに渡される応答をクライアントが返すまで会話をブロックします。falseの場合は、クライアントの応答を待たずに会話を続けます。これはユーザーにコンテンツを表示しつつ、会話をブロックしない場合に便利です。
  - `interruption_mode` (enum, optional, default: allow) — このツール呼び出し中にユーザーがエージェントを中断できるかどうかを制御します。'allow'（デフォルト）はユーザーによる中断をいつでも許可します。'disable_during_tool'はツールの実行中のみ中断を抑制し、'disable_during_tool_and_turn'はツールの実行中と、その後に続くエージェントの応答中に中断を抑制します。
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `parameters` (ObjectJsonSchemaProperty-Input, optional, nullable) — クライアントに渡すパラメーターのスキーマ
  - `pre_tool_speech` (enum, optional, default: auto) — このツールを呼び出す前にエージェントが話すかどうかを制御します。'auto'（デフォルト）は直近のツールレイテンシーに基づいて判断し、'force'は常にエージェントに話すよう求め、'off'はレイテンシーにかかわらず完全に無効化します。
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — ツール呼び出しの完了を待機する最大時間（秒）。1～120秒（両端を含む）、またはクライアントの応答を無期限に待機する場合は-1を指定します（expects_responseが必要です）。
  - `tool_call_sound` (enum, optional, nullable) — ツール実行中に再生する定義済みツール呼び出しサウンドの種類。指定しない場合、ツール呼び出しサウンドは再生されません。
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — ツール呼び出し音をいつ再生するかを決定します。'auto'はツール実行前の発話がある場合にのみ再生し、'always'はすべてのツール呼び出しで再生します。
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — エージェントと共有する前にツールエラーを処理する方法を制御します。'auto'はツールの種類に応じて処理方法を決定します（ネイティブインテグレーションでは要約、その他では非表示）。'summarized'はLLM生成の要約を送信し、'passthrough'は未加工のエラーを送信し、'hide'はエージェントとエラーを共有しません。
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`interruption_mode`を使用してください。trueの場合、このツールの実行中は、ユーザーはエージェントを中断できません。
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`pre_tool_speech`を使用してください。trueの場合、エージェントはツール呼び出し前に発話します。
- `type`: `mcp` (mcp)
- `type`: `smb` (smb)
- `type`: `system` (SystemToolConfig)
  - `name` (string, required)
  - `params` (ToolRequestModelToolConfigDiscriminatorMappingSystemParams, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — ツールレスポンスから値を抽出し、動的変数に割り当てるための設定
  - `description` (string, optional, default: ) — ツールを使用するタイミングと機能の説明。空欄の場合は、特定のツールタイプ向けに最適化されたデフォルトの説明が使用されます。
  - `interruption_mode` (enum, optional, default: allow) — このツール呼び出し中にユーザーがエージェントを中断できるかどうかを制御します。'allow'（デフォルト）はユーザーによる中断をいつでも許可します。'disable_during_tool'はツールの実行中のみ中断を抑制し、'disable_during_tool_and_turn'はツールの実行中と、その後に続くエージェントの応答中に中断を抑制します。
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — このツールを呼び出す前にエージェントが話すかどうかを制御します。'auto'（デフォルト）は直近のツールレイテンシーに基づいて判断し、'force'は常にエージェントに話すよう求め、'off'はレイテンシーにかかわらず完全に無効化します。
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — ツール呼び出しの完了を待機する最大時間（秒）。
  - `tool_call_sound` (enum, optional, nullable) — ツール実行中に再生する定義済みツール呼び出しサウンドの種類。指定しない場合、ツール呼び出しサウンドは再生されません。
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — ツール呼び出し音をいつ再生するかを決定します。'auto'はツール実行前の発話がある場合にのみ再生し、'always'はすべてのツール呼び出しで再生します。
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — エージェントと共有する前にツールエラーを処理する方法を制御します。'auto'はツールの種類に応じて処理方法を決定します（ネイティブインテグレーションでは要約、その他では非表示）。'summarized'はLLM生成の要約を送信し、'passthrough'は未加工のエラーを送信し、'hide'はエージェントとエラーを共有しません。
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`interruption_mode`を使用してください。trueの場合、このツールの実行中は、ユーザーはエージェントを中断できません。
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`pre_tool_speech`を使用してください。trueの場合、エージェントはツール呼び出し前に発話します。
- `type`: `webhook` (WebhookToolConfig)
  - `api_schema` (WebhookToolApiSchemaConfig-Input, required) — 送信Webhookのスキーマ。パラメータとURL仕様を含みます。
  - `description` (string, required) — ツールを使用するタイミングと機能の説明。
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — ツールレスポンスから値を抽出し、動的変数に割り当てるための設定
  - `dynamic_variables` (DynamicVariablesConfig, optional) — 動的変数の設定
  - `execution_mode` (enum, optional, default: immediate) — ツールをいつ、どのように実行するかを決定します。'immediate'はLLMから要求されるとすぐにツールを実行し、'post_tool_speech'はエージェントが話し終えるまで待ってから実行し、'async'はブロックせずにバックグラウンドでツールを実行します。長時間の処理に最適です。
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `follow_redirects` (boolean, optional, default: false) — エンドポイントからのリダイレクトを解決し、最終レスポンスを返すかどうか。リダイレクトは1回だけ追跡され、リクエスト本文なしのGETとして実行されます。このツールで設定した内容（ヘッダー、認証、クライアント証明書）はリダイレクト先に送信されません。エンドポイントとリダイレクト先の両方でHTTPSを使用する必要があります。APIインテグレーションツールではサポートされていません。
  - `follow_redirects_allowed_domains` (list of string, optional) — リダイレクト先として許可するドメイン（例：'test.example.com'）。リダイレクトをたどる場合に必要で、リスト外の宛先は拒否されます。
  - `interruption_mode` (enum, optional, default: allow) — このツール呼び出し中にユーザーがエージェントを中断できるかどうかを制御します。'allow'（デフォルト）はユーザーによる中断をいつでも許可します。'disable_during_tool'はツールの実行中のみ中断を抑制し、'disable_during_tool_and_turn'はツールの実行中と、その後に続くエージェントの応答中に中断を抑制します。
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — このツールを呼び出す前にエージェントが話すかどうかを制御します。'auto'（デフォルト）は直近のツールレイテンシーに基づいて判断し、'force'は常にエージェントに話すよう求め、'off'はレイテンシーにかかわらず完全に無効化します。
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — ツール呼び出しの完了を待機する最大時間（秒）。5秒から300秒の範囲で指定します（両端を含む）。
  - `tool_call_sound` (enum, optional, nullable) — ツール実行中に再生する定義済みツール呼び出しサウンドの種類。指定しない場合、ツール呼び出しサウンドは再生されません。
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — ツール呼び出し音をいつ再生するかを決定します。'auto'はツール実行前の発話がある場合にのみ再生し、'always'はすべてのツール呼び出しで再生します。
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — エージェントと共有する前にツールエラーを処理する方法を制御します。'auto'はツールの種類に応じて処理方法を決定します（ネイティブインテグレーションでは要約、その他では非表示）。'summarized'はLLM生成の要約を送信し、'passthrough'は未加工のエラーを送信し、'hide'はエージェントとエラーを共有しません。
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`interruption_mode`を使用してください。trueの場合、このツールの実行中は、ユーザーはエージェントを中断できません。
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`pre_tool_speech`を使用してください。trueの場合、エージェントはツール呼び出し前に発話します。

### SoftTimeoutConfigOverride

- `message` (string, optional, nullable) — LLM応答の待機中に最初のソフトタイムアウトに達したときに表示するメッセージ。動的変数（例：\{\{system\_\_time}}、\{\{custom\_variable}}）に対応しています。
- `additional_soft_timeout_messages` (list of string, optional, nullable) — 同じLLM生成内で後続のソフトタイムアウト時に使用する追加の固定フィラーメッセージです。最初のタイムアウトでは`message`を使用します。設定されているメッセージ数が`max_soft_timeouts_per_generation`より少ない場合は、最後に設定されたメッセージを繰り返します。それ以外の場合は、組み込みのフィラーを使用します。

### PromptAgentAPIModelOverride-Input

- `prompt` (string, optional, nullable) — エージェント用のプロンプト
- `llm` (enum, optional, nullable) — プロンプトとチャット履歴を使用してクエリするLLM。データレジデンシーを使用する場合、LLMはデータレジデンシー環境でサポートされている必要があります。
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `tool_ids` (list of string, optional, nullable) — エージェントが使用するツールIDのリストです。
- `tool_ids_strict` (boolean, optional, nullable) — 会話のオーバーライドとしてのみ適用され、tool_idsのオーバーライドが許可される場合に使用できます。trueの場合、オーバーライドされたtool_idsは、ワークフローノード上のツールを含む、その会話で許可されるツールの完全な一覧です。エージェントに設定した場合は無視されます。
- `native_mcp_server_ids` (list of string, optional, nullable) — エージェントが使用するネイティブMCPサーバーIDの一覧
- `knowledge_base` (list of KnowledgeBaseLocator, optional, nullable) — エージェントが使用するナレッジベースの一覧

### SystemToolConfig

システムツールは、サーバー上のシステムメソッドを呼び出すために使用するツールです。

- `name` (string, required)
- `params` (ToolRequestModelToolConfigDiscriminatorMappingSystemParams, required)
- `description` (string, optional, default: ) — ツールを使用するタイミングと機能の説明。空欄の場合は、特定のツールタイプ向けに最適化されたデフォルトの説明が使用されます。
- `response_timeout_secs` (integer, optional, default: 20) — ツール呼び出しの完了を待機する最大時間（秒）。
- `interruption_mode` (enum, optional, default: allow) — このツール呼び出し中にユーザーがエージェントを中断できるかどうかを制御します。'allow'（デフォルト）はユーザーによる中断をいつでも許可します。'disable_during_tool'はツールの実行中のみ中断を抑制し、'disable_during_tool_and_turn'はツールの実行中と、その後に続くエージェントの応答中に中断を抑制します。
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `pre_tool_speech` (enum, optional, default: auto) — このツールを呼び出す前にエージェントが話すかどうかを制御します。'auto'（デフォルト）は直近のツールレイテンシーに基づいて判断し、'force'は常にエージェントに話すよう求め、'off'はレイテンシーにかかわらず完全に無効化します。
  - Allowed values: `auto`, `force`, `off`
- `assignments` (list of DynamicVariableAssignment, optional) — ツールレスポンスから値を抽出し、動的変数に割り当てるための設定
- `tool_call_sound` (enum, optional, nullable) — ツール実行中に再生する定義済みツール呼び出しサウンドの種類。指定しない場合、ツール呼び出しサウンドは再生されません。
  - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `tool_call_sound_behavior` (enum, optional, default: auto) — ツール呼び出し音をいつ再生するかを決定します。'auto'はツール実行前の発話がある場合にのみ再生し、'always'はすべてのツール呼び出しで再生します。
  - Allowed values: `auto`, `always`
- `tool_error_handling_mode` (enum, optional, default: auto) — エージェントと共有する前にツールエラーを処理する方法を制御します。'auto'はツールの種類に応じて処理方法を決定します（ネイティブインテグレーションでは要約、その他では非表示）。'summarized'はLLM生成の要約を送信し、'passthrough'は未加工のエラーを送信し、'hide'はエージェントとエラーを共有しません。
  - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
- `disable_interruptions` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`interruption_mode`を使用してください。trueの場合、このツールの実行中は、ユーザーはエージェントを中断できません。
- `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — 非推奨：代わりに`pre_tool_speech`を使用してください。trueの場合、エージェントはツール呼び出し前に発話します。

### CustomLlmApiKey

認証用のAPIキーです。ワークスペースシークレット参照\{'secret\_id': '...'}または環境変数参照\{'env\_var\_label': '...'}のいずれかです。

### CustomLlmAuthConnection

認証用の任意のワークスペース認証接続。Authorization Bearerトークンを生成する認証接続のみサポートされます。Basic認証、mTLS、カスタムヘッダー、URLシークレットの認証接続はサポートされません。

### CustomLlmRequestHeaders

### KnowledgeBaseToolInfo

- `enabled_strategies` (list of enum, optional) — モデルに公開する検索戦略です。空にすることはできません。
  - Allowed values: `cat`, `keyword`, `semantic`, `ls`

### BackupLLMDefault

### BackupLLMDisabled

### BackupLLMOverride

- `order` (list of enum, required)
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`

### ApiIntegrationWebhookOverrides

- `schema_overrides` (map from string to ApiIntegrationWebhookOverridesSchemaOverrides, optional, nullable)
- `response_filter_mode` (enum, optional, nullable, default: all) — エージェントに表示される前にツール応答をフィルタリングする方法を制御します。
  - Allowed values: `all`, `allow`, `hide_all`
- `response_filters` (list of string, optional, nullable)
- `request_headers` (map from string to ApiIntegrationWebhookOverridesRequestHeaders, optional, nullable)

### DynamicVariableAssignment

ツールレスポンスから値を抽出し、動的変数に割り当てるための設定。

- `dynamic_variable` (string, required) — 抽出した値を割り当てる動的変数の名前。
- `value_path` (string, required) — ソースから値を抽出するドット記法のパス（例：'user.name'または'data.0.id'）
- `source` ("response", optional, default: response) — 値の抽出元。現在は「response」のみをサポートしています。
- `sanitize` (boolean, optional, default: false) — trueの場合、この割り当ての値はLLMと文字起こしに送信する前にツール応答から削除されますが、変数の割り当てには引き続き使用されます。
- `preserve_native_type` (boolean, optional, default: false) — trueの場合、ツール応答から抽出された非スカラー値（リスト、オブジェクト）は、JSON文字列に変換せずネイティブ型のまま保存されます。抽出した配列をリスト動的変数として直接使用するには有効にしてください。

### DynamicVariablesConfig

- `dynamic_variable_placeholders` (map from string to any, optional) — 動的変数プレースホルダーとその値の辞書です。

### ObjectJsonSchemaProperty-Input

- `property_kind` (enum, optional, default: object)
  - Allowed values: `array`, `object`
- `description` (string, optional, default: )
- `dynamic_variable` (string, optional, default: ) — 設定すると、実行時にパラメーター全体へこの動的変数から値が入力されます。description（LLM提供の値）、constant_value、is_omittedとは併用できません。
- `constant_value` (map from string to any, optional, nullable) — 設定すると、実行時にオブジェクト全体でこの定数JSON値を使用します。description（LLM提供のオブジェクト）、dynamic_variable、is_omittedとは併用できません。
- `is_omitted` (boolean, optional, default: false) — trueの場合、このパラメータはリクエストから完全に省略されます。任意パラメータでのみ有効です。description、dynamic_variable、constant_valueとは併用できません。
- `type` ("object", optional, default: object)
- `required` (list of string, optional)
- `properties` (map from string to ObjectJsonSchemaPropertyInput, optional)
- `required_constraints` (RequiredConstraints, optional, nullable) — 必須フィールドを対象とするanyOf/allOf構成制約のラッパー。

### ToolRequestModelToolConfigDiscriminatorMappingSystemParams

- `system_tool_type`: `end_call` (EndCallToolConfig)
- `system_tool_type`: `end_procedure` (EndProcedureToolConfig)
  - `procedures` (map from string to ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingEndProcedureProcedures, optional)
- `system_tool_type`: `knowledge_base` (KnowledgeBaseToolConfig)
  - `enabled_strategies` (list of enum, optional)
    - Allowed values: `cat`, `keyword`, `semantic`, `ls`
- `system_tool_type`: `knowledge_base_rag` (KnowledgeBaseRagToolConfig)
- `system_tool_type`: `language_detection` (LanguageDetectionToolConfig)
  - `only_at_conversation_start` (boolean, optional, default: false) — 最初の2回のユーザーターンで言語切り替えが行われない場合、それ以降の切り替え試行は失敗し、会話は現在の言語のままになります。その間に言語が切り替わった場合は、以降も切り替えを利用できます。誤った切り替えが発生する可能性を減らすには有効にしてください。
- `system_tool_type`: `play_keypad_touch_tone` (PlayDTMFToolConfig)
  - `suppress_turn_after_dtmf` (boolean, optional, default: false) — trueの場合、エージェントはDTMFトーンの再生後に追加の音声を生成しません。これにより、エージェントの音声がIVRシステムに干渉することを防ぎます。
  - `use_out_of_band_dtmf` (boolean, optional, default: true) — DTMFトーンをインバンドオーディオではなく、アウトオブバンドRTPイベント（RFC 4733）として送信します。SIPトランクからインポートした電話番号でのみ有効です。
- `system_tool_type`: `skip_turn` (SkipTurnToolConfig)
  - `wait_timeout_secs` (double, optional, default: -1) — skip_turnの後、エージェントが文脈に応じた状況確認を生成するまでの待機秒数です。待機中は「End conversation after silence」タイマーが一時停止します。-1を指定すると待機を無効にします。この場合、skip_turnの後、呼び出し元が話すまでエージェントは沈黙し、タイマーは動作し続けます。音声会話にのみ適用されます。
- `system_tool_type`: `start_procedure` (StartProcedureToolConfig)
  - `procedures` (map from string to ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingStartProcedureProcedures, optional)
- `system_tool_type`: `transfer_to_agent` (TransferToAgentToolConfig)
  - `transfers` (list of AgentTransfer-Input, required)
- `system_tool_type`: `transfer_to_number` (TransferToNumberToolConfig)
  - `transfers` (list of PhoneNumberTransfer, required)
  - `enable_client_message` (boolean, optional, default: true) — 転送待ちのクライアントにメッセージを再生するかどうか。後方互換性のため、デフォルトはtrueです。
- `system_tool_type`: `voicemail_detection` (VoicemailDetectionToolConfig)
  - `voicemail_message` (string, optional, nullable) — 留守番電話を検出した際に残す任意のメッセージです。指定しない場合、留守番電話を検出すると通話はすぐに終了します。動的変数（例：\{\{system\_\_time}}、\{\{system\_\_call\_duration\_secs}}、\{\{custom\_variable}}）に対応しています。

### WebhookToolApiSchemaConfig-Input

- `url` (string, required) — Webhookの送信先URLです。パスパラメーターを含めることができます。例：[https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id})
- `request_headers` (map from string to WebhookToolApiSchemaConfigInputRequestHeaders, optional) — リクエストに含めるヘッダー
- `method` (enum, optional, default: GET) — Webhookで使用するHTTPメソッド
  - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
- `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — パスパラメータがある場合のスキーマです。キーはURL内のプレースホルダーと一致している必要があります。
- `query_params_schema` (QueryParamsJsonSchema-Input, optional, nullable) — クエリパラメータがある場合のスキーマです。これらはクエリパラメータとしてURLの末尾に追加されます。注意：クエリパラメータ内のプロパティはすべてリテラル型である必要があります。
- `request_body_schema` (ObjectJsonSchemaProperty-Input, optional, nullable) — ボディパラメータがある場合のスキーマです。POST／PATCH／PUTリクエストで使用します。スキーマはJSONボディとして送信されるオブジェクトである必要があります。
- `response_body_schema` (ObjectJsonSchemaProperty-Input, optional, nullable) — 想定されるレスポンス本文の構造を記述するスキーマ。ドキュメント専用であり、LLMには公開されません。
- `response_filter` (ResponseFilter, optional, nullable) — LLMが応答を見る前に適用する任意の許可リストフィルターです。大きな応答によってコンテキストが汚染されるのを防ぎます。デフォルトでは完全な応答です。
- `content_type` (enum, optional, default: application/json) — リクエスト本文のコンテンツタイプです。POST／PUT／PATCHリクエストにのみ適用されます。
  - Allowed values: `application/json`, `application/x-www-form-urlencoded`
- `auth_resolved_params` (list of string, optional) — path_params_schemaではなく、認証接続から解決されるURLプレースホルダー（例：UrlSecretAuthConnectionを介して挿入されたシークレット）。
- `auth_connection` (WebhookToolApiSchemaConfigInputAuthConnection, optional, nullable) — このWebhookの認証に使用する任意の認証接続

### ConvAISecretLocator

エージェントのシークレットストア内のシークレットを参照するために使用します。

- `secret_id` (string, required)

### ConvAIEnvVarLocator

ラベルで環境変数を参照するために使用します。

- `env_var_label` (string, required)

### AuthConnectionLocator

ワークスペースの認証接続ストア内の認証接続を参照するために使用します。

- `auth_connection_id` (string, required)

### EnvironmentAuthConnectionLocator

ラベルで'auth_connection'型の環境変数を参照します。実行時には現在の環境の認証接続に解決され、該当しない場合はデフォルト環境にフォールバックします。

- `env_var_label` (string, required)

### ConvAIDynamicVariable

動的変数を参照するために使用します。

- `variable_name` (string, required)

### ApiIntegrationWebhookOverridesSchemaOverrides

- `source`: `constant` (ConstantSchemaOverride)
  - `constant_value` (WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue, required, nullable) — 使用する定数値
- `source`: `dynamic_variable` (DynamicVariableSchemaOverride)
  - `dynamic_variable` (string, required) — 使用する動的変数の名前。
- `source`: `llm` (LLMSchemaOverride)
  - `prompt` (string, optional, nullable) — LLMのプロンプトオーバーライド。指定しない場合は、元のスキーマの説明が使用されます。
- `source`: `omit` (OmitSchemaOverride)

### ApiIntegrationWebhookOverridesRequestHeaders

### ObjectJsonSchemaPropertyInput

### RequiredConstraints

必須フィールドを対象とするanyOf/allOf構成制約のラッパー。

- `any_of` (list of RequiredConstraint, optional)
- `all_of` (list of RequiredConstraint, optional)

### ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingEndProcedureProcedures

### ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingStartProcedureProcedures

### AgentTransfer-Input

- `condition` (string, required)
- `agent_id` (string, optional, nullable)
- `branch_id` (string, optional, nullable)
- `node_id` (string, optional, nullable)
- `delay_ms` (integer, optional, default: 0)
- `transfer_message` (string, optional, nullable)
- `enable_transferred_agent_first_message` (boolean, optional, default: false)
- `is_workflow_node_transfer` (boolean, optional, default: false)
- `preserve_client_tts_overrides` (boolean, optional, default: false) — TTSクライアントのオーバーライドを転送先のエージェントに引き継ぐかどうかを定義します。
- `preserve_voice_settings` (boolean, optional, default: false) — ベース音声、TTSモデル、音声設定を転送先のエージェントに引き継ぐかどうかを定義します。

### PhoneNumberTransfer

- `transfer_destination` (PhoneNumberTransferTransferDestination, required)
- `condition` (string, required)
- `custom_sip_headers` (list of PhoneNumberTransferCustomSipHeadersItems, optional) — 通話転送時に含めるカスタムSIPヘッダー。各ヘッダーには静的な値または動的変数参照を指定できます。
- `transfer_type` (enum, optional, default: conference)
  - Allowed values: `blind`, `conference`, `sip_refer`
- `sip_refer_play_dialtone` (boolean, optional, default: true) — Trueの場合、SIP REFER転送の完了中に、元の通話レッグで呼び出し音が再生されます。この音はRTP経由でREFERを実行するSIPピアに送られるため、受信システム（SBCやコンタクトセンターなど）でこの音を聞かせたくない場合は無効にしてください。無効にすると、転送が完了するまで発信者には無音が聞こえます。SIP REFER転送でのみ使用できます。
- `uui` (UUITransferConfig, optional, nullable) — SIP REFER転送に添付するUser-to-User Information（RFC 7433）。CRM識別子やエスカレーション理由などの通話コンテキストを、転送の境界を越えて引き継ぎます。
- `post_dial_digits` (PhoneNumberTransferPostDialDigits, optional, nullable) — 通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）。静的値または動的変数参照を指定できます。0.5秒の一時停止には'w'を使用します。Twilio転送でのみサポートされます。
- `phone_number` (string, optional, nullable, deprecated)

### WebhookToolApiSchemaConfigInputRequestHeaders

### LiteralJsonSchemaProperty

リテラルJSON型のスキーマプロパティです。重要：設定できるのは、description（LLMが値を提供）、dynamic_variable（変数からの値）、is_system_provided（システムが値を提供）、constant_value（固定値）、is_omitted（パラメータを省略）のうち1つだけです。これらは相互排他的です。

- `type` (LiteralJsonSchemaPropertyType, required)
- `description` (string, optional, default: ) — プロパティの説明。設定すると、LLMはこの説明に基づいて値を提供します。dynamic_variable、is_system_provided、constant_value、is_omittedとは併用できません。
- `enum` (list of string, optional, nullable) — List of allowed string values for string type parameters
- `is_system_provided` (boolean, optional, default: false) — trueの場合、値は実行時にシステムによって設定されます。API Integration Webhookツールでテンプレート化に使用されます。description、dynamic_variable、constant_value、is_omittedとは併用できません。
- `dynamic_variable` (string, optional, default: ) — このプロパティの値に使用する動的変数の名前。description、is_system_provided、constant_value、is_omittedとは併用できません。
- `allowed_values` (AllowedValues, optional, nullable) — LLMが提供する値に対するサーバー側の拒否ガードです。ランタイムは、このオブジェクトで指定された許可セット外の値を拒否します。このセットはenumとしてLLMには公開されません。値のソースが`description`の場合のみサポートされ、dynamic_variable、is_system_provided、constant_value、is_omittedとの組み合わせは拒否されます。
- `constant_value` (LiteralJsonSchemaPropertyConstantValue, optional, nullable, default: ) — このプロパティに使用する定数値です。description、dynamic_variable、is_system_provided、is_omittedとは同時に使用できません。
- `is_omitted` (boolean, optional, default: false) — trueの場合、このパラメータはリクエストから完全に省略されます。任意パラメータでのみ有効です。description、dynamic_variable、is_system_provided、constant_valueとは併用できません。
- `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — 非推奨：代わりに`allowed_values`を使用してください。設定すると、LLMが値を提供しますが、実行時にはこの動的変数が保持するリストにない値を拒否します（["ws_alpha", "ws_beta"]のようなJSON配列である必要があります）。LLMがサーバー検証済みのセット（例：現在のユーザーにアクセスが許可されているID）から選択できるようにする場合に使用します。descriptionが必要です。dynamic_variable、is_system_provided、constant_value、is_omittedとは同時に使用できません。

### QueryParamsJsonSchema-Input

- `properties` (map from string to LiteralJsonSchemaProperty, required)
- `required` (list of string, optional)

### ResponseFilter

エージェントに表示される前にツールレスポンスをフィルタリングするための設定。

- `mode` (enum, optional, default: all) — ツール応答のフィルタリング方法を制御します。'all'は応答全体を返し、'allow'は指定したパスのみを返し、'hide_all'は応答全体を非表示にします。
  - Allowed values: `all`, `allow`, `hide_all`
- `filters` (list of string, optional) — モードが'allow'の場合に含めるドット記法のパス（例：['ticket.id', 'ticket.status']）。
- `content_type` ("application/json", optional, default: application/json) — レスポンスフィルタリング用のコンテンツタイプです。'application/json'のレスポンスのみがフィルタリングされます。

### WebhookToolApiSchemaConfigInputAuthConnection

このWebhookの認証に使用する任意の認証接続

### ArrayJsonSchemaProperty-Input

- `property_kind` (enum, optional, default: array)
  - Allowed values: `array`, `object`
- `description` (string, optional, default: )
- `dynamic_variable` (string, optional, default: ) — 設定すると、実行時にパラメーター全体へこの動的変数から値が入力されます。description（LLM提供の値）、constant_value、is_omittedとは併用できません。
- `constant_value` (list of any, optional, nullable) — 設定すると、実行時に配列全体でこの定数値を使用します。description（LLM提供の配列）、dynamic_variable、is_omittedとは併用できません。
- `is_omitted` (boolean, optional, default: false) — trueの場合、このパラメータはリクエストから完全に省略されます。任意パラメータでのみ有効です。description、dynamic_variable、constant_valueとは併用できません。
- `type` ("array", optional, default: array)
- `items` (ArrayJsonSchemaPropertyInputItems, optional, default: {"allowed_values_dynamic_variable":"","constant_value":"","description":"Array element","dynamic_variable":"","is_omitted":false,"is_system_provided":false,"type":"string"}) — 配列要素のスキーマです。

### RequiredConstraint

この制約を満たすためにすべて存在する必要があるフィールドのセット。

- `required` (list of string, required)

### ProcedureVersionRef

- `procedure_id` (string, required) — 手順ID
- `version_id` (string, required) — プロシージャバージョンのID。

### ProcedureDraftRef

- `procedure_id` (string, required) — 手順ID
- `version_id` (any, optional)

### PhoneNumberTransferTransferDestination

- `type`: `phone` (PhoneNumberTransferDestination)
  - `phone_number` (string, required)
- `type`: `phone_dynamic_variable` (PhoneNumberDynamicVariableTransferDestination)
  - `phone_number` (string, required)
- `type`: `sip_uri` (SIPUriTransferDestination)
  - `sip_uri` (string, required)
- `type`: `sip_uri_dynamic_variable` (SIPUriDynamicVariableTransferDestination)
  - `sip_uri` (string, required)

### PhoneNumberTransferCustomSipHeadersItems

- `type`: `dynamic` (CustomSIPHeaderWithDynamicVariable)
  - `key` (string, required) — SIPヘッダー名（例：'X-Customer-ID'）
  - `value` (string, required) — 解決する動的変数名
- `type`: `static` (CustomSIPHeader)
  - `key` (string, required) — SIPヘッダー名（例：'X-Customer-ID'）
  - `value` (string, required) — ヘッダー値

### PhoneNumberTransferPostDialDigits

通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）。静的値または動的変数参照を指定できます。0.5秒の一時停止には'w'を使用します。Twilio転送でのみサポートされます。

- `type`: `dynamic` (PostDialDigitsDynamicVariable)
  - `value` (string, required) — 解決する動的変数名
- `type`: `static` (PostDialDigitsStatic)
  - `value` (string, required) — 通話接続後に送信するDTMF数字（例：内線番号には'ww1234'）

### LiteralJsonSchemaPropertyType

### AllowedValues

- `dynamic_variable` (string, required) — 許可された値のJSON配列に解決される必要がある動的変数の名前（例：["ws_alpha", "ws_beta"]）。システム変数は、リストに解決される場合にのみ機能します。

### LiteralJsonSchemaPropertyConstantValue

このプロパティに使用する定数値です。description、dynamic_variable、is_system_provided、is_omittedとは同時に使用できません。

### ArrayJsonSchemaPropertyInputItems

配列要素のスキーマです。

## Examples

**Request**

```json
{
  "parent_version_id": "string",
  "name": "string",
  "description": "string"
}
```

**Response**

```json
{
  "created_branch_id": "string",
  "created_version_id": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches"

payload = {
    "parent_version_id": "string",
    "name": "string",
    "description": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"parent_version_id":"string","name":"string","description":"string"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches"

	payload := strings.NewReader("{\n  \"parent_version_id\": \"string\",\n  \"name\": \"string\",\n  \"description\": \"string\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"parent_version_id\": \"string\",\n  \"name\": \"string\",\n  \"description\": \"string\"\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches")
  .header("Content-Type", "application/json")
  .body("{\n  \"parent_version_id\": \"string\",\n  \"name\": \"string\",\n  \"description\": \"string\"\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches', [
  'body' => '{
  "parent_version_id": "string",
  "name": "string",
  "description": "string"
}',
  'headers' => [
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"parent_version_id\": \"string\",\n  \"name\": \"string\",\n  \"description\": \"string\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Content-Type": "application/json"]
let parameters = [
  "parent_version_id": "string",
  "name": "string",
  "description": "string"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```