GenerateVoiceAgentRequest interface
音声エージェントを生成するための入力です。 常に kind と name のみが必要です。
オーサリングサービスはこれらの入力を完全な編集可能な VoiceAgentDefinitionに拡張し、その後 POST /agentsによって作成されます。
生成された instructions および音声・音声設定は、生成されたエージェント定義上で別々のフィールドとして保存されるため、発信者は標準的なエージェントバージョン管理を通じて後から編集やオーバーライドが可能です。
プロパティ
| description | 任意のエージェントの説明。 オーサリングサービスは、省略された際にフォールバックを解決します。 |
| draft | (プレビュー) |
| goal | エージェントが何をすべきかの任意の自然言語的説明。 提供されると、生成された命令をシードします。 |
| kind | エージェントの種類。 常に |
| model | オプションでモデル識別子を指定します。
|
| model_type | オプションの推論モード。 省略された場合、オーサリングサービスは |
| name | エージェントが作り出すためのユニークな名前。 空でないDNSのようなエージェント名でなければなりません。 |
| tools | オプションツールは生成されたエージェントに逐語的に引き継がれます( |
| use_case | オプションのオーサリングユースケース。 空文字列が受け入れられます。 |
プロパティの詳細
description
任意のエージェントの説明。 オーサリングサービスは、省略された際にフォールバックを解決します。
description?: stringプロパティ値
string
draft
(プレビュー) trueすると、生成されたボイスエージェントはドラフトとして作成されます。これは編集可能な未公開バージョンで、発信者が標準の作成/バージョンパスで公開する前に確認・調整できます。 呼び出し元が値を指定しない場合、サービスはデフォルトで false に切り替え、その場合は通常通りエージェントが作成され公開されます。
draft?: booleanプロパティ値
boolean
goal
エージェントが何をすべきかの任意の自然言語的説明。 提供されると、生成された命令をシードします。
goal?: stringプロパティ値
string
kind
エージェントの種類。 常に voice です。
kind: "voice"プロパティ値
"voice"
model
オプションでモデル識別子を指定します。
model_typeがself_deployedする場合は必須、managedまたは省略される場合は任意model_type。 サービスは顧客のデプロイメント名を決して作成しません。
model?: stringプロパティ値
string
model_type
オプションの推論モード。 省略された場合、オーサリングサービスは managedを使用します。 供給されたら managed または用 self_deployed。
model_type?: VoiceModelTypeプロパティ値
name
エージェントが作り出すためのユニークな名前。 空でないDNSのようなエージェント名でなければなりません。
name: stringプロパティ値
string
tools
オプションツールは生成されたエージェントに逐語的に引き継がれます( VoiceAgentTool参照)。
tools?: VoiceAgentToolUnion[]プロパティ値
use_case
オプションのオーサリングユースケース。 空文字列が受け入れられます。
use_case?: stringプロパティ値
string