Agent Issues

Troubleshooting guide for agent-related issues in Solo.

Agent Not Working

Symptoms

  • Agent not performing actions
  • Agent not responding
  • Agent shows as inactive
  • Agent errors in logs

Solutions

  1. Check Agent Status

    • Go to Team → Agents
    • Verify agent is "Active"
    • Check agent status indicator
    • Reactivate if needed

  2. Review Agent Configuration

    • Check agent settings
    • Verify configuration is correct
    • Review agent permissions
    • Check for missing settings

  3. Check Agent Logs

    • View agent activity logs
    • Look for error messages
    • Review recent actions
    • Check for warnings

  4. Verify Agent Permissions

    • Check agent has necessary permissions
    • Verify agent can access resources
    • Review agent role assignments
    • Check for permission errors

Agent Not Responding

Symptoms

  • Agent not responding to requests
  • Agent not processing emails
  • Agent not creating tasks
  • Agent timeout errors

Solutions

  1. Check Agent Activity

    • View agent activity logs
    • Check for recent actions
    • Verify agent is processing
    • Review agent status

  2. Review Agent Configuration

    • Check agent settings
    • Verify HITL thresholds
    • Review agent permissions
    • Check agent limits

  3. Check Rate Limits

    • Verify not hitting rate limits
    • Check usage statistics
    • Review plan limits
    • Upgrade if needed

  4. Verify Agent Resources

    • Check agent has access to resources
    • Verify agent can connect to services
    • Review agent dependencies
    • Check for connection errors

Agent Errors

Symptoms

  • Agent showing error messages
  • Agent failing to execute
  • Agent returning errors
  • Agent crashes

Solutions

  1. Review Error Messages

    • Read error messages carefully
    • Note error codes
    • Check error context
    • Document errors

  2. Check Agent Configuration

    • Verify configuration is valid
    • Check for missing settings
    • Review agent permissions
    • Validate agent settings

  3. Review Agent Logs

    • Check agent activity logs
    • Look for error patterns
    • Review recent errors
    • Check for warnings

  4. Verify Agent Dependencies

    • Check agent has required tools
    • Verify integrations are working
    • Review agent connections
    • Test agent dependencies

Agent Performance Issues

Symptoms

  • Agent responding slowly
  • Agent taking too long
  • Agent timeout errors
  • Agent performance degradation

Solutions

  1. Check Agent Configuration

    • Review agent settings
    • Optimize agent configuration
    • Check for inefficient settings
    • Review agent limits

  2. Review Agent Usage

    • Check agent usage statistics
    • Look for usage patterns
    • Review agent activity
    • Optimize agent usage

  3. Check System Resources

    • Verify system resources available
    • Check for resource constraints
    • Review system performance
    • Optimize resource usage

  4. Review Agent Dependencies

    • Check external service performance
    • Verify integrations are fast
    • Review agent connections
    • Optimize dependencies

Agent Not Processing Emails

Symptoms

  • Inbox Manager not handling emails
  • Emails not being processed
  • Agent not responding to emails
  • Email processing errors

Solutions

  1. Check Inbox Manager Status

    • Verify Inbox Manager is active
    • Check agent status
    • Review agent configuration
    • Reactivate if needed

  2. Review Email Settings

    • Check email processing settings
    • Verify email routing
    • Review email filters
    • Check email permissions

  3. Check Agent Configuration

    • Verify agent email settings
    • Review agent email permissions
    • Check agent email routing
    • Review agent email filters

  4. Review Agent Logs

    • Check agent email activity
    • Look for email processing errors
    • Review email handling logs
    • Check for email errors

Agent Not Creating Tasks

Symptoms

  • Agent not creating tasks from emails
  • Tasks not being created
  • Agent task creation errors
  • Missing tasks

Solutions

  1. Check Agent Permissions

    • Verify agent can create tasks
    • Check agent permissions
    • Review agent task settings
    • Check task permissions

  2. Review Agent Configuration

    • Check agent task creation settings
    • Verify agent task rules
    • Review agent task filters
    • Check agent task configuration

  3. Check Task Settings

    • Verify task creation is enabled
    • Check task settings
    • Review task permissions
    • Check task configuration

  4. Review Agent Logs

    • Check agent task creation activity
    • Look for task creation errors
    • Review task handling logs
    • Check for task errors

Getting Help

Self-Service

  • Check documentation: Review agent documentation
  • Search docs: Search for your issue
  • Read guides: Follow agent setup guides

Contact Support

If you can't resolve the issue:

  • Contact support: Reach out to support team
  • Provide details: Include agent name, error messages, and steps to reproduce
  • Check status: Verify service status
  • Be patient: Support will respond

Next Steps

Version: 1.0
Last Updated: November 2025