mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
33b0392e3b
* Add Notion MCP integration page for the agent Generated-By: mintlify-agent * 💅 * update image * copy edit * fix alt text --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
50 lines
2.7 KiB
Plaintext
50 lines
2.7 KiB
Plaintext
---
|
|
title: "Add the agent to Slack"
|
|
description: "Use the agent in Slack to make documentation updates from conversations and capture team knowledge."
|
|
keywords: ["Slack integration", "Slack bot", "team collaboration", "agent integration", "knowledge capture"]
|
|
---
|
|
|
|
<Note>
|
|
If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify app before you connect it.
|
|
</Note>
|
|
|
|
## Connect your Slack workspace
|
|
|
|
1. Go to the [Agent](https://dashboard.mintlify.com/products/agent) page in your dashboard.
|
|
2. In the "Agent settings" section, click **Install Slack app**.
|
|
<Frame>
|
|
<img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="block dark:hidden" />
|
|
<img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="hidden dark:block" />
|
|
</Frame>
|
|
3. Follow the Slack prompts to install the `mintlify` app in your workspace.
|
|
4. Follow the Slack prompts to link your Mintlify account to your Slack workspace.
|
|
5. Test that the agent is working and responds when you:
|
|
- Send a direct message to the agent.
|
|
- Mention the agent with `@mintlify` in a channel.
|
|
|
|
## Use the agent in Slack
|
|
|
|
Once connected, you can:
|
|
|
|
- Send direct messages to the agent to use it privately to update your documentation.
|
|
- Mention `@mintlify` in a channel to use it publicly and collaboratively.
|
|
- Attach files and images directly to your messages for the agent to process and include in your docs.
|
|
- Continue conversations in threads to iterate on changes.
|
|
- Share pull request links with the agent to update related documentation.
|
|
|
|
## Update documentation
|
|
|
|
Use the agent to update your documentation with a new request or in an existing thread.
|
|
|
|
- **New request**: Send a direct message to the agent or mention `@mintlify` in a channel with instructions on what to update.
|
|
- **Existing thread**: Reply in the thread and mention `@mintlify` with instructions on what to update.
|
|
- **With attachments**: Upload images, diagrams, code files, or other documents with your message. The agent automatically processes and includes them in your documentation.
|
|
|
|
The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates.
|
|
|
|
## Best practices
|
|
|
|
- **Be specific**: Tell the agent exactly what you want documented and where it should go.
|
|
- **Add context**: If a thread doesn't contain all the necessary information, include additional details in your message to the agent.
|
|
- **Review carefully**: You should always review pull requests that the agent creates before merging them.
|