The AI Agent node runs large language models (LLMs) inside your workflow — for summarization, content generation, data extraction, classification, and more.
Basic configuration
| Field | Description |
|---|---|
| Provider | OpenAI, Anthropic, or Google Gemini |
| Model | e.g. gpt-4o, gpt-4o-mini, claude-3-5-sonnet, gemini-2.0-flash |
| Prompt | Instructions and data, using {{template}} syntax |
| System Prompt | Optional persona or rules for the model |
| Temperature | 0 = deterministic, 1 = creative (default 0.7) |
| Max Tokens | Limit response length |
Prompt templates
Reference data from previous nodes in your prompt:
Analyze the following customer feedback and return a JSON object with
"sentiment" (positive/negative/neutral) and "summary" (one sentence):
{{lastOutput}}
Or use workflow variables:
Write a {{variables.tone}} email responding to:
{{inputs.message}}
API keys
Provide your AI provider API key in one of these places:
- Organization Settings → Agent — default key for all AI nodes
- Per-node — override in the AI node configuration panel
Keys are stored securely and never included in workflow exports.
Agent mode
Enable Agent Mode to let the AI node use tools and iterate:
| Setting | Description |
|---|---|
| Agent Mode | AI can call tools and loop until the task is done |
| Max Iterations | Safety limit on how many tool-call rounds (default 10) |
| Enabled Tools | Select which tools the agent can use |
| Decision Gate | Require confirmation before certain actions |
Agent mode is powerful for multi-step tasks like "fetch data, analyze it, then send a summary" within a single node.
Output
The AI node's output typically includes:
content— the model's text response- Additional metadata depending on provider and agent mode
Downstream nodes access this via {{lastOutput}} or {{lastOutput.content}}.
Tips
- Start with
gpt-4o-minifor fast, low-cost tasks; upgrade togpt-4ofor complex reasoning. - Ask for structured output (JSON) when the next node needs to parse the response — pair with a Transform → Parse JSON step.
- Keep prompts specific: tell the model the format, length, and tone you want.
- Use the Text node to build reusable prompt fragments you can reference.
Example workflows
- Content generation: Start → AI Agent → Action (post to Slack)
- Data extraction: HTTP Request → AI Agent ("extract fields as JSON") → Transform
- Classification: Start (webhook) → AI Agent ("categorize this ticket") → Condition
See Cookbook recipes for complete examples.