工作流的异步调用

最近更新时间:2026-02-10 20:58:32

我的收藏
单工作流模式支持同步调用和异步调用两种调用方式。异步调用下,工作流运行后,‌用户会立即得到一个响应回复,工作流在后台异步执行,用户无需等待即可发起下一轮请求。有效避免复杂工作流运行超时、调用方资源受限、或无法保持长连接的情况。例如:异步调用工作流进行视频分析,用户会立即得到任务创建的响应回复,之后可退出应用或分析下一个视频,无需长时间等待该任务执行完成。
说明:
异步调用的大模型并发由该账号所具备的权限来控制,如果同时发起多个异步调用任务,则需要排队等待。
异步运行任务将在24小时内返回结果。

如何设置工作流的异步调用

进入单工作流模式,创建并配置工作流。确保工作流可正常运行。工作流的创建与配置方法,详情请参见 工作流的创建、配置与调试
创建并启用工作流后,可在应用中选择指定工作流。



在对话调试窗口中,单击同步调试可打开选项弹窗,用于选择工作流的调试方式。弹窗内提供"同步调试"和"异步调试"两个选项。选择"异步调试"后,可直接在调试窗口中进行对话,测试异步调用的效果。



在对话调试窗口内发送信息,可开启一个异步调试任务。对于异步调试任务,对话窗内不输出内容,无法直接查看任务的执行情况。系统如需查看异步任务的执行,需根据任务 ID 或任务输入参数,在任务管理中查看运行结果。



单击异步任务,进入任务管理系统,查看对话调试窗口中的异步任务执行情况。

单击详情可查看工作流快照,获取运行结束或运行中的工作流中每个节点的详细运行结果,便于问题定位和排查。
单击取消可取消状态为“运行中”、“等待输入”和“排队中”的异步任务。也可勾选想要取消的异步任务后,单击取消任务批量取消异步任务。已经运行成功的异步任务无法被取消。

若想调用工作流的 API 接口,创建工作流的异步运行实例,详情请参见 创建工作流的异步运行实例
注意:
对于包含参数提取节点、文件收集节点、文本收集节点、选项卡节点等需要用户交互的异步工作流,当运行到这些节点时,异步任务状态将变为"等待输入"。此时,工作流会暂停后续节点的执行,必须通过接口上传文件或选择选项,待操作成功完成后,工作流才会继续运行。

什么场景适合使用异步调用?

适合使用异步调用的场景主要包括以下几种情况:
当需要执行耗时较长的操作时,例如网络请求、文件读写或数据库查询等。采用异步调用可以避免阻塞主线程,保持应用的响应性。
在需要提高系统吞吐量的场景下。异步调用允许系统在处理一个请求的同时接收其他请求,从而更有效地利用系统资源。
当操作结果不需要立即获取时。如果用户不需要立即看到操作结果,异步调用可以提供更好的用户体验。
当系统需要处理突发的高并发请求时。异步调用可以帮助系统更好地应对流量高峰,避免系统过载。