Discord User Guide

Here's how to use the Rapidflare AI Agent via Discord.

Introduction

After enabling Discord, you will see an agent added to your Discord server. The agent responds to slash commands in channels where it has been installed.

What the Agent Can Do

The agent autonomously decides how to help based on your question:

• Search & Answer — Searches documentation, compatibility matrices, and the web to provide accurate answers. No manual routing is needed — the agent picks the best source automatically.
• Ask Clarifying Questions — If more context is needed, the agent presents interactive dropdown menus to narrow down the issue before answering.
• Escalate to Support — When the issue requires human intervention (e.g., credentials, account access, or platform bugs), the agent notifies the support team in a private channel. You will see "I've notified the support team" in the response.

Commands Overview

Slash Commands

There are four slash commands available:

1. /install command

Use the /install command to activate the agent in a specific channel. This is the first step after adding the agent to your server.

Usage: /install [reply_type]

This command requires Manage Channels permission. Once installed, users can use the /ask command in that channel.

Reply Type Options

The reply types offered depend on the channel you run /install in. Text channels and forum channels have different options, and the list updates automatically as you type.

Text channels

Forum channels

See Forum channels for how each forum mode behaves.

Public Response

The default behavior. The agent's response is visible to everyone in the channel.

Ephemeral Response

Only the user who asked the question can see the response. This is useful for channels where you want to keep conversations private or reduce clutter.

Thread Response

The agent automatically creates a new thread for each question. This helps organize conversations and keeps the main channel clean.

Once installed, you'll see a success message describing the mode you chose:

2. /uninstall command

Use the /uninstall command to deactivate the agent from the current channel.

Usage: /uninstall

This command also requires Manage Channels permission.

3. /ask command

Use the /ask command to ask questions to the Rapidflare AI Agent.

Usage: /ask <your question> [file]

You can optionally attach a file to your question — see Attaching files.

While the agent works, your question message updates in place with live progress, such as which sources it is searching. The agent then replies with the answer and its references.

4. /ask-private command

Use /ask-private to ask the agent privately. Only you see the answer, no matter which reply type the channel is installed with — including in channels set to Public.

Usage: /ask-private <your question> [file]

Your private conversation continues as long as you keep asking in the same channel, with a 15-minute idle window between questions. After 15 minutes of silence the next /ask-private starts fresh.

When you use it inside a thread or forum post that already has public /ask discussion, the agent picks up that public discussion as background so your private follow-up can refer to it without repeating context.

Forum channels

Forum channels let the agent answer new posts without anyone running a command. Which behavior you get depends on the reply type chosen at /install, and you can change it at any time by running /install again with a different reply type.

Post First Responder

The agent answers every new post automatically. It reads the post title and body, posts a short progress message while it works, then replaces it with the answer as the first reply in the post.

Use this for support forums where people expect an immediate first response.

Opt-In Post Reply

The agent does not answer immediately. Instead it greets the post author with two buttons:

If the author uses neither button, the agent waits — about 30 minutes by default — and then checks the post again. If the community has already answered it, the agent stays quiet and closes the offer. If the post is still unresolved, the agent posts an answer.

Only the post author can use these buttons. Anyone can still run /ask in the post at any time.

Use this for community forums where an instant bot reply would crowd out human answers.

Only when /ask-ed

The agent never posts on its own. It answers only when someone runs /ask or /ask-private inside a post. Use this when you want the agent available but strictly on demand.

Attaching files

You can attach one file to a /ask or /ask-private question, and the agent also reads files attached to a new forum post.

Anything else is skipped with a short note above the answer, and the rest of your question is still answered. Up to five files are read per question.

Follow-up questions

The agent remembers context inside threads and forum posts, so you can ask follow-ups without repeating yourself.

The agent also reads recent human discussion in the thread, so it can pick up details that were mentioned between questions rather than in the question itself.

Providing Feedback

After receiving a response, you'll see feedback buttons at the bottom of the message:

• 👍 Good - The response was helpful
• 👎 Bad - The response needs improvement

When you click a feedback button:

1. You'll be asked to select a tag describing your feedback (e.g., "Accurate", "Incomplete", "Irrelevant")
2. Optionally, you can provide additional comments via a popup modal

3. Your feedback is saved and helps us improve the AI Agent

Managing Installed Channels

You can view which channels have the agent installed from your admin dashboard:

• Navigate to Deployments → Discord → Installed Channels

Disabling Discord Integration

You can disable Discord integration using one of these methods:

Method 1: From Rapidflare Dashboard

1. Go to your admin dashboard's Deployments page
2. Click Disable on the Discord row

This will disconnect the agent from your server.

Method 2: From Discord

1. Go to your Discord server
2. Open Server Settings → Integrations
3. Find the Rapidflare agent (or your custom agent)
4. Click Remove Integration

Troubleshooting

Agent not responding to /ask

• Run /install in the channel first
• In a thread, make sure the parent channel is installed

Agent not appearing in server

• Check if OAuth authorization was completed

Slash commands missing right after inviting the agent

• Discord can take up to an hour to publish commands to every server. Wait and refresh Discord

/install command not working

• Ensure you have Manage Channels permission
• Voice, category, announcement, stage, and media channels are not supported — use a text or forum channel

"Server not connected" error

• Re-enable Discord from the dashboard

"You are sending queries too quickly"

• Questions are rate limited per person, per channel, and per server. Wait a minute and try again

Forum posts get no automatic reply

• Confirm the forum is installed with Post First Responder or Opt-In Post Reply — Only when /ask-ed never replies on its own
• Ensure MESSAGE CONTENT INTENT is enabled in Discord Developer Portal
• Make sure you clicked "Save Changes" after enabling the intent
• Run /install from inside a post in that forum, not from the forum channel itself

Opt-In Post Reply buttons do nothing

• Only the post author can use them. Everyone else should use /ask
• If the offer expired, ask directly with /ask

Agent replies to forum posts with only the title, or seems to ignore the body

• This is the classic sign that MESSAGE CONTENT INTENT is off. Go to the Discord Developer Portal
• Select your application → Bot → Privileged Gateway Intents
• Enable MESSAGE CONTENT INTENT
• Click "Save Changes" (this step is often missed!)

For additional support, contact us at support@rapidflare.ai.