Docs
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
Class References
Function References
Interface References
Type Alias References
Variable References
Function References

maxIterations

Function: maxIterations()

ts
function maxIterations(max): AgentLoopStrategy;
function maxIterations(max): AgentLoopStrategy;

Defined in: packages/ai/src/activities/chat/agent-loop-strategies.ts:25

Creates a strategy that continues for a maximum number of model turns (iterations), not tool calls.

One iteration can still emit many parallel tool calls. Prefer maxToolCalls (and optionally maxToolCallsPerTurn on chat()) when you need a tool-call budget.

Parameters

max

number

Maximum number of model turns to allow

Returns

AgentLoopStrategy

AgentLoopStrategy that stops after max iterations

Example

typescript
const stream = chat({
  adapter: openaiText(),
  model: "gpt-4o",
  messages: [...],
  tools: [weatherTool],
  agentLoopStrategy: maxIterations(3), // Max 3 model turns
});
const stream = chat({
  adapter: openaiText(),
  model: "gpt-4o",
  messages: [...],
  tools: [weatherTool],
  agentLoopStrategy: maxIterations(3), // Max 3 model turns
});