> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/mintlify/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the agent to Slack

> Use the agent in Slack to make documentation updates from conversations and capture team knowledge.

<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

<Steps>
  <Step title="Open the agent panel">
    Open the agent panel in your dashboard.
  </Step>

  <Step title="Click the Settings button">
    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/mintlify-docs/images/agent/dashboard-settings-light.png" alt="The settings button in light mode." className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/mintlify-docs/images/agent/dashboard-settings-dark.png" alt="The settings button in dark mode." className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Connect to Slack">
    In the Slack integration section, click **Connect**.
  </Step>

  <Step title="Add the app to your workspace">
    Follow the Slack prompts to add the `mintlify` app to your workspace.
  </Step>

  <Step title="Link your Mintlify account">
    Follow the Slack prompts to link your Mintlify account to your Slack workspace.
  </Step>

  <Step title="Test the connection">
    Test that the agent is working and responds when you:

    * Send a direct message to it.
    * Mention it with `@mintlify` in a channel.
  </Step>
</Steps>

## 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

<Card title="Best practices for using the agent in Slack">
  * **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.
</Card>