Agent run

• Type ai.agentRun
• Group AI
• Role action
• Risk acts outside MZBase
• Side effect has an effect each run
• Runs once per item
• Needs ai

Hands the task to Claude Code or Codex and waits for its answer

Also available to AI agents and over MCP as a tool.

Parameters

agent

Agent · string · required · default claude-code · one of claude-code, codex, gemini-cli

prompt

Prompt · string · required

What the AI should do. Expressions insert item data.

folder

Folder · string · optional

model

Model · string · optional

accountId

Account · string · optional

permissionMode

Permission mode · string · optional · default readOnly · one of readOnly, autoEdit, fullAuto

timeoutMs

Timeout (ms) · integer · optional · default 600000 · range 1000 – …

How long to wait, in milliseconds, before the step fails.

newSessionPerItem

New session per item · boolean · optional · default true

Outputs

• main

← All nodes