Skip to main content
Community Hub
TL;DR

Describe your use case in Context Engineering Studio, approve the assets CES proposes, and review the semantic model it assembles. The repository references your Atlan assets instead of copying them.

Your AI can read this via Docs MCPInstall MCP →Connect

Create your context repository

Describe your use case in Context Engineering Studio (CES). CES searches your Atlan data graph, proposes a set of assets, and waits. Once you approve the selection, it assembles a semantic model from those assets.

The repository references your Atlan assets instead of copying them, so every definition traces back to its governed source in Atlan. CES builds the semantic model from those assets; when a source changes, regenerate the repository to pull the update.

Before you begin​

  • Context Engineering Studio is enabled on your workspace and your team has the CES persona. See Enable Context Engineering Studio.
  • You have a use case to start with: the specific job one agent has to do, such as answering pipeline questions for the sales ops team. Scope it to that job rather than to a team or a domain. A good first repository covers a single dashboard or a small set of closely related datasets.

Step 1: Describe your use case​

In Context Engineering Studio, describe the repository you want in the prompt box.

To start from a common starting point instead, pick one of the suggestions under Create a context repository for:

  • Sales metrics and revenue analysis
  • Marketing campaign performance
  • Customer health and support analysis
  • Financial reporting and budget analysis

The more specific your prompt, the better the result. A good prompt covers the questions the agent must answer, who asks them, and the tables to include or exclude.

Example 1, broad:

Create context for an agent that answers pipeline questions for sales ops.

Example 2, specific:

Create context for a finance analyst to answer revenue and budget questions
using the invoice, budget_actuals, and cost_center tables. Exclude
staging tables.

Step 2: Approve your asset selection​

The build stops here until you decide.

Two tabs show what CES chose:

  • Selected assets lists what goes into the repository. The Rationale column explains each choice and names the signals behind it, such as verification status, row count, column count, and owner.
  • Not selected lists the assets it considered and left out.

Then choose one:

  • View / refine selection to add or remove assets before the build starts.
  • Proceed with selection to build with what CES proposed.

Step 3: Review your repository​

The repository opens in the right pane with three tabs: Overview, Simulate, and Portability.

Overview has two cards:

  • Semantic model is the canonical definition for this use case. It lists your tables with their dimensions, time dimensions, and facts, plus the derived metrics built on top of them.
  • Linked assets lists every Atlan asset the repository is built from. Each one carries a Reference badge: the repository links to the asset in Atlan for provenance rather than storing a copy. Regenerate to pull the current state.

If the derived metrics count carries a not emitted badge, the model held some metrics back. See Metrics that aren't emitted for why, and where those metrics are still available.

Step 4: Update the context repository​

Keep a repository current through its linked assets, not by hand-editing the model.

To change what the repository covers, edit Linked assets (add or remove an asset, or bring in a new column), then click Regenerate. Regenerating pulls the current state of each linked asset from Atlan and rebuilds the model, keeping the custom instructions you've written.

For business rules that aren't in the data, such as which source to prefer or what a fiscal quarter means, edit Custom instructions on the Semantic model card. Regenerating preserves them.

To describe a change instead, use Ask AI or the chat window.

Step 5: Activate your repository​

A new repository starts in Draft. When the model looks right, activate it. CES offers Activate this repo (DRAFT → ACTIVE) as a follow-up, or you can ask for it in the chat window.

Active repositories appear under Explore context repositories on the Context Engineering Studio home page.

Next steps​