- 简介
- 入门指南
- 使用 Maestro BPMN 进行构建
- 使用 Maestro Case 构建
- Maestro Case 简介
- Maestro BPMN 与 Maestro Case 对比:何时使用 Case Management
- Maestro 案例生命周期:从事件触发到应用体验
- 使用 Maestro Case 构建第一个案例
- Build a Maestro Case with a coding agent (preview)
- 定义案例键(系统键与外部键)
- 建立任务 I/O 与回写契约
- 退出规则和早期阶段终止
- 主阶段和次阶段建模
- 从 Data Fabric 触发案例
- 实施阶段级角色和权限
- 设置 SLA 和自动升级规则
- 配置返工循环(重新进入)
- Configuring and testing the Case Manager Agent (preview)
- 案例管理器输入和输出合同
- Maestro Case 组件字典
- 使用 Maestro Flow 进行构建
- 集成
- 运营
- 监控
- 正在优化
- 参考信息
Wait for Message suspends until the user sends a message, then outputs the latest conversation context for downstream conversational nodes to consume.
操作
Waits until the user sends the next message on the conversation, then resumes with the latest conversation context — the chat history and user profile information — as its output.
Always place a Wait for Message node immediately after the conversation trigger to ensure the Flow is ready for the user's first message. You can loop back to it for follow-up turns, or add more Wait for Message nodes elsewhere in the Flow.
输入
| 字段 | 描述 |
|---|---|
| 对话 ID | The ID of the conversation to wait on. Bind to the conversation trigger's output, for example $vars.conversationTrigger1.output.conversationId. |
| Exchange limit | Maximum number of past exchanges (back-and-forth turns) to include in the returned conversation history. Determines how many past messages in the conversation history are returned. |
输出
| 字段 | 描述 |
|---|---|
conversationContext | The latest conversation context, including the message history. |
The conversationContext contains the following fields:
| 字段 | 描述 |
|---|---|
latestExchangeId | Identifier of the most recent exchange (back-and-forth turn). Use as the Exchange ID input to Send Message when replying to the conversation. |
messages | The recent conversation history, including both the user's and Flow's messages. Exchange limit determines how many past exchanges to include. |
userSettings | User-level profile fields, configurable by the end-user on the channels. |
用法示例
Reference the full conversation context in a downstream Conversational Agent node:
$vars.waitForMessage1.output.conversationContext
$vars.waitForMessage1.output.conversationContext
Reference the outputted latestExchangeId in a downstream Send Message node:
$vars.waitForMessage1.output.conversationContext.latestExchangeId
$vars.waitForMessage1.output.conversationContext.latestExchangeId
Handling multiple Wait for Message nodes
When you have multiple Wait for Message nodes, you might accidentally configure a downstream node to reference a stale conversation context from a Wait for Message node that executed earlier.
For easier tracking, create a Flow-level variable (for example, $vars.globalConversationContext), and update it from each Wait for Message node's Update Variable section. Downstream nodes can then reference that single source of truth instead of needing to pick the last-executed Wait for Message node's output.
相关页面
- Conversation Trigger — provides the Conversation ID this node consumes.
- Conversational Agent — the typical consumer of this node's
conversationContextoutput. - Send Message — write into the conversation, using
latestExchangeIdfrom this node to continue the same exchange. - Chat — full palette of chat conversational nodes.
- Build a chat agent workflow — end-to-end walkthrough.
- Chat deployment — publish and expose the Flow through various channels.