Multi-Step Tool Pattern

Execute multi-step workflows with typed tools. Includes streaming, tool chaining, and decision-making for automated tasks.

Loading preview…

Problems solved

Technical challenges this implementation handles out of the box.

Products and workflows this pattern is designed to support.

Requirements, wiring steps, and what this pattern adds to your project.

Pick how you want to pull this pattern in. Then wire env vars and routes the same way.

1
Install from the preview toolbar
Copy the install command above and run it in your project — Pro patterns include a short-lived token.
2
Add environment variables to .env.local
OPENAI_API_KEY, PERPLEXITY_API_KEY
3
Point client fetches at your API routes
Replace preview `/view/.../api/...` paths with `/api/...` in the installed files.
4
Customize the agent and tool files
Adapt prompts, tools, and stop conditions for your product — Copy for AI in the toolbar helps seed that work.
5
Run your dev server and open the pattern route
Install dependencies if needed, then start the app and verify responses.

AI SDK APIs

AgenttoolstepCountIsgenerateObjectExperimental_AgentgatewayhasToolCall

Providers

OpenAIPerplexity

External services

Hacker News

18 files

7 total

npm packages

AISDKlucide-reactNext.jsReactsonnerZod

Registry components

empty

multi-step-tool-agent/route.ts
API route wiring the agent to HTTP: uses createAgentUIStreamResponse and validateUIMessages to connect the multi-step agent to a streaming endpoint.
lib/multi-step-agent.ts
Core agent definition: creates an Experimental_Agent with comprehensive system instructions, 5 registered tools, and stop conditions (hasToolCall or stepCountIs(8)).
ai-agent-multi-step-tools/web-search.ts
Web search tool using Perplexity Sonar: uses generateObject with perplexity/sonar model. Implements generator-based execute with loading/ready states.
ai-agent-multi-step-tools/news-search.ts
News search tool using HN Algolia API. Generator-based tool with loading/ready states and graceful error fallback.
ai-agent-multi-step-tools/analyze.ts
Analysis tool: breaks down complex problems into components using systematic/creative/technical approaches. Generator-based with Zod schema validation.
ai-agent-multi-step-tools/decide.ts
Decision tool with scoring logic: evaluates options against criteria using keyword matching and heuristic scoring. Shows a tool with non-trivial local computation.
ai-agent-multi-step-tools/provide-answer.ts
Terminal answer tool that synthesizes all previous tool results into a final structured answer with inline citations and confidence score. Triggers agent termination via stopWhen condition.
ai-agent-multi-step-tools/schema.ts
Shared Zod schemas for web search tools: WebSearchItemSchema and WebSearchSchema for Perplexity Sonar responses.

Loading preview…