Docs

AI Chatbot

Intelligent AI-powered conversations

Overview

Enable AI-powered conversations in your server. The AI can answer questions, provide information, and engage with your members naturally.

Setup

01

Navigate to **Dashboard → Your Server → AI → AI Overview**

Navigate to **Dashboard → Your Server → AI → AI Overview**

02

Enable the AI Chatbot module

Enable the AI Chatbot module

03

Select channels where AI can respond

Select channels where AI can respond

04

Customize the AI's personality and behavior

Customize the AI's personality and behavior

05

Add custom knowledge base (optional)

Add custom knowledge base (optional)

06

Save settings

Save settings

Auto-Moderation

The AI chatbot can automatically issue warnings or timeouts when users violate server rules during conversations.

How It Works

When enabled, the AI analyzes conversations and can automatically take moderation actions when it detects rule violations. The AI uses special markers in its responses to trigger actions:

[ACTION:warn]Issues a warning
[ACTION:timeout:30m]Timeout for 30 minutes
[ACTION:timeout:1h]Timeout for 1 hour
[ACTION:timeout:4h]Timeout for 4 hours

These markers are automatically removed from the message before it's sent to users.

Configuration

01

**Enable Auto-Moderation:** Toggle the "Auto Moderation" checkbox in the chatbot settings

**Enable Auto-Moderation:** Toggle the "Auto Moderation" checkbox in the chatbot settings

02

**Select Moderation Channels:** Choose specific channels where moderation actions are allowed (leave empty to allow in all active channels)

**Select Moderation Channels:** Choose specific channels where moderation actions are allowed (leave empty to allow in all active channels)

03

**Set Exempt Roles:** Add staff or moderator roles that should never receive moderation actions

**Set Exempt Roles:** Add staff or moderator roles that should never receive moderation actions

04

**Configure System Prompt:** Add your server's specific moderation rules to the custom system prompt

**Configure System Prompt:** Add your server's specific moderation rules to the custom system prompt

Best Practices

1. Add Clear Server Rules

Add your server rules to the Knowledge Base so the AI knows what constitutes a violation. Be specific about what is and isn't allowed.

2. Customize System Prompt

When using a custom system prompt, include your moderation guidelines. The AI will automatically receive moderation instructions, but you can add server-specific rules.

Code
Example: "No harassment, hate speech, or personal attacks. No spam or excessive emojis. No NSFW content in general channels."

3. Exempt Staff Roles

Always add your staff/moderator roles to the exempt list to prevent false positives. Users with the "Moderate Members" permission are automatically exempt.

4. Use Moderation Channels

Limit moderation to specific channels (e.g., #general, #chat) rather than all channels. This prevents moderation in channels like #announcements or #rules.

5. Start Conservative

Begin with warnings only. Monitor the moderation cases and adjust your system prompt based on results. Escalate to timeouts only for repeat offenders.

When Moderation Actions Are Used

  • Toxic/harassing language
  • Personal attacks
  • Spam (repeated messages)
  • NSFW content in wrong channels
  • Severe rule violations
  • Repeated violations after warnings

Example System Prompt

Here's an example of how to configure your custom system prompt for optimal moderation:

Code
You are the official AI assistant for THIS Discord server.

SERVER MODERATION RULES:
- No harassment, hate speech, or personal attacks
- No spam (repeated messages, excessive emojis, etc.)
- No NSFW content in non-NSFW channels
- No advertising without permission
- Respect all members and follow server guidelines

When violations occur:
- Use [ACTION:warn] for first-time violations or minor issues
- Use [ACTION:timeout:30m] for repeated violations
- Use [ACTION:timeout:1h] for severe violations
- Always explain why the action is being taken

⚠️ Important Notes

⚠️ Important Notes

  • Moderation actions are logged to moderation cases and can be viewed in the dashboard
  • Users receive DM notifications when actions are taken (if enabled in server settings)
  • All moderation actions are reversible by staff members
  • The AI will not moderate server owners or users with exempt roles
  • Monitor moderation cases regularly to ensure fair and consistent enforcement
  • Adjust your system prompt if you notice too many false positives or missed violations

Was this page helpful?