# Slack

> Deploy your conversational agent to Slack to provide AI assistance in your team's messaging workspace. Users interact with agents through direct messages via the UiPath Autopilot plug-in.

## Overview

Deploy your conversational agent to Slack to provide AI assistance in your team's messaging workspace. Users interact with agents through direct messages via the UiPath Autopilot plug-in.

**Intended users:** End users who work primarily in Slack and need conversational agent access without leaving their messaging workspace.

## Feature availability

| Feature | Available |
|---------|:---------:|
| Start new chat | ✅ |
| Chat history | ✅ |
| Delete chat session | ❌ |
| Settings | ❌ |
| Starting prompts | ❌ |
| File uploads | ✅ |
| Citations | ✅ |
| HTML preview | ❌ |
| Copy response | ❌ |
| Feedback (thumbs) | ✅ |
| Debug dump | ❌ |

## Prerequisites

To make a conversational agent available in Slack:

### Admin setup
1. Add the [Autopilot App in Slack](https://cloud.uipath.com/pluginecosystem_/slack/install)
2. Select **Allow**. A prompt asks you to open the Autopilot app in Slack.
3. UiPath Autopilot is now installed in the selected workspace. All users in the workspace can access it.
4. Publish the conversational agent to your desired Orchestrator folder.
5. Ensure users have appropriate permissions to access the agent.

### User requirements
* Slack account with access to the UiPath Autopilot app
* Permissions to use the published agent

## Accessing the agent

1. Open the UiPath Autopilot Slack app from the Slack sidebar.
2. Select the **Home** tab and select **Sign in**
3. Follow the prompts to sign into your desired Automation Cloud Organization.
4. The app will log into your last used Tenant. Select **Configure Tenant** if you want to choose a different tenant.
5. Select your agent from the **Pick an agent from the list below:** list.
6. Select the **Chat** tab to begin sending messages directly to the agent.

![Slack agent selection](https://dev-assets.cms.uipath.com/assets/images/agents/slack-switch-agent-1c8d5681.webp)

:::note
Conversational agents in Slack only support direct messages through the UiPath Autopilot plug-in. Channel discussions and @mentions are not supported.
:::

## Chat features

The chat experience in Slack follows the Slack UX patterns. This section describes how each feature works within Slack.

### Starting a new chat

Select the **New Chat** button at the top of the Slack App to start a new chat session.

### Accessing chat history

Select the **History** tab to return to previous chat sessions via Slack threads.

### Citations

When an agent uses knowledge sources to generate a response, citations appear to show the origin of the information. Citation markers appear inline in the agent's response.

:::note
Citation preview opens the document in the default web browser.
:::

### Providing feedback

Help improve the agent by providing feedback on responses:

1. After an agent response, select **Thumbs up** or **Thumbs down**.
2. Optionally add a comment explaining your feedback.
3. Submit the feedback.

Feedback is collected to help improve the agent.

## Slack commands

Use prompts or slash commands to access available functionality:

| Command | Description |
|---------|-------------|
| /autopilot help | Get help on how to use the agent |
| /autopilot logout | Logout from Automation Cloud account |
| /autopilot change-tenant | Prompts you to select a new tenant |

## Limitations

The following features are not available in Slack:

| Feature | Notes |
|---------|-------|
| Delete chat session | Chat sessions cannot be deleted |
| Settings | Configuration of settings like profile information are not supported |
| Starting prompts | Not propagated to Slack interface |
| HTML preview | HTML content displays as raw text. Use Instance Management to preview HTML output. |
| Copy response | Responses must be highlighted and copied manually |
| Debug dump | Not available |

## Troubleshooting

### Agent not appearing in Slack

* Verify the agent is published to Orchestrator.
* Check that the UiPath Autopilot for Slack app is installed.
* Use **Pick an agent from the list below:** on the **Home** tab to see available agents.
* Ensure you are connected to the correct tenant.

### Conversation issues

If conversations fail to start or respond:

* Check the agent's connection status in Instance Management.
* Verify robot assignments in the solution folder.
* **Sign Out** on the **Home** tab and reconnect to refresh your session.

## Next steps

* [Instance Management](https://docs.uipath.com/agents/automation-cloud/latest/user-guide/conversational-agents-instance-management): Full feature reference and debugging
* [Autopilot for Slack](https://docs.uipath.com/autopilot/other/latest/overview/uipath-autopilot-for-slack): Complete Slack integration guide