The Discord interface lets your agent respond to messages in Discord servers and direct messages.
Setup
- Create a bot at the Discord Developer Portal
- Enable the MESSAGE_CONTENT intent under Bot → Privileged Gateway Intents
- Copy the bot token from the Bot settings page
- Invite the bot to your server using the OAuth2 URL Generator (select
bot scope with Send Messages and Read Message History permissions)
Installation
pip install 'definable[discord]'
Quick Example
import asyncio
from definable.agents import Agent
from definable.interfaces import DiscordInterface, DiscordConfig
from definable.models import OpenAIChat
agent = Agent(
model=OpenAIChat(id="gpt-4o"),
instructions="You are a helpful Discord bot.",
)
discord = DiscordInterface(
agent=agent,
config=DiscordConfig(bot_token="your-bot-token"),
)
asyncio.run(discord.serve_forever())
DiscordConfig
Discord bot token from the Developer Portal.
Enable the MESSAGE_CONTENT privileged intent. Required to read message text.
Restrict the bot to specific server (guild) IDs. When None, responds in all servers.
Restrict the bot to specific channel IDs. When None, responds in all channels.
Whether to respond to messages from other bots.
When set, the bot only responds to messages starting with this prefix (e.g., "!").
Timeout in seconds for the initial connection to Discord.
Maximum message length. Discord’s limit is 2000 characters. Longer responses are automatically split into multiple messages.
Features
- Guild and DM support — responds in server channels and direct messages
- Attachments — receives text, image, and audio files from users
- Reply context — includes the replied-to message for context
- Auto message splitting — long responses are split at sentence boundaries
- Typing indicator — shows “typing…” while the agent processes
Access Control
Restrict which servers and channels the bot responds in:
config = DiscordConfig(
bot_token="your-bot-token",
allowed_guild_ids=[123456789, 987654321], # Only these servers
allowed_channel_ids=[111111111, 222222222], # Only these channels
)
from definable.agents import Agent
from definable.interfaces import DiscordInterface, DiscordConfig
from definable.memory import CognitiveMemory, SQLiteMemoryStore
from definable.models import OpenAIChat
from definable.tools import tool
@tool
def search_docs(query: str) -> str:
"""Search the documentation."""
return f"Found results for: {query}"
memory = CognitiveMemory(store=SQLiteMemoryStore(db_path="./discord_memory.db"))
agent = Agent(
model=OpenAIChat(id="gpt-4o"),
instructions="You are a documentation assistant.",
tools=[search_docs],
memory=memory,
)
discord = DiscordInterface(
agent=agent,
config=DiscordConfig(bot_token="your-bot-token"),
)
