ワークフロー・エージェント・チームに固有の変数

式には、必要なコンテキストを提供する様々なタイプの変数が含まれます。ワークフロー・エージェント・チームには、一連のスコープが定義されています。

スコープ	説明
グローバル	ワークフロー内の任意の場所で参照できる値。たとえば、`Current Date`、`Trigger Type`、およびワークフロー・レベルで定義された変数です。
Node	ノード入力変数の値や、ワークフロー内の各ノードの出力などの値。
トリガー	すべてのワークフローに複数のトリガーを設定でき、各トリガーにはそれぞれ独自の入力セットがあります。

ワークフロー・タイプのエージェント・チームに固有の式で使用可能な変数のタイプを次に示します。

システム変更項目
ワークフロー変数
ユーザー変更項目
トリガー変数
ユーザー定義変数
ノード変数

システム変更項目

システム変数は、アプリケーションによって提供される事前定義済のランタイム読取り専用値です。これらの変数は、{{$context.$system...}}構文を使用して、入力、エージェント・マッピングおよびプロンプトで参照できます。たとえば、{{$context.$system.$currentDate}}、{{$context.$system.$inputMessage}}です。

スコープ	式	説明
現在の日付	`{{$context.$system.$currentDate}}`	現在のシステム日付(ISO形式)
現在の日時	`{{$context.$system.$currentDateTime}}`	現在のシステム・タイムスタンプ
トリガー・タイプ	`{{$context.$system.$triggerType}}`	ワークフローを開始したトリガー
入力メッセージ	`{{$context.$system.$inputMessage}}`	RAWユーザー・チャット入力
ユーザー名	`{{$context.$system.$chatHistory}}`	現在のセッションの全会話履歴(前のユーザーとアシスタントの交代)

ワークフロー変数

ワークフロー変数は、ワークフロー・プロセス内で作成および管理されるワークフロー・スコープのランタイム値です。

スコープ	式	説明
ワークフロー名	`{{$context.$workflow.$name}}`	実行中のワークフローのID。この変数は、実行時に常に使用可能であり、ワークフローの名前が変更されないかぎり、複数の実行にわたって安定しています。
トレースID	`{{$context.$workflow.$traceId}}`	実行ごとに生成される特定のワークフロー実行インスタンスの一意の識別子。この変数は、デバッグおよびサポートに不可欠です。
会話ID	`{{$context.$workflow.$conversationId}}`	ワークフロー実行に関連付けられた会話またはセッションの識別子。

ユーザー変更項目

ユーザー変数は、現在アプリケーションまたはチャットとやり取りしているユーザーを表す事前定義されたランタイム値です。ユーザーの詳細は、{{$context.$user.}}構文を使用して入手できます。たとえば、ユーザー名は式{{$context.$user.$name}}を使用して取得できます。

スコープ	式	説明
ユーザー名	`{{$context.$user.$name}}`	ワークフロー実行を開始した認証済ユーザーのID

トリガー変数

ワークフロー・エージェント・チームが電子メール・トリガーまたはRESTトリガーによってコールされると、トリガー変数を使用できます。

RESTトリガー

スコープ	式	説明
トリガー・ > REST > 入力 > フィールド	`{{$context.$triggers.REST.$input.<field>}}`	特定の要求フィールド

電子メール・トリガー

スコープ	式	説明
トリガー > 入力 > サブジェクト	`{{$context.$triggers.EMAIL.$input.subject}}`	ワークフローをトリガーした受信Eメールの件名
トリガー > 入力 > fromAddress	`{{$context.$triggers.EMAIL.$input.fromAddress}}`	送信者の電子メール・アドレス
トリガー > 入力 > コンテンツ	`{{$context.$triggers.EMAIL.$input.content}}`	電子メールの本文
トリガー > 入力 > ヘッダー	`{{$context.$triggers.EMAIL.$input.headers}}`	Eメール・ヘッダーの完全なセット
トリガー > 入力 > アタッチメント	`{{$context.$triggers.EMAIL.$input.attachments}}`	Eメールに含まれる添付

ユーザー定義変数

システム提供の変数に加えて、タイプがWorkflowのエージェント・チームのノード間で共有できる変数を追加することもできます。これらの変数は、ワークフロー・エージェント・チームの作成時に定義でき、エージェント・チームのフロー全体で使用できます。定義済のユーザー変数は、ユーザーの質問または会話で使用できます。

ユーザー定義変数を追加するには、次のステップを実行します。

ワークフロー・エージェント・チームを作成または編集する場合は、「変数」タブを選択します。
「追加」を選択し、詳細を入力します。
- Name: 変数の名前を入力します。
- タイプ: タイプ(文字列など)を選択します。
- スコープ: 「ユーザー質問」または「会話」としてスコープを選択します。
変更を適用して保存します。

これで、{{$context.$variables.<variableName>}}を使用して変数を参照できます。

作成した変数に値を割り当てるには、次のステップを実行します。

ユーザー定義変数を追加するワークフロー・エージェント・チームを編集します。
「ロジック」→「変数の設定」タイプのノードを追加し、詳細を入力して変数ノードを作成します。
- 「変数」セクションで、「追加」を選択します。
- 「名前」フィールドで、作成したユーザー定義変数を選択します。
- 変数の値を入力します。静的値またはランタイム・コンテキストから導出された動的値を入力できます。
変更を保存します。

スコープ	式	説明
変数 > <name>	`{{$context.$variables.<name>}}`	ワークフロー・レベルの変数

ノード変数

ノード入力

ノード入力は、ワークフロー・エージェント・チームのノードへの入力を渡すために使用される変数です。

スコープ	式	説明

入力全体	`{{$context.$nodes.<nodeCode>.$input}}`	指定されたノードに渡される完全な入力オブジェクトを返します。
特定の入力フィールド	`{{$context.$nodes.<nodeCode>.$input.<field>}}`	ノードの入力オブジェクトから単一のフィールドを返します。

ノード出力

ノード出力は、ワークフロー・エージェント・チーム内のノードの出力を含む変数です。

スコープ	式	説明

出力全体	`{{$context.$nodes.<nodeCode>.$output}}`	指定されたノードによって生成された完全な出力オブジェクト(定義されている場合はスキーマベース)を返します。
特定の出力フィールド	`{{$context.$nodes.<nodeCode>.$output.<field>}}`	ノードの出力オブジェクトから単一のフィールドを返します。

- 柔軟性が必要な場合、または推論のためにデータをLLMに渡す場合は、入出力オブジェクト全体を使用します。
- 次のアクションを実行する場合は、特定のフィールドを使用します。
  - 条件の記述
  - ワークフロー変数の割当て
  - Eメールの件名または簡潔なプロンプトの移入
  - 実行時に存在しないフィールドを参照すると、空またはnullに解決されます

ノード・エラー詳細

ノード・エラーの詳細は、ワークフロー・エージェント・チームのノードで障害が発生し、エラー・ハンドラがコールされた場合に使用できる変数です。これらは、エラーが発生したノードにスコープ指定されます。

スコープ	式	説明

エラー情報	`{{$context.$nodes.<nodeCode>.$error.$info}}`	失敗したノードから返された詳細なエラー情報
エラー・コード	`{{$context.$nodes.<nodeCode>.$error.$code}}`	ノード障害に関連するマシン可読エラー・コード

ノード実行ステータス

ノード実行ステータス変数には、ワークフロー・エージェント・チームのノードのステータスが含まれます。

スコープ	式	説明
ノード・ステータス	`{{$context.$nodes.<nodeCode>.$status}}`	ノードの処理ステータス