Skip to main content
Last updated on

Artifacts in Genie One

Beta

This feature is in Beta. To use it, a workspace admin must turn on Artifacts from the Previews page. See Manage Databricks previews.

Artifacts are slide decks and other custom visual pages that Genie One builds from your data and saves to your workspace. Ask Genie for an artifact in chat, refine it by editing it directly or by asking Genie for changes, then present it and share it with others. Anyone who views an artifact can use Ask Genie to ask questions about the data behind any chart or number. After a workspace admin turns on Artifacts, all Genie One users can use them, including users with consumer access.

To build and present a slide deck, see Slides in Genie One.

Artifacts are separate from documents. A Genie One document is a text document that you draft and edit in a canvas pane. An artifact is a visual page, such as a slide deck, that holds charts and a snapshot of the data behind them. Genie One artifacts are also unrelated to MLflow artifacts, which are files that MLflow logs with a model run.

Create an artifact​

To create an artifact:

  1. In a Genie One chat thread, ask Genie to create a slide deck or other visual page. Describe the content, the data to use, and the audience.

    prompt

    Tell Genie to do this for you:

    Using the samples.bakehouse sales data, create a one-page summary of the top five franchises by revenue, with a chart of sales by product for each franchise.

  2. When Genie One finishes building the artifact, it appears in the chat thread. Click the artifact to open it.

    A Genie One chat response that links to the artifact Genie built, with the artifact open next to the conversation.

  3. To revise the artifact, edit it yourself, or ask Genie for changes in the same thread.

    prompt

    Tell Genie to do this for you:

    Add a chart that shows daily sales for each of these franchises.

Genie One saves the artifact to your workspace and lists it in My stuff.

Find artifacts​

Artifacts appear in My stuff and Discover in Genie One, along with your other assets. Each artifact shows a type, such as Slides, based on what Genie built. To show only one type, use the type filter in My stuff or Discover.

View and edit an artifact​

An open artifact has three page modes. Slide decks open in Edit mode, and other artifacts open in View mode. To switch modes, use the Page mode control in the toolbar.

  • View: See and interact with the artifact the way a viewer does.
  • Edit: Change the artifact's content and layout. You need Can edit permission on the artifact.
  • Data: See which datasets each chart or element uses.

Edit an artifact​

You can edit any part of an artifact yourself, without asking Genie. In Edit mode, you can:

  • Select text in the artifact to change it.
  • Select an element to move it, resize it, or change its style properties.
  • Use the toolbar to Insert chart, Insert text box, or Insert image.

Edits save automatically. The toolbar shows Saving… while a change saves and Saved when it finishes.

Ask Genie about an artifact​

Use Ask Genie to ask a question about what's on screen. Select an element, such as a chart or a number, and ask about it. For example, select a chart and ask "Which product sold the most at this franchise?" Genie uses the selected element and the current view to answer.

Anyone who can view an artifact can use Ask Genie, so people you share it with can explore the data on their own. The answer appears in Genie One chat, where you can continue the conversation.

Data in artifacts​

Artifacts store a snapshot of the query results that Genie used to build them. The data in an artifact doesn't update when the source data changes.

The snapshot is part of the artifact. Anyone who can view the artifact can see its data, even if they don't have access to the source tables. Before you share an artifact, check that its recipients should see that data.

To see which data each chart or element uses, switch to Data mode and hover over the element. The Datasets tab in the left panel lists every dataset in the artifact.

Share an artifact​

Sharing a chat doesn't share the artifacts that Genie saved from it. To give users access to an artifact, share the artifact itself.

To share an artifact:

  1. Open the artifact.
  2. Click Share.
  3. Add the users or groups you want to share the artifact with.
  4. Select a permission level for each user or group:
    • Can read: View the artifact and use Ask Genie.
    • Can edit: View and edit the artifact, and use Ask Genie.
warning

Anyone who can view an artifact can see its snapshot data, even if they don't have access to the source tables.

Limitations​

  • Genie One stores each artifact as a set of files in your workspace: its pages, its data, and any images. Each file has a size limit:
    • Data: 5 MB. Genie can't save a larger query result to an artifact.
    • Pages and components: 5 MB.
    • Images: 10 MB.
  • When you print an artifact or save it as a PDF, all of its files together can be at most 50 MB.
  • Artifacts run in a sandbox without network access. They can't load external scripts, fonts, or images, and they can't write data back to tables or external systems.

Additional resources​

On this page