通知监听:Listen 组件(AI Flowi Workflow)
通知监听组件 Listen 的目录说明:"用于监听通知的组件。"
Listen 已在目录中说明,但未经 Ai Flowi 生产环境测试。
作者:Ai Flowi · 发布于
目录参考
Listen 参考: flow_controls.Listen ,来自 2026年10月9日 的 AI Flowi Workflow 1.9.2 导出内容;分类索引请浏览 组件目录 。
输入
Listen 要求填写 context_key。该字段类型为 str,接受 Message 连接;导出内容没有其他 Listen 输入。
| 名称 | 类型 | 必填 | 接受的输入类型 | 通俗说明 |
|---|---|---|---|---|
context_key | str | 是 | Message | 监听组件必填的上下文键值。未定义其格式及通知匹配规则。 |
输出
| 显示名称 | 名称 | 类型 |
|---|---|---|
| JSON | data | JSON |
Listen 提供名为 data 的 JSON 端口。导出内容给出了连接类型,但未提供通知封装格式、字段名或载荷示例。
何时使用 Listen
当工作流需要此条目所述的通知监听功能时,可考虑使用 Listen。提供 context_key 后,应先检查 data,再连接依赖特定通知载荷的使用方。
何时选择其他组件
设计通知发送端时,请参阅 Notify 及其命名注意事项。若要直接转发已有的 Message,请查阅 Pass;若要执行另一个流程,请参阅 Run Flow 参考.
最简配置
配置示例,非已记录的测试
| 目录输入名称 | 示例设置或连接 |
|---|---|
context_key | review-stage |
review-stage 是本示例选用的虚构字符串,并非保留的事件名称。首先设置此必填字段,并在编辑器中检查监听器;此示意配置没有已记录的通知投递或返回的 JSON。
限制
- 目录未说明超时、轮询间隔、缓冲区大小或没有通知到达时的行为。它没有确定监听运行是否会阻塞,也没有确定其保持活动的时长。
- Notify 的说明提到了名为 Get Notified 的组件,而此条目名为 Listen。两者的 context_key 字段提示可能存在配对关系,值得进一步核查,但导出内容未明确确认该配对关系或其匹配规则。
- Listen 未说明投递顺序、重复通知处理、跨运行持久化以及项目或会话范围。不要将上下文键视为已有文档确认的访问控制边界。
- 监听器未列出错误输出或失败处理选项。单一 JSON 端口不能证明存在恢复路径。
现有端到端示例及其测试范围,请参阅 工作流文档汇总页.