メッセージを待機

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

機能

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

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

入力

フィールド	説明
会話 ID	待機する会話の ID です。会話トリガーの出力にバインドします (例: $vars.conversationTrigger1.output.conversationId)。
元	待機するメッセージ送信者のロールです。[ユーザー] に設定されており、変更できません。
やり取りの上限	返される会話履歴に含める過去のやり取り (相互のターン) の最大数。会話履歴の過去のメッセージをいくつ返すかを指定します。

出力

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

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

フィールド	説明
latestExchangeId	最新のやり取りの識別子 (相互のターン)。会話に返信する際に メッセージを送信 するための Exchange ID の入力として を使用します。
messages	The recent conversation history, including both the user's and the workflow's messages. Exchange limit determines how many past exchanges to include.
userSettings	ユーザー レベルのプロファイル フィールド。エンド ユーザーがチャネル上で設定可能。

使用例

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

$vars.waitForMessage1.output.conversationContext

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

$vars.waitForMessage1.output.conversationContext.latestExchangeId

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

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

これを回避するには、各下流ノードがどの [メッセージを待機] ノードから読み取るかを確認します。入力する代わりに { } Insert を使用して値を選択し、同じパスで最後に実行された [メッセージを待機] ノードを選択します。

次のステップ

• 会話トリガー: このノードが使用する会話 ID を提供します。
• 会話型エージェント: このノードの conversationContext 出力の代表的なコンシューマーです。
• メッセージを送信: このノードからの latestExchangeId を使用して会話に書き込み、同じ交換を続行します。
• チャット : すべてのチャットの会話型ノードです。
• チャット エージェントのワークフローを構築する: エンドツーエンドのチュートリアル
• チャットのデプロイ: ワークフローをデプロイし、チャット チャネルで利用できるようにします。