用途:为复杂智能体工作流提供持久、可靠的执行。工作流保证多步骤操作可靠完成、在服务器故障后仍能存续,并保持幂等性。
适用场景:构建多步骤智能体操作(研究→分析→报告);协调多个智能体协同工作;需要存活于服务器重启的长时运行操作;确保幂等(重试也不产生重复工作);需要持久化执行保证的复杂应用。
设置:在 convex.config.ts 中配置 Workflow 组件,导入并使用 agent 与 workflow: import { defineApp } from "convex/server"; import agent from "@convex-dev/agent/convex.config"; import workflow from "@convex-dev/workflow/convex.config";
const app = defineApp(); app.use(agent); app.use(workflow);
export default app;
定义工作流:使用 @convex-dev/workflow 的 WorkflowManager,通过 workflow.define 声明 id、args 与 handler。handler 接收 step,用 step.runMutation 和 step.runAction 逐步执行,例如创建线程后生成文本回应。
多智能体工作流:可依次创建多个线程并调用 generateTextAction,实现如先研究再分析的流程,最后汇总返回结果。
关键原则:持久性(工作流可存活服务器重启);幂等性(同一工作流可安全重试);原子性(每步要么完整完成要么重试);可组合性(步骤可调用其他工作流或动作)。
后续可参考 fundamentals 了解智能体设置、tools 了解可调用函数的智能体、context 了解工作流感知上下文。具体依赖版本、安装命令与更多 API 细节资料未提供。