Agent Node
The Agent Node runs a TinyAgent as a step in your workflow. Instead of using fixed AI prompts (TinyGPT), the agent can use its full capabilities (tools, sub-agents, knowledge base) to process the input.
Type: AGENT_WORKFLOW / AGENT_WORKFLOW_V3
Credits: Varies (depends on the agent's model and tool usage)
When to use Agent Node vs TinyGPT
| Feature | TinyGPT | Agent Node |
|---|---|---|
| Prompt | Fixed, defined in the node | Agent's full instructions + identity |
| Tools | None | All agent tools (API, workflows, sub-agents) |
| Knowledge base | None | Agent's uploaded documents |
| Multi-step reasoning | Single pass | Can call tools, reason, call more tools |
| Cost | 10 credits | Varies (depends on complexity) |
| Speed | Fast (one API call) | Slower (multiple tool calls possible) |
Use TinyGPT for simple, single-step AI tasks (classify, extract, format). Use Agent Node for complex tasks that need tools, knowledge, or multi-step reasoning.
Configuration
| Field | Description |
|---|---|
| Agent | Select which TinyAgent to run |
| Message | The input message/query to send to the agent (FX formula; use variables) |
How it works
- The workflow reaches the Agent Node
- It sends the message to the selected agent
- The agent processes it using its instructions, tools, and knowledge
- The agent may call tools (APIs, workflows) as part of its reasoning
- The final response becomes the node's output
- Downstream nodes can reference the response
Example: Intelligent support routing
Webhook (support ticket) → Agent Node (support triage agent) →
If-Else (agent.result.action) →
"escalate": Create JIRA (P0) + Send Slack (#urgent)
"respond": Send Email (agent's drafted response)
"info_needed": Send Email (request more details)
The agent reads the ticket, checks the knowledge base, uses tools to look up the customer, and decides the best action.
Example: Research + write pipeline
Manual Trigger (topic) → Agent Node (research agent with Scout + Composer) →
The agent researches the topic, then writes a draft →
HITL (review) → Send Email
The Agent Node is more powerful but slower and more expensive than TinyGPT. Use it when the task genuinely needs tools and multi-step reasoning, not for simple classification or extraction.