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

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.

agentsadvancedevaluationoptimizationself-improvementiterative

Loading interactive preview...

Installation

Option 1: Install via CLI

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

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

Content Quality Optimization

Create systems that generate content, evaluate quality against metrics, and automatically improve until standards are met.

Code Quality Enhancement

Build tools that generate code, evaluate against quality standards, and refactor until performance and maintainability goals are achieved.

Marketing Copy Optimization

Develop platforms that create marketing materials, test effectiveness metrics, and optimize for conversion rates.

Design Iteration Systems

Create tools that generate designs, evaluate against UX principles, and refine until usability standards are satisfied.

Technical Details

Dependencies

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

Files Included

• app/page.tsx
• app/api/optimize/route.ts

Related patterns

Text Generation

Basic non-streaming text generation with generateText. Submit a topic and get a generated paragraph — the simplest AI SDK pattern.

Structured Output

Generate typed, validated JSON data using Zod schemas and the generateObject function.

Interactive Demo Coming Soon

The evaluator-optimizer pattern demo is being prepared.

Download the pattern to try it with your API key