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

# Omni Slack Agent

> Ask data questions directly in Slack and get AI-powered answers, charts, and tables from your Omni semantic model.

<Note>
  See [Scheduling Slack deliveries](/share/deliveries/slack) and the [Slack AI integration](/integrations/ai/slack) for more information about other ways to use Slack with Omni.
</Note>

The Omni Slack Agent lets your team ask data questions directly in Slack. Users can DM the agent or `@Omni` it in any channel to get AI-powered answers from your semantic model without leaving Slack.

<h2 id="setting-up-the-omni-slack-agent">
  Setting up the Omni Slack Agent
</h2>

### Requirements

To configure the Omni Slack Agent for your organization, you'll need:

* A Slack workspace
* **Organization Admin** permissions in Omni
* An Omni organization with [AI features enabled](/ai/settings/features)
* At least one [topic](/modeling/topics) configured in your model

### Connecting Omni to your Slack workspace

<Steps>
  <Step title="Connect your Slack workspace">
    1. In Omni, navigate to **Settings > Integrations**.
    2. Click **Connect to Slack** and complete the Slack authorization flow.

    You'll be redirected back to Omni once the connection is established. Admins will receive a welcome message in Slack confirming the integration is active.

    <Tip>
      **Already connected for deliveries?** If your Slack workspace is already connected for [scheduled deliveries](/share/deliveries/slack), you'll see an option to upgrade the connection with additional permissions required by the Omni Slack Agent. Click **Reconnect** to authorize the expanded permissions.
    </Tip>
  </Step>

  <Step title="Verify the agent and introduce it to your team">
    After connecting, the agent will send you a welcome message in Slack confirming the integration is active. To help your team discover the Omni Slack Agent, we recommend using the workflow in the welcome message that will allow the agent to introduce itself in a public channel. You can see a preview of the message in the welcome message.

    <Note>
      Introducing the Omni Slack Agent in a public channel is the best way to drive broad awareness and encourage your team to connect their accounts and start asking questions.
    </Note>
  </Step>
</Steps>

### Configuring agent settings

<Note>
  **Organization Admin** permissions are required to modify integration settings in Omni.
</Note>

In Omni, navigate to **Settings > Integrations** and open the **Slack** tab to manage your integration's settings:

#### Default model

Defines the default model the agent uses when [answering questions](#ask-questions). Users will still be able to use other models they have access to.

<h4 id="admin-privacy-setting">
  Channel response privacy
</h4>

Restricts the behavior of how the agent's responses are shared within Slack channels and group direct messages. The **Require private responses** setting controls the default:

* **Disabled** (default) — Responses post to channel threads, unless the prompting user has [private channel responses configured](#omni-privacy).
* **Enabled** — Users always receive a private response and can choose to share it with the thread.

### Disconnect the Slack integration

Disconnecting your Slack integration will cause the agent to ignore mentions in your workspace and delete all deliveries configured to send through Slack. Users will no longer be able to select Slack as a delivery destination.

## Connecting your Omni account

<Note>
  **This section applies to all users**, not only Slack admins. Every user who wants to interact with the Omni Slack Agent must connect their Omni account.
</Note>

Before you can ask questions, you'll need to link your Slack account to your Omni account:

<Steps>
  <Step noAnchor>
    Send a message to the Omni Slack Agent in a channel or DM by mentioning it with `@Omni`.
  </Step>

  <Step noAnchor>
    The agent will reply with a **Connect account** button.
  </Step>

  <Step noAnchor>
    Click the button and follow the prompts to link your Slack identity to your Omni account.
  </Step>
</Steps>

Once connected, you'll receive a confirmation message and a welcome message explaining what you can do with the Omni Slack Agent. The agent will also pick up your original question automatically.

<Tip>
  Use the [`/omni disconnect`](#omni-disconnect) slash command to disconnect your Slack account.
</Tip>

<h2 id="ask-questions">
  Asking questions
</h2>

You can interact with the Omni Slack Agent in three ways:

* **Direct message**: DM the Omni Slack Agent directly starting your request with `@Omni`.
* **`@mention` in a channel**: Type `@Omni` followed by your question in any channel.
* **Group DM**: To include the Omni Slack Agent in a DM with other people, you must start a new group DM with the agent as one of the participants — you cannot add it to an existing DM.

The agent responds with an answer that can include:

* **Text** — A written explanation or summary
* **Tables** — Tabular data rendered in Slack's Block Kit format
* **Open in Omni** link — Click to view the full result in Omni

<Tip>
  Response visibility depends on your organization's [privacy settings](#admin-privacy-setting), and [your own preferences](#omni-privacy) if user-controlled privacy is enabled.
</Tip>

### Follow-up questions

To ask a follow-up question, type `@Omni` followed by your question in the same Slack thread. The agent maintains conversation context within a thread, so you can refine results — add filters, change groupings, or drill into a metric.

### Providing response feedback

<Note>
  Reach out to Omni support to have this feature enabled.
</Note>

You can rate the quality of agent responses using the <Icon icon="thumbs-up" iconType="regular" /> and <Icon icon="thumbs-down" iconType="regular" /> buttons that appear on AI responses. Your feedback helps improve the accuracy and usefulness of future responses.

When you click the <Icon icon="thumbs-up" iconType="regular" /> button, a form opens where you can optionally share additional context about what worked well. You can also skip providing details and simply register the positive feedback.

When you click the <Icon icon="thumbs-down" iconType="regular" /> button, a form opens where you can select a category that describes the issue and optionally provide additional details. You can also skip providing details and simply register the negative feedback.

## Scoping responses

The Omni Slack Agent enforces the same permissions and model-level access controls as the rest of Omni. Each user's access in Slack mirrors their access in the Omni app — the agent can only query connections, models, topics, and fields that the user is already permitted to see, including any restrictions applied through [access grants](/modeling/develop/data-access-control), [user attributes](/administration/users/attributes), and [connection-level permissions](/administration/users/permissions).

The topics the Omni Slack Agent can use are controlled by the [`ai_chat_topics`](/modeling/models/ai-chat-topics) model parameter, which is also honored by the [Omni Agent](/ai/chat) and [embedded chat instances](/embed/customization/ai-chat).

## Using slash commands

The Omni Slack Agent supports slash commands as an alternative way to interact with the agent. All slash commands use the `/omni` prefix.

<h3 id="omni-omni-help">
  /omni or /omni help
</h3>

Shows a list of available commands. When you're connected to Omni, this displays the full command reference. If you're not yet connected, this shows a prompt to connect your account.

<h3 id="omni-ask">
  /omni ask \[question]
</h3>

Asks a question to the Omni Slack Agent. You can use this command in two ways:

* **With the `ask` keyword**: `/omni ask what was revenue last quarter?`
* **Without the `ask` keyword**: `/omni what was revenue last quarter?`

The agent posts your question to the channel or DM and responds in a thread, just like with `@mentions`. The response can include text, tables, and a link to open the full result in Omni.

<Note>
  If you use `/omni ask` while your account isn't connected, you'll see a prompt to connect. Unlike `@mentions`, the agent will not automatically resume your original question after you connect — you'll need to ask again.
</Note>

<h3 id="omni-model">
  /omni model
</h3>

Opens a menu to select your preferred Omni model. This is the model the agent will use when answering your questions.

* If your organization has multiple models, you'll see a dropdown to choose from
* If only one model is available, you'll see that model displayed
* If you don't have access to any models, you'll see a message asking you to contact your administrator

<h3 id="omni-privacy">
  /omni privacy
</h3>

Toggles whether your responses in channels are visible to everyone or only to you.

* If your administrator allows **user-level** privacy control, you'll see a checkbox to toggle private responses on or off
* If your administrator has enforced **workspace-level** privacy, you'll see a message indicating that privacy is managed by your administrator

<h3 id="omni-disconnect">
  /omni disconnect
</h3>

Disconnects your Slack account from your Omni account. You'll be asked to confirm before the disconnection is completed. After disconnecting, you'll need to reconnect to ask questions again.

## Next steps

* [Delivering content to Slack](/share/deliveries/slack) - Schedule automated dashboard deliveries to Slack channels
* [Omni Agent](/ai/chat) - Use the Omni Agent directly in the Omni app
* [Workbook Agent](/ai/queries) - Get AI help building queries in workbooks