Skip to content

docs: add Discord interface documentation#538

Open
uzaxirr wants to merge 1 commit intomainfrom
docs/discord-interface
Open

docs: add Discord interface documentation#538
uzaxirr wants to merge 1 commit intomainfrom
docs/discord-interface

Conversation

@uzaxirr
Copy link
Copy Markdown
Contributor

@uzaxirr uzaxirr commented Feb 19, 2026

Summary

  • Add full technical reference for the Discord interface at agent-os/interfaces/discord/introduction.mdx covering initialization parameters, dual transports (HTTP webhook + Gateway WebSocket), streaming mode, session ID scheme, media support, and troubleshooting
  • Update production/interfaces/discord.mdx with the correct Discord interface API (replaces outdated DiscordClient references), complete setup guide including slash command registration and webhook configuration
  • Update deploy/interfaces/discord/overview.mdx with quick start code and feature summary
  • Add Discord card to agent-os/interfaces/overview.mdx
  • Update Discord descriptions in deploy/interfaces.mdx and production/interfaces/overview.mdx
  • Add Discord to docs.json sidebar navigation

Type of change

  • New documentation
  • Documentation update (fixes outdated API references)

Checklist

  • Technical reference covers all parameters and features
  • Production setup guide includes all required steps
  • Navigation updated in docs.json
  • Overview pages updated with Discord cards
  • All code examples use the correct import paths

- Add technical reference at agent-os/interfaces/discord/introduction
  covering parameters, dual transports, streaming, session IDs, media
- Update production/interfaces/discord.mdx with correct Discord interface
  API (replaces outdated DiscordClient), full setup guide with slash
  command registration and webhook configuration
- Update deploy/interfaces/discord/overview.mdx with quick start and
  feature summary
- Add Discord card to agent-os/interfaces/overview.mdx
- Update Discord descriptions in deploy/interfaces.mdx and
  production/interfaces/overview.mdx
- Add Discord to docs.json sidebar navigation
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds and refreshes Discord interface documentation across AgentOS, Deploy, and Production docs, aligning examples with the newer AgentOS + Discord interface API and wiring the new reference page into navigation.

Changes:

  • Added a new technical reference page for the AgentOS Discord interface (agent-os/interfaces/discord/introduction.mdx).
  • Updated Production and Deploy Discord docs to replace outdated DiscordClient guidance with AgentOS + Discord setup and configuration.
  • Updated overview/cards and docs.json navigation to include the Discord interface docs.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
production/interfaces/overview.mdx Updates Discord card copy in the Production interfaces overview.
production/interfaces/discord.mdx Rewrites the Production setup guide and example code to use AgentOS + Discord, adds slash command + webhook setup details.
deploy/interfaces/discord/overview.mdx Replaces prior long-form page with a concise overview, feature list, and quick start snippet.
deploy/interfaces.mdx Updates Discord card copy in the Deploy interfaces overview.
agent-os/interfaces/overview.mdx Adds a Discord interface card and updates keywords.
agent-os/interfaces/discord/introduction.mdx New Discord interface technical reference (parameters, transports, streaming, sessions, media, troubleshooting).
docs.json Adds the Discord interface introduction page to the AgentOS sidebar navigation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +64 to +65
2. Click "Reset Token" to generate a new bot token
3. Copy and save this token securely — you won't be able to see it again
Copy link

Copilot AI Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the “Create a Bot User” step, the instructions go straight to “Reset Token” but don’t include creating the bot user first (the Developer Portal typically requires clicking “Add Bot” before a token exists). Add the missing “Add Bot” step (or clarify that a bot user must exist) to avoid readers getting stuck on a page with no token to reset.

Suggested change
2. Click "Reset Token" to generate a new bot token
3. Copy and save this token securely — you won't be able to see it again
2. Click "Add Bot" to create a bot user for your application, and confirm any prompts
3. Once the bot user exists, click "Reset Token" (or "View Token" / "Regenerate") to generate a new bot token
4. Copy and save this token securely — you won't be able to see it again

Copilot uses AI. Check for mistakes.
sidebarTitle: "Overview"
description: "Expose Agno agents through various communication protocols and platforms"
keywords: [interfaces, a2a, ag-ui, slack, whatsapp, protocols, integration]
keywords: [interfaces, a2a, ag-ui, slack, discord, whatsapp, telegram, protocols, integration]
Copy link

Copilot AI Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The keywords include telegram, but this page doesn’t mention Telegram and the “Available Interfaces” section doesn’t link to a Telegram interface. Consider removing telegram from keywords (or adding the corresponding Telegram interface card/link) so search/SEO metadata matches the actual content.

Suggested change
keywords: [interfaces, a2a, ag-ui, slack, discord, whatsapp, telegram, protocols, integration]
keywords: [interfaces, a2a, ag-ui, slack, discord, whatsapp, protocols, integration]

Copilot uses AI. Check for mistakes.
agents=[agent],
interfaces=[Discord(agent=agent, stream=True)],
)
app = agent_os.get_app()
Copy link

Copilot AI Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The “Quick Start” snippet builds app = agent_os.get_app() but doesn’t show how to actually run/serve it. Add a minimal if __name__ == "__main__": ... (or an explicit agent_os.serve(...) / uvicorn command) so the quick start is runnable like the other interface overviews.

Suggested change
app = agent_os.get_app()
app = agent_os.get_app()
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants