AI
AI SDK Patterns

Command Palette

Search for a command to run...

PatternsComposeGitHub
All Patterns

Core / SDK

9
  • Structured Output
  • Generative UI
  • JSON Renderer
  • Text Generation
  • Image Generation
  • Streaming Object
  • Code Artifact
  • Form Generator
  • CSV Editor

Chat

4
  • Streaming Chat
  • Markdown Chat
  • Reasoning Display
  • Chat with Citations

Agents

5
  • Tool Calling
  • Multi-Step Agent
  • Routing Agent
  • Orchestrator Agent
  • Evaluator-Optimizer

Tools

2
  • Web Search Agent
  • RAG Pipeline

Workflows

3
  • Human-in-the-Loop
  • Sequential Workflow
  • Parallel Workflow
PatternsComposeAI SDK DocsGitHub

Built with AI SDK · shadcn/ui · Next.js

© 2026 AI SDK Patterns

Multi-Step Agent

Build an agent that orchestrates multiple tool calls in sequence, using the AI SDK's maxSteps and automatic tool result forwarding.

agentsadvancedagentmulti-steporchestrationmaxSteps

Loading interactive preview...

Installation

Option 1: Install via CLI

pnpm dlx shadcn@latest add https://ai-sdk-patterns.vercel.app/r/multi-step-agent

Automatically installs the pattern and its dependencies in your project.

Option 2: Copy or Download

Download the complete pattern as a standalone Next.js project.

Usage

1. Set up environment variables

# .env.local
ANTHROPIC_API_KEY=your_anthropic_key
OPENAI_API_KEY=your_openai_key
GOOGLE_GENERATIVE_AI_API_KEY=your_google_key

Add your AI provider API key to enable real functionality.

2. Run the development server

npm run dev
# or
pnpm dev
# or
yarn dev

Open http://localhost:3000 to see the pattern in action.

3. Customize for your needs

The pattern is ready to use. Modify the components, API routes, and styling to fit your application.

  • Update the UI components in app/page.tsx
  • Modify API logic in app/api/
  • Adjust styling with Tailwind CSS classes
  • Add your own business logic and data sources

Use Cases

Travel Planning Assistants

Build agents that research destinations, compare prices, book flights, and create itineraries through multiple coordinated steps.

Research Assistant Systems

Create agents that gather information from multiple sources, synthesize findings, and generate comprehensive reports.

Project Management Tools

Develop agents that break down projects, assign tasks, track progress, and generate status updates automatically.

Complex Problem Solvers

Build agents that tackle multi-step problems like legal research, medical diagnosis, or engineering analysis.

Technical Details

Dependencies

• Next.js 16+ (App Router)
• AI SDK v6
• React 18+
• Tailwind CSS
• TypeScript

Files Included

• app/page.tsx
• app/api/agent/route.ts
• lib/model.ts

Related patterns

Tool Calling

Let the AI model call functions and use external tools with the multi-step tool loop.

Human-in-the-Loop

Pause AI execution to get human approval before executing sensitive tool calls. Uses tool confirmation flow with the AI SDK.

Interactive Demo Coming Soon

The multi-step-agent pattern demo is being prepared.

Download the pattern to try it with your API key