📄 ai-sdk/cookbook/node/call-tools-multiple-steps
File: call-tools-multiple-steps.md | Updated: 11/15/2025
Source: https://ai-sdk.dev/cookbook/node/call-tools-multiple-steps
Menu
Google Gemini Image Generation
Get started with Claude 3.7 Sonnet
Get started with OpenAI o3-mini
Generate Text with Chat Prompt
Generate Image with Chat Prompt
streamText Multi-Step Cookbook
Markdown Chatbot with Memoization
Generate Object with File Prompt through Form Submission
Model Context Protocol (MCP) Tools
Share useChat State Across Components
Human-in-the-Loop Agent with Next.js
Render Visual Interface in Chat
Generate Text with Chat Prompt
Generate Text with Image Prompt
Generate Object with a Reasoning Model
Stream Object with Image Prompt
Record Token Usage After Streaming Object
Record Final Object after Streaming Object
Model Context Protocol (MCP) Tools
Retrieval Augmented Generation
Copy markdown
========================================================================================================================
Models call tools to gather information or perform actions that are not directly available to the model. When tool results are available, the model can use them to generate another response.
You can enable multi-step tool calls in generateText by defining stopping conditions with stopWhen. This allows you to define the conditions for which your agent should stop when the model generates a tool call.
import { generateText, tool, stepCountIs } from 'ai';import { openai } from '@ai-sdk/openai';import { z } from 'zod';
const { text, steps } = await generateText({ model: openai('gpt-4.1'), stopWhen: stepCountIs(5), tools: { weather: tool({ description: 'Get the weather in a location', inputSchema: z.object({ location: z.string().describe('The location to get the weather for'), }), execute: async ({ location }: { location: string }) => ({ location, temperature: 72 + Math.floor(Math.random() * 21) - 10, }), }), }, prompt: 'What is the weather in San Francisco?',});
On this page
Deploy and Scale AI Apps with Vercel.
Vercel delivers the infrastructure and developer experience you need to ship reliable AI-powered applications at scale.
Trusted by industry leaders:
- OpenAI
- Photoroom
