For production workflows, choose Vercel Workflows with Vercel Sandbox and AI SDK when business steps, approvals, and auditability matter more than autonomous session flow.
Vercel Workflows is a managed durable orchestration layer for functions that must survive request boundaries, deployments, crashes, and long pauses. A workflow directive marks a stateful function, step directives isolate retryable work, sleeps pause without consuming compute, and hooks wait for external events such as human approval.
Vercel Workflows persists orchestration state, AI SDK handles model decisions, and Sandbox isolates code execution. Eve’s execution model fits agent-first sessions where durable conversation and tool-driven autonomy define the product.
In this guide you will learn:
- Why production workflows need deterministic steps, retries, and observable state.
- How durable functions, pauses, approvals, and replay work in Vercel Workflows.
- Where AI SDK fits for structured output, tool calling, providers, and agent loops.
- Why Vercel Sandbox belongs at the execution boundary.
- How Eve differs from explicit business-process orchestration.
- How to combine classification, validation, API calls, code execution, approval, and publishing.
Key insights
- 25,000 events and 10,000 steps per run bound how much a single workflow can carry.
- A durable workflow can pause for human input without holding a request open.
- AI SDK belongs inside model-facing steps, where schemas and tool permissions constrain model output.
- Sandbox should contain generated code while the workflow retains business state.
- Eve fits when persistent agent interaction is the primary product behavior.
Why production workflows need more than an agent loop
An agent loop asks a model what to do next, executes a tool, reads the result, and repeats. That pattern works for exploration, but it becomes difficult to inspect when a business process must follow rules.
A refund, vendor approval, account change, or content publication needs named states. You need to know what happened, what failed, what can run again, and which action requires a person.
Deterministic steps, retries, and observable state
Production orchestration starts with an explicit graph of allowed transitions. The model can help choose a path, but code should record that choice and validate the next move.
As of 2026-08-12, Vercel's Workflows documentation describes runs that survive crashes and deployments through deterministic replay. The page was last updated July 15, 2026, and records state and event logs as part of each run.
A refund workflow that retried a charge step after a timeout billed twice. The idempotency key would have caught it.
What is WorkflowAgent?, Vercel was published May 21, 2026. It says each tool call becomes a durable workflow step, failed steps retry automatically, and the default retry count is three attempts.
Retries still need boundaries. A failed database write should not trigger a second charge, duplicate a ticket, or publish the same document twice.
Where model decisions belong in the system
Models are good at handling ambiguity. They can classify an inbound request, extract fields from an email, select an approved API operation, or draft a response.
Refund eligibility belongs to deterministic code that checks account status, policy rules, authorization, and transaction history.
A useful division of labor looks like this:
- The model proposes a structured action.
- Code validates the action against business rules.
- The workflow records the result.
- A human approves exceptions.
- A separate step performs the side effect.
Compile the process into an explicit graph before execution. Agent freedom belongs inside bounded steps, where you can measure output quality and retry behavior.
What is Vercel Workflows?
Vercel Workflows is a durable orchestration layer for functions that must survive request boundaries, deployments, failures, and pauses. It gives you a place to define business state instead of leaving that state inside a model transcript.
The distinction matters because a chat session and a business process have different failure modes.
A conversation can continue after a vague answer. A payment or publication step needs a recorded decision.
Durable functions, steps, and replay
As of 2026-08-12, Vercel’s Workflow Concepts documentation, last updated July 14, 2026, describes a workflow directive that marks a durable stateful function. A step directive isolates work and provides built-in retries.
That separation gives you a practical unit for diagnosis. Each step can own one external call, one validation pass, or one transformation.
When the workflow replays, completed work can remain part of the recorded run rather than being treated as an untracked side effect.
For capacity planning, Vercel’s Workflow Pricing and Limits documentation, last updated June 16, 2026, lists 25,000 events and 10,000 steps per run.
The same page lists 2 GB of entity storage per run and no maximum run duration. Those documented limits do not remove capacity constraints in your APIs, databases, or downstream services.
A workflow also gives your team a shared vocabulary. “The validation step failed” is easier to act on than “the agent got stuck somewhere.”
Pauses, approvals, and failure recovery
A durable process must wait without burning compute. Vercel's Workflow Concepts documentation, last updated July 14, 2026, says sleeps consume no compute while paused, while hooks support external events and human approval.
That makes approval a persisted state transition. The workflow can stop after preparing a change, wait for a reviewer, and resume when the approval event arrives.
Vercel's WorkflowAgent guide says approvals can suspend execution for hours or days. The same guide describes resumable transport that reconnects after an interruption.
The design consequence is straightforward. Keep the request handler short, persist the workflow state, and let the process resume from its last durable boundary.
Record human approval as a named event with an owner, a timestamp, and an outcome.
Where AI SDK fits in the workflow stack
AI SDK handles model-facing work. It standardizes provider access and supplies primitives for text generation, structured output, tool calls, and agent behavior.
AI SDK is a component inside your workflow, called by the step that needs a model. Workflow state remains in the orchestration layer.
Structured output and tool calling
AI SDK by Vercel describes AI SDK as a TypeScript toolkit for AI applications and agents. Its core package supports text generation, structured output, tool calls, and agents, while its provider layer standardizes model access.
Use structured output when the next step needs data rather than prose. A classification result might contain an intent, confidence, customer identifier, and proposed operation.
The schema catches shape errors, and permission checks stay in the code that runs the operation.
That second check belongs in ordinary code. Validate permissions, required fields, policy limits, and current database state before calling an external system.
Tool definitions deserve the same discipline. Expose narrow operations with typed inputs instead of a general-purpose API client.
Give the model a "create draft invoice" operation and keep the HTTP method, URL, and payload in your code.
The workflow then records the tool request and its result. You can inspect the decision without treating the model’s wording as an audit record.
Provider choice and agent loops
Provider abstraction helps when you need to compare models, change vendors, or route different tasks to different providers. It does not remove the need to control the loop.
Keep an agent loop inside a durable step when the task is bounded and exploratory. Set a clear stopping condition, limit available tools, validate every structured result, and record the final output.
Put business transitions around that loop. The workflow should decide what happens after the agent returns, including whether to retry, request approval, or stop.
For API-heavy systems, Blazity’s AgentBridge API integration framework follows the same boundary: keep integrations typed and code-controlled while the model handles intent.
An agent can draft an API action. Your workflow should decide whether that action crosses a business boundary.
Why Vercel Sandbox belongs at the execution boundary
A generated script that installs dependencies needs a place to run that is separate from the process coordinating business state. Vercel Sandbox provides that runtime boundary for commands, files, network access, and generated artifacts.
The workflow decides when execution starts and what happens afterward. The sandbox runs the code and returns its result.
Running generated or untrusted code in isolation
Vercel's Sandbox JS SDK reference describes isolated Linux microVMs with command, file, snapshot, and network APIs. That gives you a controlled surface for generated scripts, dependency installation, data conversion, and test execution.
Isolation reduces the blast radius of a bad script. It does not replace credential policy, network restrictions, dependency review, or output validation.
Pass only the files and credentials the task needs. Keep secrets outside generated source.
Grant network access per task, as an explicit permission in the sandbox configuration.
The workflow should inspect the result after execution. A process exit code can be successful while the output remains invalid, incomplete, or unsafe to publish.
That is where deterministic checks matter. Validate file names, schema shape, generated artifacts, and domain rules before the next side effect.
Separating execution from orchestration
A sandbox process is disposable execution state. The workflow is durable business state.
Vercel’s Sandbox duration and persistence guide, published June 29, 2026, says sandbox sessions default to five minutes. It lists configurable maximum durations of 45 minutes on Hobby and up to 24 hours on Pro and Enterprise.
The same guide says snapshots expire after 30 days by default. Treat those limits as runtime properties of the sandbox and keep anything you need afterwards in durable storage.
The SDK reference describes persistent sandboxes by default, but persistence does not mean your business process has completed. Store important inputs, outputs, and status changes in workflow state or durable application storage.
If execution needs to continue after a sandbox ends, save the artifact, record the failure boundary, and create a new execution step. Do not make the orchestrator depend on a process that may disappear.
Where Eve fits instead
Eve starts with the agent session. The conversation, its tools, and its checkpoints form the center of the execution model.
That design is useful when the product is an autonomous working relationship. It becomes a mismatch when your main requirement is an explicit process with fixed approvals, checks, and side effects.
Agent-first sessions and filesystem-based tools
Eve's Execution Model and Durability documentation describes Eve sessions as durable conversations. Turns checkpoint at step boundaries, completed steps are not rerun after a crash, interrupted steps rerun, and parked approval or subagent work resumes later.
This is a strong model for an agent that works through a persistent task. The session can maintain context while the agent reads files, changes artifacts, calls typed tools, and waits for a person.
Eve’s Tools documentation describes tools as typed actions whose implementation remains code-controlled. Completed steps replay recorded results, while interrupted steps rerun.
That authoring model can support filesystem-oriented work without handing the model unrestricted process control. The agent chooses among defined actions, and the implementation remains in your code.
The question is where the business contract lives.
In Eve, the session can be the product. In an explicit workflow, the session is one participant in a larger state machine.
Why deterministic agent spawning does not replace structured outputs and deterministic checks
Agent spawning controls how many workers run and how they are arranged. It does not make their outputs predictable.
Eve's Dynamic Workflows guide, checked 2026-08-12, describes its Workflow tool as experimental. The guide covers sequential and parallel subagents, fan-out over a list, and result combination.
The guide sets the default subagent budget at 100 calls per program. Eve’s default harness documentation says the experimental Workflow tool is off by default and root-only.
That status may change, so verify Eve’s current documentation before making the tool a foundation for a regulated or revenue-bearing process.
Even with deterministic spawning, each agent can return incomplete data, conflicting conclusions, or an invalid action. You still need schemas, deterministic checks, approval gates, and idempotent side effects.
Eve's spawning model fits when parallel agent work is the product behavior. Explicit workflow steps keep the business process inspectable independent of the model.
A practical decision framework
The choice has a cost: agent-first orchestration gives the session control of the working rhythm, while explicit workflow state requires you to define and maintain each business transition.
The comparison below follows Eve's durability model and Vercel's workflow concepts, including checkpointed sessions, durable functions, steps, hooks, and event-driven resumption.
Decision point | Eve | Vercel’s stack |
|---|---|---|
Primary unit | A durable agent session and its conversation | A durable business workflow |
Model role | The agent directs tool use across an ongoing task | A model-facing step proposes or transforms data |
State model | Conversation turns and step checkpoints | Explicit workflow state, events, and step results |
Human input | Approval or parked work inside the session | A named approval event or workflow hook |
Code execution | Tool implementation controlled by your code | Sandbox runtime separated from orchestration |
Best fit | Autonomous, persistent agent interactions | Explicit business processes with fixed controls |
Choose Eve for autonomous, persistent agent interactions
Choose Eve when the conversation is the product. A coding assistant, research partner, or operations agent may need to maintain context while exploring files and tools over time.
Its durable session model reduces the amount of custom work needed to preserve agent context. The agent can pause, resume, and continue from recorded checkpoints.
You still need checks around external writes. The session model does not make a non-idempotent action safe, and agent output still needs evaluation.
Eve fits when you want the agent to own the working rhythm. Your team defines the tools and boundaries, while the session coordinates the task.
Choose Vercel’s stack for explicit business processes
Choose Vercel’s stack when a process has named stages, approval rules, external events, or audit requirements.
The model can classify a request or generate a proposal, and workflow state records the decision.
AI SDK handles the model interaction, Sandbox runs generated code, and deterministic code controls the side effects.
When a run stops, the dashboard names the step. Support can answer the customer without waiting for an engineer to read the logs.
If a process needs to be explained to finance, compliance, or support, explicit state usually communicates better than a transcript.
How to combine the pieces in one production pipeline
A production pipeline should give the model room to handle ambiguity without giving it ownership of every transition. Assign each responsibility to the layer that can observe and control it, so the following sequence keeps reasoning, validation, execution, and side effects separate.
Classify, validate, call APIs, execute code, approve, and publish
- Classify the request. Use AI SDK to return a structured intent and the fields needed for the next step.
- Validate the proposal. Check authorization, policy, data freshness, and required fields with deterministic code.
- Call approved APIs. Keep credentials and request construction inside a typed workflow step.
- Execute generated code. Send scripts, files, and permitted network access to Sandbox, then validate the returned artifacts.
- Request approval. Pause the workflow when a threshold, exception, or publication decision requires a person.
- Publish the result. Perform the final side effect only after prior checks and approval state are recorded.
This arrangement makes the model useful without making it the source of truth. It also gives each step a clear input, output, retry policy, and failure owner.
Failure boundaries and idempotent side effects
A failure boundary should answer one question: what can safely run again?
Pure classification can usually retry. A file transformation may retry if its inputs and output path are controlled.
A payment, email, deployment, or publication needs an idempotency strategy.
Use an idempotency key derived from the business operation. Record the key before or with the external write, then return the existing result when the same operation is retried.
Eve's Tools documentation makes the same distinction explicit: recorded results replay after completed steps, while interrupted steps rerun. It calls for idempotency or approval around non-idempotent side effects.
The same discipline applies to a workflow built on Vercel’s primitives. Put one meaningful side effect inside a step, persist its result, and make the retry behavior visible.
Sandbox execution can fail independently from orchestration. Save inputs and outputs outside the process, record the failure, and let the workflow decide whether to retry, request review, or stop.
A retry policy is part of the business design, written down per step alongside its failure owner.
Where to start with production workflows
Map the states first. Add model reasoning where ambiguity requires it, isolate generated code in Sandbox, and put human approval before consequential side effects.
If your team needs to design and ship that architecture, talk to Blazity about AI Agents Development.
FAQ on Vercel workflows
Can an agent loop handle a business process by itself?
An agent loop can handle bounded work, but it should not own the full business process. Keep classification and drafting inside the loop, then let deterministic workflow steps control validation, approvals, and side effects.
When should code execution become a separate sandbox step?
Generated or untrusted code should run in a separate sandbox step when it needs process, file, dependency, or network access. Keep orchestration state outside that runtime so a failed process does not erase the business record.
Does Eve replace durable workflow orchestration?
Eve can become a failure mode when a persistent agent session stands in for explicit business stages. Fixed stages still need workflow state, structured outputs, and deterministic checks.
How should retries handle external writes?
Retries should use idempotency keys or approval gates before repeating non-idempotent writes. Record the operation and its result so an interrupted step can resume without creating a duplicate side effect.
Sources
- Vercel Workflows, Vercel
- Workflow Concepts, Vercel
- Workflow Pricing and Limits, Vercel
- What is WorkflowAgent?, Vercel (May 21, 2026)
- AI SDK by Vercel
- JS SDK Reference, Vercel Sandbox
- How Vercel Sandbox duration and persistence work, Vercel (June 29, 2026)
- Execution Model and Durability, Eve
- Dynamic Workflows, Eve
- Tools, Eve
- The Harness, Eve