# Slack AI search

Connect Slack AI search so Risotto's agents can search public Slack channels live, without an index

Slack AI search lets Risotto search your Slack workspace in real time. You connect it on the **AI search** card of the Slack integration page. Risotto searches Slack at the moment a question is asked, so answers include the most current messages, not only indexed content. It needs no index. To have the agents answer from a channel's past threads through an index instead, see the Slack Channels source in [Indexes](https://www.tryrisotto.com/docs/dashboard/knowledge/indexes#available-knowledge-sources).

## Slack

Real-time search allows Risotto to look up information directly from the connected Slack workspace. Risotto searches on behalf of the Slack user who connects it.

> **Note:** Risotto can only search **public channels**. Private channels, direct
> messages, and group messages are never searched.

### Prerequisites

- **Role**: You are an Org Admin or Manager. Only they can open **Settings > Integrations**.
- **Slack app**: Risotto's Slack app is connected to your workspace (the **Chat app** card on the same page). See [Slack App Setup](https://www.tryrisotto.com/docs/guides/initial/slack-app). The **Searched channels** list reads your workspace's channels through it.
- **Custom Slack app**: If you use the custom Slack app, make sure you are on the latest manifest. If you are not, follow the [Update Slack App](https://www.tryrisotto.com/docs/guides/update-slack-app) guide first.
- **Slack plan**: Your Slack plan must support AI search.

### Connect Slack

1. **Open Slack's integration page**

   Go to **Settings > Integrations** and click the **Slack** card. On the **Connections** tab, find the **AI search** card ("Search public Slack channels on behalf of the connected user.").

   From **Knowledge**, you can also click **Slack search off** on the right of the tabs: it opens the same page.

2. **Click Connect**

   On the **AI search** card, click **Connect**. If your organization has not set up a custom Slack app, a menu opens: click **Marketplace app**, or **Custom app...** to create your own app from a Risotto manifest (see [Custom Slack app](https://www.tryrisotto.com/docs/guides/initial/slack-app-custom)).

   *Product example: Slack's page in the Risotto dashboard, with the AI search card's Connect menu open on Marketplace app.*

3. **Allow access in Slack**

   You are redirected to Slack's **Allow the "Risotto" app to access Slack** screen. Use the **Workspace** dropdown to pick the same workspace your Bot is connected to. The **Review app permissions** panel lists the information Risotto can view: content and info about you, content and info about channels & conversations, and content and info about your workspace. Click **Allow** to grant Risotto permission to search your workspace.

4. **Check the connection**

   Back on Slack's page, the **AI search** card shows **Connected**, the connected **Workspace**, whether **AI Search** is **Enabled**, the **Searched channels**, and when and by whom it was installed.

   If **AI Search** shows **Disabled**, an **AI search unavailable** warning appears under the card: make sure your Slack workspace is on a plan that supports AI search. When it is **Enabled**, a link under the card lets you test real-time search in the [Playground](https://www.tryrisotto.com/docs/dashboard/knowledge/playground).

### Configuration

By default, Risotto searches all public channels. To control where it searches, you can either:

- **Exclude specific channels** from search, or
- **Restrict search to specific channels** only.

These options are mutually exclusive: choose one approach or the other.

> **Note:** Regardless of the configuration, only public channels are ever searched.

The **Searched channels** row of the **AI search** card shows the current filter, for example "All channels", "Only #it-help, #eng +2 more", or "All except #random". To change it:

1. **Open the channel filter**

   Click the **Searched channels** row.

2. **Choose the mode**

   Click **Search only these** or **Search all except these**.

3. **Select the channels**

   Check the channels in the list. Use **Search channels...** to find a channel, or **Clear** to clear the selection.

4. **Click Save**

   Click **Save**. With no channel selected, the button reads **Search all channels**. Risotto shows **Updated Slack channel filter**.

   *Product example: The connected AI search card on Slack's page, with the Searched channels list open on Search only these, and Save.*

   If you close the list without saving, your changes are dropped.

### Status on the Knowledge page

On the right of the **Knowledge** page's tabs, Risotto shows whether the agents use Slack AI search:

| Status                       | Meaning                                                                  |
| ---------------------------- | ------------------------------------------------------------------------ |
| **Slack search on**          | When they answer, the agents also search public Slack channels live.     |
| **Slack search unavailable** | Slack is connected, but the workspace's plan does not support AI search. |
| **Slack search off**         | AI search is not connected.                                              |

Everyone sees **Slack search on**. Only Org Admins and Managers see the other two statuses, and for them the status links to Slack's integration page.

### Disconnect Slack AI search

On the **AI search** card, click **Connected**, then **Disconnect...**. In the **Disconnect from Slack search?** dialog, click **Disconnect**. Risotto stops searching Slack messages on behalf of the connected user. You can reconnect at any time.

Source: https://www.tryrisotto.com/docs/dashboard/knowledge/connect
