Terminal
Terminal/Skill
Builds a durable multi-step pipeline on Convex where each step retries on its own when it fails.
By Convex
Works with
npx skills add get-convex/convex-backend-skill --skill workflow@convex-dev/workflowWhen the task is "do step A, then B, then C, and retry each step independently if it fails" — a pipeline, ETL, or orchestration that must survive crashes — use the workflow component. Do NOT hand-roll it with a jobs table + chained ctx.scheduler.runAfter calls: that reinvents durability, loses per-step retry/backoff, and (measured) scores worse than a plain implementation. Copy this pattern.
// convex/convex.config.ts
import { defineApp } from "convex/server";
import workflow from "@convex-dev/workflow/convex.config";
const app = defineApp();
app.use(workflow);
export default app;
step.run* call per stage, retried independently// convex/workflows.ts
import { WorkflowManager } from "@convex-dev/workflow";
import { components, internal } from "./_generated/api";
import { v } from "convex/values";
export const workflow = new WorkflowManager(components.workflow, {
// Per-step default: retry each failed step independently with backoff.
defaultRetryBehavior: { maxAttempts: 4, initialBackoffMs: 1000, base: 2 },
retryActionsByDefault: true,
});
export const transcribeAndSummarize = workflow.define({
args: { url: v.string(), userEmail: v.string() },
handler: async (step, args): Promise<void> => {
// Each step.runAction is durable + independently retried. If summarize fails
// 3× then succeeds, transcribe is NOT re-run — completed steps are memoized.
const transcript = await step.runAction(internal.youtube.transcribe, { url: args.url });
const summary = await step.runAction(internal.llm.summarize, { transcript });
await step.runAction(internal.email.sendSummary, { to: args.userEmail, summary });
},
});
step, not ctx. Call step.runAction / step.runMutation / step.runQuery with a codegen'd internal.* reference — never ctx.run* inside a workflow (that breaks durability/memoization).step.run* is a durable checkpoint. On crash or retry, completed steps are replayed from their stored result, not re-executed — so steps must target internalAction/internalMutations that do the real work.step.runAction(ref, args, { retry: { maxAttempts: 6, initialBackoffMs: 500, base: 2 } }). Set { retry: false } for a step that must not repeat (already-idempotent external charge).internalActions — external APIs go in actions (see convex-external-apis), email via @convex-dev/resend (see crons).// from a public mutation/action the client calls:
const workflowId = await workflow.start(
ctx,
internal.workflows.transcribeAndSummarize,
{ url, userEmail },
);
// status later: await workflow.status(ctx, workflowId) → cleanup: workflow.cleanup(ctx, workflowId)
jobs/pipeline table + ctx.scheduler.runAfter chain to fake retries/ordering — that's what the component exists to replace.ctx.runAction inside the workflow handler — use step.runAction or you lose durability.