工作流的异步调用

最近更新时间:2025-12-25 14:19:31

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

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

进入单工作流模式,创建并配置工作流。确保工作流可正常运行,且不包含信息收集节点与回复节点。工作流的创建与配置方法,详情请参见 工作流的创建、配置与调试
创建并启用工作流后,可在应用中选择指定工作流。添加工作流时,可根据系统提示语查看该工作流是否支持异步调用:
支持异步调用:根据所选工作流,该应用支持同步调用和异步调用。
不支持异步调用:根据所选工作流,该应用仅支持同步调用。



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



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



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



单击详情可查看工作流快照,获取工作流中每个节点的详细运行结果,便于问题定位和排查。
若想调用工作流的 API 接口,创建工作流的异步运行实例,详情请参见 创建工作流的异步运行实例

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

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