Function: maxIterations()#

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#

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