AI Agent
Early Alpha Version
AI Agents are in early alpha. Node interfaces, behaviors, and APIs are subject to change.
The AI Agent node is the core unit. It takes an LLM configuration and optional tools, and outputs a ready-to-use agent object that you connect to an Agent Chat node.
Inputs
| Input | Type | Default | Description |
|---|---|---|---|
| LLM Config | Object | — | Connect from an LLM Provider node |
| Instructions | String (multiline) | You are a helpful AI assistant. | System prompt that defines the agent's behavior |
| Agent Name | String | My Agent | A human-readable name for the agent |
| Tools | Array | — | Explicitly wired tool definitions (optional if auto-discovery is enabled) |
| Auto-Discover Tools | Boolean | true | Automatically find Agent Tool nodes in the same component |
| Max Retries | Number | 2 | Number of retry attempts on failure |
Outputs
| Output | Type | Description |
|---|---|---|
| Agent | Object | The agent instance — connect to Agent Chat |
| Agent Info | String | Summary of the agent's configuration (name, model, tool count) |
| Error | String | Error message if the agent failed to build |
Auto-Discovery
When Auto-Discover Tools is enabled (the default), the Agent automatically scans its component for any Agent Tool nodes and registers their tools. This means you can simply drop Tool nodes into the same component — no manual wiring required.
- Explicitly wired tools (via the Tools input) take priority over discovered tools with the same name.
- The Agent Info output lists all discovered tools by name.
Writing Good Instructions
The Instructions input is the system prompt. Here are some tips:
- Be specific: "You are a customer support agent for an e-commerce store. Be polite and concise." is better than "You are helpful."
- Set boundaries: "Only answer questions about our products. For other topics, politely redirect."
- Define format: "Always respond in bullet points" or "Keep responses under 100 words."
- Mention tools: "You have access to a
search_productstool. Use it when the user asks about products."
Usage Tips
- The Agent rebuilds automatically whenever the LLM Config, Instructions, or Tools change.
- If the LLM Config input is not connected, the node displays
[No LLM Config connected]. - Connect multiple Tool nodes for agents that can perform several actions (search, calculate, create records, etc.).