Skip to main content
AI Agents are autonomous assistants that can reason, use tools, and accomplish complex multi-step tasks. Unlike simple text generation, agents can plan, take actions, and adapt based on results.

What are AI Agents?

An AI Agent is an AI system that:
  1. Receives instructions and goals
  2. Reasons about how to accomplish the goal
  3. Uses tools to take actions (run workflows, search knowledge bases, call APIs, etc.)
  4. Observes results and adapts its approach
  5. Iterates until the goal is accomplished or it determines it cannot be completed

Agents vs Text Generation

FeatureText GenerationAI Agents
PurposeGenerate text responseAccomplish tasks
ToolsNo tool useCan use multiple tools
IterationSingle responseMulti-step reasoning
PlanningNo planningPlans and executes steps
AutonomyResponds to promptAutonomous task execution
ComplexitySimple → ModerateModerate → Very Complex
When to use Text Generation: Content creation, analysis, extraction, classification When to use Agents: Multi-step tasks, research, complex workflows, autonomous assistants

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 approaches

Tool 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
Configuration:
Instructions:
Define the agent's role, capabilities, and goals.

Tools:
☑ Workflows: Select workflows the agent can run
☑ Knowledge Bases: Select KBs the agent can search
☑ Human in the Loop: Allow agent to ask for human input
☑ Web Research: Enable web search capability

Model:
Choose the underlying LLM (GPT-4, Claude Opus, etc.)

Writing Agent Instructions

Good instructions are clear, specific, and actionable:

Structure

# Role
You are a [role description].

# Capabilities
You can:
- [Capability 1]
- [Capability 2]
- [Capability 3]

# Tasks
Your task is to [primary goal].

[Specific instructions on how to accomplish the goal]

# Guidelines
- [Guideline 1]
- [Guideline 2]
- [Guideline 3]

# Output Format
[How to structure responses]

Example: Customer Support Agent

# Role
You are a helpful customer support agent for Acme Software.

# Capabilities
You can:
- Search the knowledge base for product documentation
- Look up customer account information
- Create support tickets
- Escalate to human agents when needed

# Tasks
Help customers resolve their issues by:
1. Understanding their problem thoroughly
2. Searching the knowledge base for solutions
3. Providing clear, step-by-step guidance
4. Creating tickets for unresolved issues

# Guidelines
- Always be polite and professional
- Don't make promises about features or timelines
- If unsure, escalate to a human agent
- Verify customer identity before accessing account info

# Output Format
Provide responses in a friendly, conversational tone.
For technical solutions, use numbered steps.

Example: Research Agent

# Role
You are a research analyst specializing in competitive intelligence.

# Capabilities
You can:
- Search the web for current information
- Analyze and synthesize information from multiple sources
- Access company knowledge base for internal data

# Tasks
Research competitors and create comprehensive reports:
1. Identify key competitors in the specified market
2. Gather information on their products, pricing, and market positioning
3. Synthesize findings into actionable insights
4. Structure the report with clear sections and citations

# Guidelines
- Always cite sources for claims
- Focus on recent information (last 12 months)
- Be objective and fact-based
- Note any limitations or gaps in available data

# Output Format
Return a structured report with:
- Executive Summary
- Competitor Profiles
- Key Findings
- Recommendations

Variable Inputs

Add context dynamically with variable inputs:
Instructions:
You are a sales assistant helping with lead qualification.

Customer Information:
Name: {customer_name}
Company: {company_name}
Industry: {industry}
Previous Interactions: {interaction_history}

Based on this information, qualify the lead and suggest next steps.
Connect data to these variables from previous nodes.

Specialized Agent Nodes

SQL Agent

Query databases using natural language:
Input: "Show me all customers who signed up in the last 30 days"
SQL Agent: Generates and executes SQL query
Output: Query results
Configuration:
  • Database connection
  • Schema information (optional, helps accuracy)
  • Safety mode (read-only vs read-write)

Excel Agent

Analyze and query Excel files:
Input: "What's the average revenue per quarter?"
Excel Agent: Reads Excel, computes statistics
Output: Analysis results

Research Agent

Conduct multi-source research:
Input: "Research AI coding assistants and compare top 5"
Research Agent:
  1. Searches web for AI coding tools
  2. Identifies top 5 by market share
  3. Researches each tool's features
  4. Compares and contrasts
  5. Returns structured comparison
Output: Comprehensive research report

Writer Agent

Generate long-form content:
Input: "Write a blog post about the future of remote work"
Writer Agent:
  1. Plans article structure
  2. Researches current trends
  3. Writes introduction
  4. Develops main points
  5. Writes conclusion
Output: Full blog post

Company Agent

Research companies and gather business intelligence:
Input: "Research Acme Corp's recent activities"
Company Agent:
  1. Searches for company information
  2. Finds recent news and announcements
  3. Identifies key executives
  4. Gathers financial data (if public)
Output: Company intelligence report

Web Browser Agent

Automate web interactions:
Input: "Fill out the contact form on example.com with this data"
Web Browser Agent:
  1. Navigates to website
  2. Locates form fields
  3. Fills in information
  4. Submits form
Output: Confirmation of submission

Agent Workflows

Pattern 1: Single Agent Task

Simple autonomous task execution:
Input (task description)

Basic Agent (with tools enabled)

Output (task result)
Example: “Research our competitor’s new product launch and summarize key features”

Pattern 2: Agent + Human Review

Agent does initial work, human reviews:
Input (complex request)

Research Agent (gather information)

Human in the Loop (review and approve findings)

Writer Agent (create final document)

Output (approved document)

Pattern 3: Multi-Agent Collaboration

Different agents handle different aspects:
Customer Request

Classification Agent (determine request type)

Switch Node (route by type)
    ├─ Technical: SQL Agent (query database)
    ├─ Research: Research Agent (web search)
    └─ Creative: Writer Agent (content generation)

Basic Agent (synthesize and format response)

Output

Pattern 4: Iterative Refinement

Agent iterates with feedback:
Input (content requirements)

Writer Agent (first draft)

AI Analysis (quality check)

Conditional (quality score)
    ├─ Good: Accept draft
    └─ Needs Improvement

        Writer Agent (revise with feedback)

        (repeat quality check)

Pattern 5: Agent Delegation (Agents)

Main agent delegates to specialized agents:
Main Agent (project coordinator)
    ├─ Delegates to Research Agent (gather data)
    ├─ Delegates to SQL Agent (query database)
    └─ Delegates to Writer Agent (create report)

Main Agent (synthesizes all results)

Final Output

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
Best Practice: Create focused workflows for specific tasks, then give agents access to them. Example Workflows:
  • “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
Best Practice: Organize knowledge bases by domain (Product Docs, Company Policies, Support Articles).

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
Warning: Web research is slower and less reliable than knowledge bases. Use for supplemental information.

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
Best Practice: Use HITL as a safety net for high-stakes decisions.

Agent Model Selection

Model Comparison

ModelReasoningSpeedCostBest 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
Use GPT-4o or Claude Sonnet when:
  • General-purpose agents
  • Balanced cost/performance needed
  • Most production use cases
Use GPT-3.5 when:
  • Simple, well-defined tasks
  • High volume, cost-sensitive
  • Speed is critical

Conversational Agents (Chatflows)

For multi-turn conversations, use Chatflow Agent Nodes:

Chatflow Structure

Chatflow Start

Agent Configuration (system prompt, tools)

(User can send multiple messages)

Agent Response (with tool use)

(Conversation continues)

Chatflow End (optional, explicit end)
Key Features:
  • Maintains conversation context
  • Multi-turn interactions
  • Can use tools at any point
  • Streaming responses
Use Cases:
  • Customer support chatbots
  • Interactive assistants
  • Multi-step data collection
  • Guided workflows

Common Patterns

Pattern: Information Gathering Agent

Agent Instructions:
You are a lead qualification agent.

Your task is to gather information about potential customers by asking questions.

Required information:
- Company name
- Industry
- Company size
- Primary pain points
- Budget range
- Timeline for decision

Ask questions one at a time. After gathering all information, provide a lead score (1-100) with justification.

Tools: None needed (conversational only)

Pattern: Research and Report Agent

Agent Instructions:
You are a market research analyst.

Task: Research the specified topic and create a comprehensive report.

Process:
1. Use web research to gather current information
2. Search knowledge base for internal data
3. Synthesize findings
4. Create structured report with citations

Tools:
☑ Web Research
☑ Knowledge Base: [Market Research KB]

Pattern: Database Query Agent

Agent Instructions:
You are a business intelligence assistant.

Help users query the sales database by:
1. Understanding their question in natural language
2. Generating appropriate SQL queries
3. Explaining the results clearly
4. Creating visualizations when helpful

Tools:
☑ SQL Database: [Sales DB]
☑ Workflow: "Create Chart"

Pattern: Orchestrator Agent

Agent Instructions:
You are a project orchestrator.

Coordinate multiple specialized agents to accomplish complex tasks:
1. Break down the project into sub-tasks
2. Delegate to appropriate specialist agents
3. Monitor progress and results
4. Synthesize results into final deliverable

Tools:
☑ Agents: [Research Agent, Data Agent, Writer Agent]
☑ Human in the Loop (for approval)

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 responses

Tool 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 agents

Error 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 regularly

Cost 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 loops

Debugging 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
Agent Giving Wrong Answers:
  • Knowledge base missing information
  • Instructions unclear
  • Wrong model for task complexity
Agent Loops or Gets Stuck:
  • 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 steps

Example: Complete Customer Support Agent

Configuration

Instructions:
# Role
You are a Tier 1 customer support agent for TechCorp Software.

# Capabilities
- Search support knowledge base
- Look up customer accounts
- Create and update support tickets
- Escalate complex issues

# Process
1. Greet the customer warmly
2. Understand their issue by asking clarifying questions
3. Search the knowledge base for solutions
4. If found, provide clear step-by-step guidance
5. If not found or complex, escalate to human agent
6. Create support ticket for all interactions

# Guidelines
- Be professional and empathetic
- Verify customer identity before accessing account info
- Never promise features or timelines
- Escalate if customer is frustrated or issue is urgent
- Always create a ticket, even if resolved immediately

# Escalation Criteria
Escalate if:
- Security or billing issues
- Customer explicitly requests human agent
- Issue requires code changes or bugs
- You've tried 3 solutions without success

Tools:
☑ Knowledge Base: Support Articles
☑ Workflow: Lookup Customer
☑ Workflow: Create Ticket
☑ Human in the Loop

Model: GPT-4o

Integration in Workflow

Chatflow Start

Customer Support Agent (configured as above)

(Multi-turn conversation)

Agent Decision Point
    ├─ Resolved: Thank customer, end chat
    ├─ Escalated: Transfer to human (HITL)
    └─ Complex: Create ticket, schedule follow-up

Log Interaction

Update CRM

Chatflow End

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.