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 ArtifactPopular
  • Form Generator
  • CSV Editor

Chat

5
  • Streaming ChatPopular
  • Markdown Chat
  • Reasoning Display
  • Chat with Citations
  • Multi-Modal ChatNew

Agents

5
  • Tool CallingPopular
  • Multi-Step AgentPopular
  • Routing Agent
  • Orchestrator Agent
  • Evaluator-Optimizer

Tools

4
  • Web Search Agent
  • RAG PipelinePopular
  • MCP Client AgentNew
  • Text-to-SQLNew

Workflows

7
  • Human-in-the-Loop
  • Sequential Workflow
  • Parallel Workflow
  • Durable Multi-Turn Chat Agent
  • Human-in-the-Loop Approval Workflow
  • Scheduled/Delayed AI Task
  • Refinement Loop
PatternsComposeAI SDK DocsGitHub

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

© 2026 AI SDK Patterns

Refinement Loop

AI refinement loop inside a durable workflow: generate → evaluate score → if low, refine and loop (max 3 times). Uses 'use step' for each phase.

workflowsadvancedworkflowrefinementevaluationiterationworkflow-devkit

Loading interactive preview...

Installation

Option 1: Install via CLI

pnpm dlx shadcn@latest add https://ai-sdk-patterns.vercel.app/r/refinement-loop

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

Custom Applications

Adapt this pattern for your specific use case and requirements.

Learning & Prototyping

Use this pattern to learn AI SDK concepts and prototype new ideas.

Integration Projects

Integrate AI capabilities into existing applications and workflows.

MVP Development

Quickly build minimum viable products with AI-powered features.

Technical Details

Dependencies

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

Files Included

• app/workflows/refinement-loop.ts
• app/api/refine/route.ts

Related patterns

Evaluator-Optimizer

Generate-evaluate-iterate loop that self-improves output quality. Generates a draft, evaluates it against criteria, and regenerates until the quality threshold is met.

Scheduled/Delayed AI Task

Durable workflow that sleeps for 7 days, then runs AI summarization/RAG on new data and generates a report. Uses 'use workflow' and sleep().

🔒 Demo mode - refinement loop iteratively improves content quality