docs: improve Slack interface documentation#587
Merged
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refreshes the Slack documentation across the AgentOS interface docs, deploy guide, and usage examples, expanding coverage of Slack interface behavior and the SlackTools toolkit while adding new Slack usage pages and updating navigation.
Changes:
- Expanded
agent-os/interfaces/slack/introduction.mdxwith detailed parameters/behavior (streaming, sessions, files/media) and an updated SlackTools reference section. - Added multiple new Slack usage pages (streaming research, support team, workflow, multiple instances, channel summarizer) and updated existing Slack usage snippets/imports.
- Updated Slack docs navigation in
docs.jsonand refreshed the Slack deploy guide content.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| tools/toolkits/social/slack.mdx | Updates SlackTools overview, install instructions, and expands params/methods tables. |
| docs.json | Adds the new Slack usage pages to navigation. |
| deploy/interfaces/slack/overview.mdx | Cleans up Slack deploy guide; updates AgentOS import path; adjusts env var + ngrok instructions. |
| agent-os/interfaces/slack/introduction.mdx | Major rewrite: adds parameters, endpoints, behavior sections, SlackTools reference, troubleshooting table. |
| agent-os/usage/interfaces/slack/basic.mdx | Updates snippet filename/imports/model and usage instructions. |
| agent-os/usage/interfaces/slack/agent-with-user-memory.mdx | Updates snippet filename and improves wording/formatting in the example. |
| agent-os/usage/interfaces/slack/reasoning-agent.mdx | Updates snippet filename/imports/model and refines key-features section. |
| agent-os/usage/interfaces/slack/research-workflow.mdx | Updates AgentOS import path, env var formatting, and adds key-features section. |
| agent-os/usage/interfaces/slack/streaming.mdx | New page: streaming deep research example with task cards and suggested prompts. |
| agent-os/usage/interfaces/slack/support-team.mdx | New page: multi-agent support team example using SlackTools + web search. |
| agent-os/usage/interfaces/slack/channel-summarizer.mdx | New page: SlackTools-powered channel summarization example. |
| agent-os/usage/interfaces/slack/workflow.mdx | New page: two-step workflow example using WebSearchTools + SQLite sessions. |
| agent-os/usage/interfaces/slack/multiple-instances.mdx | New page: multiple Slack bots on one AgentOS with prefix-based routing. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Rewrite introduction.mdx with all 16 interface params, Behavior section (session management, streaming, file/media support), SlackTools section (17 params, 10 methods), troubleshooting table - Update SlackTools reference page with complete params and methods - Fix import paths to use `from agno.os.app import AgentOS` - Fix code block titles and run commands to use short filenames - Fix deploy guide: remove fluff, use uv pip, add session scope example - Add 5 new usage pages: streaming, support-team, channel-summarizer, workflow, multiple-instances - Update docs.json navigation with new pages
…agno[slack] install - Fix reasoning-agent: ThinkingTools→ReasoningTools (module was renamed) - Fix reasoning-agent: stock_price→enable_stock_price (correct param names) - Use "agno[slack]" extras in all install commands (slack-sdk is required by the interface, not just SlackTools) - Add lxml_html_clean to streaming deps (required by newspaper4k)
Rewrite introduction.mdx as a user-facing guide (not a spec sheet). Split reference content into a separate reference.mdx page. Rewrite deploy guide with correct OAuth scopes and comprehensive scope-to-feature mapping. Fix 9 existing usage pages (wrong model IDs, wrong imports, fabricated code). Create 5 new usage pages for cookbooks that had no documentation. Update SlackTools reference with method signatures and scope notes.
Mustafa-Esoofally
force-pushed
the
docs/slack-interface-improvements
branch
from
941d52e to
87931aa
Compare
The latest mintlify CLI depends on keytar which requires libsecret. Without it the broken-links check fails with ERR_DLOPEN_FAILED on ubuntu-latest runners.
kausmeows
previously approved these changes
Apr 3, 2026
- Remove quotes from frontmatter titles/descriptions across all pages - Replace DuckDuckGoTools with WebSearchTools in introduction examples - Add search_messages user token warning - Add search_workspace and get_channel_info to SlackTools reference (12 methods) - Add HTTP 500 to reference status table - Add channels:read to minimum OAuth scope (used by resolve_channel_name) - Add groups:read, search_workspace scopes to SlackTools scope table - Add SqliteDb to deploy guide example - Update MemoryManager model to OpenAIChat(gpt-4o-mini) - Add history params to reasoning-agent and workflow examples - Add channel_id context instructions to channel-summarizer - Remove duplicate research-workflow page (no cookbook exists) - Fix troubleshooting self-loop cause wording
kausmeows
approved these changes
Apr 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Complete rewrite of the Slack interface documentation. The previous version read like a technical spec. This version reads like docs.
What changed
Introduction page (rewritten from scratch)
New reference page (
reference.mdx)Deploy guide (rewritten)
app_mentionwhich isn't a scope; new:app_mentions:read)Usage pages (9 fixed + 5 new)
research-workflow.mdx: had completely fabricated code (gpt-5.2,HackerNewsTools, PostgreSQL). Replaced with actual cookbook contentagent-with-user-memory.mdx: wrong tools (HackerNewsTools→WebSearchTools), wrong model IDreasoning-agent.mdx: wrong tools (YFinanceTools→WebSearchTools), wrong import pathSlackTools reference (updated)
upload_file(channel, content, filename, title?, initial_comment?, thread_ts?))search:readscope note onenable_search_messagesNavigation (
docs.json)Type of change
Checklist