Skip to main content

Add workspace instructions for Genie One chat

Workspace admins can add custom instructions that apply to every chat conversation in the workspace. Instructions can include information about your organization's data conventions, preferred terminology, or guidelines for how chat should respond.

To add workspace instructions:

  1. Create a Markdown file at this path in your workspace:

    Text
    /Workspace/.genie_workspace_instructions.md
  2. Share the file with all users. In the workspace browser, right-click the file, select Share, add the All account users group with CAN VIEW permission, and click Add. See File ACLs.

Chat reads the file with the permissions of the user who is chatting. Users who can't view the file don't get the instructions, and chat doesn't show an error. Changes to the file typically reach chat within 30 seconds.

Instructions must be under 20,000 characters. Instructions apply to chat only and do not affect Genie Agents or Genie Code.

Make workspace instructions user-aware​

Workspace instructions can customize chat behavior based on a user's group memberships. To make instructions user-aware:

  1. Add Load the user's info to get their group memberships to .genie_workspace_instructions.md. Databricks recommends adding this instruction before any group-specific behavior.
  2. Define the behavior for each relevant group.

The following example applies different business metrics for the Finance and Sales groups:

Markdown
# User-aware behavior

- Load the user's info to get their group memberships.
- If the user belongs to the Finance group, include gross margin and operating expenses in financial summaries.
- If the user belongs to the Sales group, include bookings and pipeline in performance summaries.

Group-specific instructions customize chat responses. They don't override Unity Catalog permissions.

Best practices for workspace instructions​

Consider the following guidelines when writing workspace instructions for Genie One:

  • Write clear, specific instructions: Be explicit and unambiguous when writing your instructions.
  • Keep instructions under 20,000 characters: Instruction files are limited to 20,000 characters. Genie One doesn't use any instructions past this limit. Be concise and prioritize important instructions.
  • Use headings and delimiters for structure: Instructions are in Markdown files. Use Markdown formatting to provide structure, bullet points to separate distinct instructions, and headings to group related instructions. For example, you might add a "Business terminology" heading with instructions for interpreting organization-specific terms.
  • Share the instructions file: Share .genie_workspace_instructions.md with the users whose Genie One experience you want the instructions to affect.
  • Provide context and references: Genie One uses available context, such as asset and table metadata. Include key details directly in the instructions and specify when chat should load other relevant information, such as a user's group memberships.