Discord

Use your agent inside of your Discord server

Linking your agent to Discord

Each Discord server can only have one active Superuser agent at any time. However, an agent may be linked to multiple Discord servers. If you have a need for more than one agent per server, please reach out to [email protected] with your use case.

To start using your agent on Discord, you first need to link your agent to a Discord server. This can be done at any time from the [Settings] tab.

Go to the Settings tab to link to Discord

From here you can scroll to the bottom of the pane and find the Link a new Discord server button.

Click Link a new Discord server

Click this link will bring you through the Discord app install flow. Follow the instructions: select your server and hit Continue.

Select your server and click Continue

You will be asked for a set of permissions. For the bot to work properly, it must have access to all required scopes. Click Authorize to proceed.

Click Authorize to proceed

Once authorized, you'll be brought back to your agent's chat page with the settings open. You should now see that your Discord server is linked.

The Discord server test-community is now linked

Note that you can link a single agent to multiple Discord servers, but each Discord server can only have one agent.

If your agent has been linked successfully, you should also see a success message in your #general channel — or the first channel on your channel list.

Welcome message in Discord

You can now chat with your agent at any time by mentioning it with @Instant. It should also be accessible via its nickname.

Chatting via Discord

To chat with your agent in Discord, just mention it using @Instant or its current nickname, which should match its name on your agent settings.

Now you can chat in Discord!

Chat input

While in beta, only text input to agents is currently supported. We're working to add multiple modalities and will keep you posted! Please send any feedback here to [email protected].

Chat output

Similar to On the web / Chat output, you can see thoughts, tool calls and attachments — however you will not be able to debug them.

Can execute multiple tools at once

Attachments are supported as well, and will be attached as images.

Image attachments will also display in Discord

Clearing chat history

To erase the conversation history between you and your agent within a single channel, just tag @Instant and append !forget, like so:

@Instant !forget

This will clear the conversation history with you in the current channel. To eliminate all history between you and the bot in a server, type:

@Instant !forgetme

This will eliminate all of your history with the bot in the current server.