Databricks Genie app in Microsoft Teams

Important

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Azure 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

Azure 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 Azure Databricks previews.
  • An account admin must enable the Azure Databricks Microsoft Teams App preview in the account console.
  • If your workspace uses an IP access list, add the outbound IPs of the Azure 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

If your organization restricts custom app uploads, a Microsoft Teams admin must deploy the Databricks Genie app in Microsoft Teams through the Teams admin center.

  1. Sign in to the Teams admin center.

  2. Go to Teams apps > Manage apps.

  3. Click Upload new app and upload the Databricks Genie app in Microsoft Teams package.

  4. Click Add.

  5. In App permission policies, enable the Databricks Genie app in Microsoft Teams for your users. Optionally, use App setup policies to pre-install the Databricks Genie app in Microsoft Teams so users find it in Teams automatically.

  6. Grant multi-tenant admin consent (one time per customer tenant). Ask the customer tenant admin to visit the following link. Replace {CUSTOMER_TENANT_ID} with your Azure tenant ID:

    https://login.microsoftonline.com/{CUSTOMER_TENANT_ID}/adminconsent?client_id=942706fa-fc89-406c-9843-47a008bca503

    If the link fails, the admin can grant consent manually:

    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.

For more information, see the Microsoft Teams documentation.

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

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 Azure 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.
  • 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
Team Azure Databricks workspace admin configures from account console Security settings using Message visibility in collaboration platforms All channels in the team 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. Azure Databricks automatically selects a SQL warehouse that the user is authorized to access.
  • The following features are not supported:
    • Visualizing charts
    • Passing feedback (thumbs up or thumbs down)
    • Sending Azure Databricks notifications to Teams
    • Triggering actions in Azure Databricks from Teams
    • Connecting to GitHub and Glean as data sources through chat

Additional resources

  • Last updated on