Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mixus.ai/llms.txt

Use this file to discover all available pages before exploring further.

Learn how to create powerful AI agents that can automate tasks, integrate with external services, and collaborate with your team.

Overview

mixus agents are AI-powered assistants that can perform specific tasks automatically. They can be triggered by events, scheduled to run at specific times, or activated manually to help streamline your workflows.

Key Features

  • Custom Instructions: Define exactly how your agent should behave and respond
  • Integration Access: Connect agents to 200+ external services and business applications
  • Flexible Triggers: Schedule, event-based, or manual activation
  • Team Collaboration: Share agents with your organization
  • Multi-Modal: Process text, images, documents, and files

How It Works

  1. Define Purpose: Specify what tasks your agent should handle
  2. Configure Behavior: Set instructions and personality traits
  3. Add Integrations: Connect to external tools and services
  4. Set Triggers: Choose when and how the agent activates
  5. Test & Deploy: Validate functionality before going live

Getting Started

Prerequisites

  • Active mixus account
  • Appropriate permissions (Creator role or higher)
  • Understanding of your automation needs

Basic Agent Creation

  1. Navigate to Agents
    • Go to your mixus dashboard
    • Click “Agents” in the sidebar
    • Select “Create New Agent”
  2. Choose Agent Type
    • General Assistant: Handles various tasks and conversations
    • Specialized Worker: Focused on specific workflows
    • Integration Agent: Primarily interfaces with external services
    • Monitoring Agent: Watches for events and sends notifications
  3. Configure Basic Settings
    Agent Name: Customer Support Assistant
    Description: Handles customer inquiries and routes to appropriate teams
    Visibility: Organization-wide
    
  4. Define Instructions Write clear, specific instructions for your agent:
    You are a helpful customer support assistant for Acme Corp.
    
    Your responsibilities:
    - Answer common questions about our products and services
    - Escalate complex issues to human agents
    - Maintain a friendly, professional tone
    - Access our knowledge base for accurate information
    
    Always ask for clarification if a request is unclear.
    
  5. Add Integrations (Optional)
    • Select from available integrations
    • Configure authentication for external services
    • Set up data access permissions
  6. Set Activation Method
    • Manual: Triggered by team members
    • Scheduled: Runs at specific times
    • Event-based: Responds to webhooks or triggers
    • Always Active: Continuously monitors and responds
  7. Test Your Agent
    • Use the built-in testing interface
    • Send sample inputs and review responses
    • Verify integration connections work correctly
  8. Deploy
    • Review all settings
    • Click “Deploy Agent”
    • Monitor initial performance

Use Cases

Customer Support Agent

Purpose: Handle customer inquiries 24/7 Integrations: Help desk platform, team chat, email Triggers: New support tickets, email mentions

Content Creation Agent

Purpose: Generate marketing content and social media posts Integrations: Social media scheduler, professional networks, document storage Triggers: Scheduled weekly, manual activation

Data Analysis Agent

Purpose: Process and report on business metrics Integrations: Analytics platforms, CRM system, team chat Triggers: Daily at 9 AM, monthly reports

Meeting Coordinator Agent

Purpose: Schedule meetings and send reminders Integrations: Calendar platforms, scheduling tools, email Triggers: Calendar events, manual requests

Best Practices

Writing Effective Instructions

  • Be Specific: Define exact behaviors and responses
  • Set Boundaries: Clearly state what the agent should and shouldn’t do
  • Include Examples: Provide sample interactions
  • Define Escalation: Specify when to involve humans

Integration Management

  • Minimal Permissions: Only grant necessary access
  • Test Thoroughly: Verify all integrations before deployment
  • Monitor Usage: Track API calls and rate limits
  • Regular Updates: Keep authentication tokens current

Performance Optimization

  • Start Simple: Begin with basic functionality, add complexity gradually
  • Monitor Metrics: Track response times and success rates
  • Iterate Based on Feedback: Continuously improve instructions
  • Version Control: Keep track of configuration changes

Advanced Configuration

Custom Triggers

{
  "trigger_type": "webhook",
  "webhook_url": "https://api.mixus.ai/webhooks/agent123",
  "conditions": {
    "source": "crm_system",
    "event": "new_lead",
    "priority": "high"
  }
}

Integration Parameters

{
  "integrations": [
    {
      "type": "team_chat",
      "channels": ["#support", "#alerts"],
      "permissions": ["read", "write"]
    },
    {
      "type": "document_storage",
      "folders": ["/shared/support-docs"],
      "permissions": ["read"]
    }
  ]
}

Response Formatting

Response Format:
- Use bullet points for lists
- Include relevant links when helpful
- Bold important information
- Always end with "Is there anything else I can help you with?"

Troubleshooting

Common Issues

Problem: Agent not responding to triggers
Solution: Check trigger configuration and verify webhook endpoints are accessible
Problem: Integration authentication fails
Solution: Refresh authentication tokens and verify permissions
Problem: Responses are inconsistent
Solution: Review and refine agent instructions for clarity
Problem: Agent exceeds rate limits
Solution: Adjust trigger frequency or upgrade integration plan

Getting Help

If you encounter issues:
  1. Check the troubleshooting guide
  2. Review integration documentation
  3. Contact support@mixus.com with agent details

Next Steps


Need help creating your first agent? Contact our support team or check our community examples.