Databricks Genie app in Microsoft Teams

Beta

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.

The Databricks Genie app in Microsoft Teams brings Genie into Microsoft Teams so users can ask data questions and get answers without leaving the Microsoft Teams workspace. Users can chat with the app in a direct message or mention @Databricks Genie in a Microsoft Teams channel or group chat. Channel owners can pin a specific Genie Space to a channel for consistent, use-case-specific answers. Otherwise, questions route through Genie.

The Databricks Genie app in Microsoft Teams uses the same model providers and trust and safety guarantees as Genie. See Hosting provider used when partner-powered AI features setting is enabled and disabled and Databricks AI assistive features trust and safety.

This page describes how to download, set up, and use the Databricks Genie app in Microsoft Teams.

important

Databricks AI agents may generate inaccurate responses. Verify before acting on agent output.

Prerequisites

Before installing the Databricks Genie app in Microsoft Teams:

• A workspace admin must enable the New chat experience in Genie preview in workspace previews. To turn on a preview, see Manage Databricks previews.
• An account admin must enable the Databricks Microsoft Teams App preview in the account console.
• If your workspace uses an IP access list, add the outbound IPs of the Databricks control plane in the East US 2 region. See the Outbound IPs in the Azure Databricks documentation.
• If you are installing using a custom app, download the Microsoft Teams app using the following link. Microsoft Teams app.

Install the Databricks Genie app in Microsoft Teams

Installation depends on whether your organization allows individual users to upload custom apps to Microsoft Teams.

Admin deployment

A Microsoft 365 admin installs the Databricks Genie app in Microsoft Teams from the Microsoft marketplace:

1. In the Microsoft marketplace, search for and find Databricks Genie.
2. Install the app.
3. Approve the app permissions when prompted during installation.

The admin can grant consent manually after installation, if needed:

1. Go to Microsoft Entra portal > Enterprise apps.
2. Search for the Databricks Genie app in Microsoft Teams.
3. Click Permissions > Grant admin consent on the User.ReadBasic.All permission.

After installation, users can start using the app.

Individual install

If your organization allows individual users to upload custom apps, do the following to upload the Databricks Genie app in Microsoft Teams:

1. In Microsoft Teams, click Apps > Manage your apps.
2. Click Upload an app. See Prerequisites to download the custom app.
3. Click Upload a custom app.
4. Select the Databricks Genie app in Microsoft Teams package.
5. Click Add.
6. Click Open to use the Databricks Genie app in Microsoft Teams in personal scope (1:1 chat), or select a channel or team and click Go to add it to a channel.

For more information, see the Microsoft Teams documentation.

Use the Databricks Genie app in Microsoft Teams

You can use the Databricks Genie app in Microsoft Teams through direct messages or in channel conversations on your Microsoft Teams workspace, or from Microsoft 365 Copilot.

Direct message

To directly message the Databricks Genie app in Microsoft Teams:

1. In Microsoft Teams, click Apps in the left sidebar and open the Databricks Genie app in Microsoft Teams.
2. Enter your question. If you are not signed in, the Databricks Genie app in Microsoft Teams prompts you to sign in.
3. Your question is routed to the most appropriate Genie Space and returns an answer with sources and suggested follow-up prompts.

To configure the workspace and Genie Space scope for all subsequent direct message conversations, open the Databricks Genie app in Microsoft Teams home page and adjust the settings.

Channel conversation

You can add the Databricks Genie app in Microsoft Teams to a channel. Using config, channel owners can configure settings for all members of a channel and individual users can configure personal settings. Channel owner configurations override personal configurations.

To configure the Databricks Genie app in Microsoft Teams in a channel:

1. In the desired channel, type @Databricks Genie.

2. If prompted, add the Databricks Genie app in Microsoft Teams to the channel.

3. Type config.

4. Select the connected workspace, the message visibility, and the Genie Space scope (a specific space or Chat in Genie).

   If no Genie Space is configured, the channel defaults to Chat in Genie.

5. After configuration, all @Databricks Genie mentions in the channel route to the configured agent and workspace.

Configuration levels and overrides

Run config in a channel to open the configuration window. The following settings are configurable:

• Workspace Selection: The Databricks workspace the Databricks Genie app in Microsoft Teams connects to for answering questions.
• Message visibility: Whether @Databricks Genie responses in channels are visible to all channel members or only to the user who asked. By default, responses are public. If a workspace admin sets message visibility to private, the workspace supports only direct messages, not channels or group chats.
• Genie Space scope: A specific Genie Space or all Genie Spaces. Pin a single space for consistent, use-case-specific answers.

Message visibility settings can be set at three levels. Higher levels override lower levels:

Level	How to set it	Applies to	Precedence
Workspace	Databricks workspace admin configures from workspace security settings using the Allow connection to collaboration platforms and Allow public messages in collaboration platforms fields. If Allow public messages in collaboration platforms is off, channel and group messages do not work and only direct messages are supported.	All channels in the Microsoft Teams workspace	Highest — overrides channel and personal configurations
Channel	Channel owner sends config in the channel and selects Save as channel-wide setting	All members in that channel	Overrides personal configurations
Personal	Individual user sends config in the channel	That user's own @Databricks Genie mentions in the channel	Used when no channel-wide configuration is set

Limitations

• You cannot specify which compute (SQL warehouse) the Databricks Genie app in Microsoft Teams uses. Databricks automatically selects a SQL warehouse that the user is authorized to access.
• The following features are not supported:
  • Visualizing charts
  • Sending Databricks notifications to Teams
  • Triggering actions in Databricks from Teams

Additional resources

• Use Genie One
• Chat in Genie One
• Use Genie One
• For support, see the Databricks help center.