Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Genie Agent sharing using OpenSharing is in Beta.
Use OpenSharing to share a Genie Agent with users outside your organization. When you share a Genie Agent, Azure Databricks creates a point-in-time snapshot of the agent's data assets and instructions and makes it available to your selected recipients. Recipients can mount the share to create a local Genie Agent pre-loaded with your data and instructions. See Mount a shared Genie Agent.
Requirements
To share a Genie Agent, you must have the following:
- The Genie Agent Sharing preview enabled at the account level. See Manage Azure Databricks previews.
- Set up OpenSharing for your account.
CREATE SHAREprivilege on the Unity Catalog metastore where the Genie Agent's data is registered.CAN EDITor higher on the Genie Agent. See Access control lists.SELECTon all data assets in the agent. You must retain this privilege. If you lose it, recipients cannot access the shared data.- At least one recipient. See Create data recipients for OpenSharing (Databricks-to-Databricks sharing).
Share a Genie Agent
In your Azure Databricks workspace, go to the Genie Agent you want to share.
In the upper-right corner, click Share, then click the External tab.
In the Select recipients to share with field, search for and select the recipients with whom you want to share the agent.
If no recipients exist yet, click Create new recipient. See Create data recipients for OpenSharing (Databricks-to-Databricks sharing).
Click Share.
Azure Databricks exports a snapshot of the Genie Agent, creates a share containing all of the agent's tables, instructions, curated SQL examples, SQL functions, and other configuration, and grants the selected recipients access. The snapshot is captured at the time you click Share.
Add more recipients
After the initial share is created, you can share the same snapshot with additional recipients:
- Go to the Genie Agent and in the upper-right corner, click Share, then click the External tab.
- Search for and select the additional recipients with whom you want to share the agent, then click Add recipients.
You cannot modify the data assets in the share after you create it.
View and manage the share
The share appears in the Shared by me list. The share's asset list is read-only. You can manage recipients and delete the share, but you cannot add or remove data assets manually. See Manage shares for OpenSharing.
Limitations
- Snapshot only: The share captures the Genie Agent at the time you click Share and does not update when you change the agent. All recipients see the same snapshot.
- Size limit: The Genie Agent configuration must be less than 256 KB when compressed. Agents that exceed this limit return an error when you attempt to share them. To reduce the size, shorten instructions or descriptions, then try again.
- Metric views: Genie Agents that include metric views cannot be shared.