エージェント・チームのランタイム構成

ランタイム構成では、チーム、エージェント、タスクまたはツールの格納済定義を変更せずに、実行時に値を指定できます。実行時の構成では、キーと値のペアを使用して、実行時にチームに値が提供されます。キーはランタイム変数を識別し、それに関連付けられた値はその変数の値を提供します。プレースホルダは、ストアド・チーム、エージェント、タスクまたはツール定義の実行時変数キーへの参照です。たとえば、プレースホルダ{audience}は、実行時変数キーaudienceを参照します。ネームスペースは、様々なタイプのランタイム値をサポートし、チームとそのツールで使用できます。一般的なチーム(共有チームを含む)の場合、SET_TEAMまたはRUN_TEAMを介してランタイム値を指定できます。共有チームの場合は、共有チーム定義を変更せずにこれらの値を指定できます。

ランタイム構成では、次のネームスペースがサポートされます。

ランタイム構成では、セッション・スコープ値とランタイム値の両方がサポートされます。セッション・スコープ値は、同じデータベース・セッションでの後続の実行に引き続き使用できます。ランタイム値は、現在の実行にのみ適用されます。

チームおよび共有チームの追加の実行時構成動作:

• SET_TEAMを使用して、現在のデータベース・セッションのチームおよびランタイム構成を設定します。これらの値は、ユーザーが変更またはクリアするまで、そのセッションで後続のチーム実行で使用可能です。SET_TEAMをSELECT AI AGENT <prompt>とともに使用すると、各プロンプトによって、現在のセッションに設定されたチームが実行されます。1回のSET_TEAMコールの後に、SELECT AI AGENT <prompt>を使用して複数のプロンプトを送信できます。プロンプトは、SET_TEAMを再度コールするか、構成をクリアするか、データベース・セッションを終了またはリセットするまで、選択したチームおよびセッション・スコープ値を引き続き使用します。
• RUN_TEAMを使用して、特定のチーム実行の値を指定します。RUN_TEAMで指定された値は、その実行にのみ適用され、SET_TEAMで指定された一致するセッション・スコープ値より優先されます。オーバーライドでは、SET_TEAMによって設定されたセッション・スコープの構成は変更されません。
• SET_TEAMを介して値を指定しても、後続のすべての実行で同じ会話を使用する必要はありません。会話の継続性は、実行に関連付けられた会話情報によって決まります。同じconversation_idを使用するプロンプトは、同じ会話スレッドに属します。新しい会話は、新しいconversation_idを指定したときに開始されます。
• ランタイム・キーを使用するのは、対応するチーム、エージェント、タスクまたはツール定義に一致するプレースホルダが含まれている場合のみです。
• コンシューマは、サポートされている実行時変数ネームスペースにキーと値のペアを指定できます。指定された値は、ストアド・チーム、エージェント、タスクまたはツール定義の一致するプレースホルダにのみ影響します。一致するプレースホルダが存在しない場合、指定された値は無効です。
• チーム所有者は、使用可能な実行時変数プレースホルダを定義することで、格納された定義コンシューマの構成可能な部分を制御します。実行時変数置換では、追加の権限は付与されません。チームによって実行される操作は、適用可能な認可要件および実行時セマンティクスの対象となります。
• 会話を開始または選択するコンシューマは、その会話を所有します。WAITING_FOR_HUMANプロセスを再開できるのは、コンシューマが共有チームにアクセスできる間のみです。
• SET_VARIABLEによって書き込まれた値は、同じチーム実行の後のツールで使用できます。これらのツールは、GET_VARIABLEを使用して値を取得できます。
• チームの実行がヒューマン入力に対して一時停止すると、同じコンシューマが実行を再開したときに、SET_VARIABLEによって書き込まれた値が保存およびリストアされます。
• ランタイム値は、ストアド・チーム、エージェント、タスクまたはツールの定義を変更しません。

詳細は、「GET_VARIABLEファンクション」、「SET_VARIABLEプロシージャ」、「SET_TEAMファンクション」、「RUN_TEAMファンクション」を参照してください。