Skip to main content

Genie One admin guide

Admins control whether account-level Genie One is available, how Genie One looks, and who can read conversation data.

Admin tasks​

Use the following pages to set up and manage Genie One.

Topic

Description

Enable Genie One for users

Give workspace members the entitlements they need, choose between workspace-level and account-level Genie One, and turn off account-level Genie One or review how it handles data.

Account-only user access to Genie One

Learn what account-only users can do in Genie One and how account admins manage their access, data permissions, and compute.

What is consumer access?

Give business users the Consumer access entitlement so they can use workspace-level Genie One.

Add workspace instructions for Genie One chat

Add custom instructions that apply to every chat conversation in the workspace.

Connect Genie One to external applications with MCP

Control who can use each MCP connector and which of its tools are available.

Customize the Genie One homepage

Customize the Genie One homepage for all users in the workspace, including branding colors, a logo, a Markdown welcome message, and pinned content.

Administer the Genie mobile app

Configure and deploy the Databricks Genie mobile app, including network security, authentication, and MDM integration.

Topic

Description

Enable Genie One for users

Give workspace members the entitlements they need, choose between workspace-level and account-level Genie One, and turn off account-level Genie One or review how it handles data.

Account-only user access to Genie One

Learn what account-only users can do in Genie One and how account admins manage their access, data permissions, and compute.

What is consumer access?

Give business users the Consumer access entitlement so they can use workspace-level Genie One.

Add workspace instructions for Genie One chat

Add custom instructions that apply to every chat conversation in the workspace.

Connect Genie One to external applications with MCP

Control who can use each MCP connector and which of its tools are available.

Customize the Genie One homepage

Customize the Genie One homepage for all users in the workspace, including branding colors, a logo, a Markdown welcome message, and pinned content.

Administer the Genie mobile app

Configure and deploy the Databricks Genie mobile app, including network security, authentication, and MDM integration.

An account admin also sets up the sources for Genie Search and connects a people source for org directories.

Admin access to conversations​

If a workspace admin turns on Genie tracing, Genie One copies your prompts and responses, and tool call results such as query results, to the Unity Gateway unified trace table. The table's owner, and anyone given access to that table, can read them. Metastore admins can give themselves access. Deleting a conversation in Genie One doesn't delete its traces. See Monitor Genie Code and Genie One with the unified trace table.

Governance and permissions​

Genie One doesn't have a separate permission system for your data. It enforces the permissions you already manage in Unity Catalog, on workspace assets, and in connected external sources.

  • Data in Unity Catalog: When Genie One writes and runs SQL to answer your question, the query runs as you. Your Unity Catalog privileges, row filters, column masks, and catalog-workspace bindings apply the same way they do everywhere else in Databricks. See Row filters and column masks.
  • Workspace assets: Genie One only finds, cites, and opens dashboards, queries, Genie Agents, and Databricks apps that you have permission to access. Genie Agents always evaluate data access with your own Unity Catalog permissions. Dashboards and apps run queries with either the viewer's credentials or credentials that their authors configure. See Data governance.
  • Genie Ontology: Genie One only uses ontology context extracted from assets you have permission to see. See Genie Ontology.
  • External sources: MCP connections use your own OAuth credentials. Genie One sees only what you can see in each source application. Databricks governs these connections through Unity Catalog and Unity Gateway. Metastore admins and connection owners control who can use each connection, and the gateway authorizes each tool call and records usage in system tables. See Connect Genie One to external applications with MCP.