メッセージを待機

[メッセージを待機] は、ユーザーがメッセージを送信するまで中断し、下流の会話ノードが使用する最新の会話コンテキストを出力します。

機能

ユーザーが会話の次のメッセージを送信するまで待機し、最新の 会話コンテキスト (チャット履歴とユーザー プロファイル情報) を出力として再開します。

[メッセージを待機] ノードは、必ず会話トリガーの直後に配置して、フローがユーザーの最初のメッセージに対して準備が整っていることを確認します。フォローアップ ターンのためにループ バックしたり、フロー内の他の場所に [メッセージを待機] ノードを追加したりできます。

入力

フィールド	説明
会話 ID	待機する会話の ID です。会話トリガーの出力にバインドします (例: $vars.conversationTrigger1.output.conversationId)。
やり取りの上限	返される会話履歴に含める過去のやり取り (相互のターン) の最大数。会話履歴の過去のメッセージをいくつ返すかを指定します。

出力

フィールド	説明
conversationContext	メッセージ履歴を含む、最新の会話コンテキスト。

この conversationContext には、次のフィールドがあります。

フィールド	説明
latestExchangeId	最新のやり取りの識別子 (相互のターン)。会話に返信する際に メッセージを送信 するための Exchange ID の入力として を使用します。
messages	最近の会話履歴 (ユーザーとフローのメッセージの両方を含む)交換の上限 により、含める過去の交換の数が決まります。
userSettings	ユーザー レベルのプロファイル フィールド。エンド ユーザーがチャネル上で設定可能。

使用例

下流の 会話型エージェント ノードで会話コンテキスト全体を参照します。

$vars.waitForMessage1.output.conversationContext

出力された latestExchangeId を下流の [メッセージを送信 ] ノードで参照します。

$vars.waitForMessage1.output.conversationContext.latestExchangeId

複数の [メッセージを待機] ノードを処理する

複数の [メッセージを待機] ノードがある場合、誤って下流のノードを設定して、先ほど実行した [メッセージを待機] ノードの古い会話コンテキストを参照する可能性があります。

追跡を容易にするには、フローレベルの変数 ( $vars.globalConversationContextなど) を作成し、各 [メッセージを待機] ノードの [変数を更新 ] セクションから更新します。これにより、下流のノードは、最後に実行された [メッセージを待機] ノードの出力を選択する代わりに、信頼できる唯一の情報源を参照できます。

関連ページ

• 会話トリガー — このノードが使用する会話 ID を指定します。
• 会話型エージェント — このノードの conversationContext 出力の代表的なコンシューマーです。
• メッセージを送信 — このノードからの latestExchangeId を使用して会話に書き込み、同じやり取りを続行します。
• チャット — チャットの会話ノードの完全なパレット。
• チャット エージェントのワークフローを構築する — エンドツーエンドのチュートリアル
• チャットのデプロイ — さまざまなチャネルを通じてフローを公開および公開します。