What are AI Agents?
An AI Agent is an AI system that:- Receives instructions and goals
- Reasons about how to accomplish the goal
- Uses tools to take actions (run workflows, search knowledge bases, call APIs, etc.)
- Observes results and adapts its approach
- Iterates until the goal is accomplished or it determines it cannot be completed
Agents vs Text Generation
| Feature | Text Generation | AI Agents |
|---|---|---|
| Purpose | Generate text response | Accomplish tasks |
| Tools | No tool use | Can use multiple tools |
| Iteration | Single response | Multi-step reasoning |
| Planning | No planning | Plans and executes steps |
| Autonomy | Responds to prompt | Autonomous task execution |
| Complexity | Simple → Moderate | Moderate → Very Complex |
Agent Capabilities
Core Capabilities
Reasoning: Break down complex tasks into steps Tool Use: Execute workflows, search knowledge bases, make API calls Memory: Remember conversation context and previous actions Adaptation: Adjust approach based on results and feedback Self-Correction: Recognize mistakes and try alternative approachesTool Types
Agents can use these tools: Workflow Execution: Run other Noxus workflows as tools Knowledge Base Search: Query knowledge bases for information Web Research: Search the web for current information Human-in-the-Loop: Ask humans for guidance or approval Agent Delegation: Delegate sub-tasks to other agents API Calls: Make external API requests (when configured)Basic Agent Node
The Basic Agent Node is the general-purpose agent for most use cases. Key Features:- Instruction-based prompting
- Configurable tool selection
- Variable inputs for dynamic context
- Agent mode for agent delegation
- Streaming responses
Writing Agent Instructions
Good instructions are clear, specific, and actionable:Structure
Example: Customer Support Agent
Example: Research Agent
Variable Inputs
Add context dynamically with variable inputs:Specialized Agent Nodes
SQL Agent
Query databases using natural language:- Database connection
- Schema information (optional, helps accuracy)
- Safety mode (read-only vs read-write)
Excel Agent
Analyze and query Excel files:Research Agent
Conduct multi-source research:Writer Agent
Generate long-form content:Company Agent
Research companies and gather business intelligence:Web Browser Agent
Automate web interactions:Agent Workflows
Pattern 1: Single Agent Task
Simple autonomous task execution:Pattern 2: Agent + Human Review
Agent does initial work, human reviews:Pattern 3: Multi-Agent Collaboration
Different agents handle different aspects:Pattern 4: Iterative Refinement
Agent iterates with feedback:Pattern 5: Agent Delegation (Agents)
Main agent delegates to specialized agents:Tool Selection Strategy
When to Enable Workflows
Enable workflow tools when the agent needs to:- Perform specific, well-defined operations
- Execute complex multi-node workflows
- Interact with external systems (via integration nodes)
- Process files or documents
- “Get Customer Info” - Lookup customer in CRM
- “Create Support Ticket” - Create ticket in ticketing system
- “Send Email” - Send formatted email via Gmail
- “Update Database” - Write data to database
When to Enable Knowledge Bases
Enable KB search when the agent needs to:- Answer questions based on your documents
- Retrieve domain-specific information
- Provide accurate, grounded responses
- Cite sources
When to Enable Web Research
Enable web research when the agent needs:- Current information not in knowledge bases
- Real-time data (stock prices, news, etc.)
- Information from public sources
- Broad research across multiple sites
When to Enable Human-in-the-Loop
Enable HITL when the agent should:- Get approval for critical actions
- Ask for clarification on ambiguous requests
- Escalate complex issues
- Collect additional information
Agent Model Selection
Model Comparison
| Model | Reasoning | Speed | Cost | Best For |
|---|---|---|---|---|
| GPT-4 | ⭐⭐⭐⭐⭐ | ⚡⚡ | 💰💰💰 | Complex reasoning, critical tasks |
| GPT-4o | ⭐⭐⭐⭐ | ⚡⚡⚡ | 💰💰 | Balanced performance |
| Claude Opus | ⭐⭐⭐⭐⭐ | ⚡⚡ | 💰💰💰 | Deep analysis, careful reasoning |
| Claude Sonnet | ⭐⭐⭐⭐ | ⚡⚡⚡ | 💰💰 | General-purpose agents |
| GPT-3.5 | ⭐⭐⭐ | ⚡⚡⚡⚡ | 💰 | Simple agents, high volume |
Choosing the Right Model
Use GPT-4 or Claude Opus when:- Task requires deep reasoning
- Multiple complex steps
- High accuracy is critical
- Creative problem-solving needed
- General-purpose agents
- Balanced cost/performance needed
- Most production use cases
- Simple, well-defined tasks
- High volume, cost-sensitive
- Speed is critical
Conversational Agents (Chatflows)
For multi-turn conversations, use Chatflow Agent Nodes:Chatflow Structure
- Maintains conversation context
- Multi-turn interactions
- Can use tools at any point
- Streaming responses
- Customer support chatbots
- Interactive assistants
- Multi-step data collection
- Guided workflows
Common Patterns
Pattern: Information Gathering Agent
Pattern: Research and Report Agent
Pattern: Database Query Agent
Pattern: Orchestrator Agent
Best Practices
Instructions
Be Specific: Clear instructions lead to better results Provide Context: Give agents domain knowledge in instructions Set Boundaries: Explicitly state what agents should NOT do Define Success: Explain what a successful outcome looks like Include Examples: Show examples of good responsesTool Configuration
Minimize Tools: Only enable tools the agent actually needs Create Focused Workflows: Make workflow tools do one thing well Organize Knowledge Bases: Well-organized KBs improve retrieval Test Tools Independently: Verify workflows/KBs work before giving to agentsError Handling
Set Expectations: Tell agents how to handle errors Enable Escalation: Allow agents to ask for help Log Everything: Track agent actions for debugging Monitor Performance: Review agent outputs regularlyCost Optimization
Use Appropriate Models: Don’t use GPT-4 for simple tasks Limit Tool Use: Constrain agents to necessary tools only Cache Results: Store expensive research/queries Set Iteration Limits: Prevent infinite loopsDebugging Agents
Common Issues
Agent Not Using Tools:- Tools may not be enabled
- Instructions don’t indicate when to use tools
- Agent thinks it doesn’t need tools
- Knowledge base missing information
- Instructions unclear
- Wrong model for task complexity
- Instructions too vague
- No clear success criteria
- Tool returning errors
Debugging Tips
Review Agent Reasoning: Check agent’s step-by-step thought process Test Tools Separately: Verify workflows and KBs work correctly Simplify Instructions: Start simple, add complexity gradually Try Different Models: Some models handle specific tasks better Add Explicit Steps: Guide agent with numbered stepsExample: Complete Customer Support Agent
Configuration
Integration in Workflow
Next Steps
Agent Node Types
Explore specialized agent nodes
Tools & Capabilities
Deep dive into agent tools
Conversational Flows
Build multi-turn chat experiences
Agent Node Reference
Complete agent node documentation
AI Agents are the most powerful way to build autonomous, intelligent automation in Noxus. Master agents to create truly transformative workflows.