Context Components · Semantic Layer

One number.
Every team, every agent.

A semantic layer defines the entities, dimensions, and measures behind your metrics. Atlan generates them from the BI logic and query history you already have, then gives every definition an owner, a version, and a test suite.

spinner
Meaning, made countable

A semantic model: three entities with primary keys joined by named N to 1 relationships, dimensions to slice by, and two measures defined once on top of them.

ENTITIES + RELATIONSHIPS
refundrefund_id PK● amount
↓ reverses · N:1
paymentpayment_id PK● amount
↓ settles · N:1
invoiceinvoice_id PK▪ billing_period▪ status
MEASURES — DEFINED ONCE, ON TOP OF THE ENTITIES ABOVE
refund_rateCOUNT(refund) ÷ COUNT(payment)from: payment, refund
lifetime_valueSUM(payment.amount) over the subscriber's tenurefrom: payment
▪ blue = dimension, slice by● green = feeds a measurePK / FK = keys
Change refund_rate in one place and it changes everywhere it is invoked. One owner. One version.
Entities, relationships, dimensions, and measures. Pinned down before anything computes.

Trusted by AI-forward enterprises

"Atlan captures Workday's shared language to be leveraged by AI via its MCP server. As part of Atlan's AI labs, we're co-building the semantic layer that AI needs."

Joe DosSantos

VP Enterprise Data & Analytics, Workday

"We're focused on how we can scale context development as much as possible, and where can we leverage Atlan AI to build the most robust definitions across our data estate and make sure we're propagating it upstream and downstream."

Takashi Ueki

Head of Enterprise Data & Analytics, Elastic

"With Atlan we cataloged over 18 million assets and 1,300+ glossary terms in our first year, so teams can trust and reuse context across the exchange."

Kiran Panja

Managing Director, Cloud & Data Engineering, CME Group

"AI initiatives require more context than ever. Atlan's metadata lakehouse is configurable, intuitive, and able to scale to hundreds of millions of assets."

Andrew Reiskind

Chief Data Officer, Mastercard

WTF IS THE CONTEXT LAYER

A bi-weekly live series for AI leaders and builders. One burning question per episode, an open AMA floor, and guests who've actually built context infrastructure.

EP 03Is Semantic Layer = Context Layer?Wed, Jul 15 · 11 AM ET

A semantic layer teaches agents business language and meaning. But is meaning enough to act? David Mariani (co-founder and CTO of AtScale) joins Austin Kronz on where semantic and context layers diverge, and whether they are two names for the same solution.

spinner
Is Semantic Layer = Context Layer?
THE AI CONTEXT GAP

One question.
Three kinds of context.

Knowledge is which number the question means. Expertise is how to aggregate it. Norms are whose definition is the authoritative one.

Knowledge

Which number is the metric?

avg_dt_secs, not the POS number. The week runs Monday to Sunday, store local time

Expertise

How is it aggregated?

Weighted by car count. A mean of means over-weights the quiet stores

Norms

Whose definition wins?

Operations owns avg_dt_secs at v4. Finance owns the POS metric. Changes need approval

CONTEXT COMPONENTS

No agent runs on
a semantic layer alone.

It defines what the numbers mean. Which table to compute them on, how one record relates to another, and what was decided last time come from somewhere else.

How are business metrics defined and measured?

Entities, relationships, dimensions, and measures over tabular data. A graph walks from one record to its neighbours. A semantic layer collapses millions of rows into a rate.

Explore Semantic Layer
semantic_models/refund_rate.yml
measure: refund_rate
  label: "Refund rate"
  expr: COUNT(refund) / COUNT(payment)
  filters:
    - status != 'reversed'   # 9 in 10 queries
    - NOT is_test_account
  entities: [payment, refund, invoice]
  dimensions:
    - region          # circles 1-4 + acquired
    - fiscal_quarter  # Apr 1 - Jun 30, local tz
  owner: finance-ops
  version: 4   # changes need approval
HOW IT WORKS

Your metrics are already defined, badly, in six places.
Atlan reads all six and reconciles them.

Definitions mined from what the business does, not from a blank spreadsheet.

Every metric you care about is already implemented somewhere: in a BI tool's semantic logic, in a dashboard's calculated field, in the SQL your analysts copy between queries. Atlan reads those implementations and proposes the governed version.

Scout
Ranks assets by usage intelligence — surfaces what your team queries most.
Stage 1 · Foundational
⚡ Purpose
Ranks assets by usage intelligence — surfaces what your team queries most.
Task Plan
Scan SQL query historyacross all teams and use cases
Identify top-queried assetsby team, frequency, and function
Rank by usage scoreand assign enrichment priority
Revenue Assets
Product Analytics
Customer Data
Revenue assets · ranked by usage
5 assets
finance.revenue_table
847 queriesGold Layer ↑
finance.arr_cohort
693 queries
billing.invoices
541 queries
finance.mrr_breakdown
418 queries
finance.ltv_by_segment
263 queries

The definition of a metric is production code. Atlan treats it that way.

A generated definition is a proposal. In Context Engineering Studio it gets tested against historical cases, reviewed by the person who actually owns the number, and versioned like any other production asset.

Context Studio/Repositories/finance-revenue
revenue.yml
synced to 4 agents
Last updated 2h ago · v3.1.2
name: "revenue"
domain: finance
version: 3.1.2
definition: "Net sales after returns, post-tax"
window: "Q4 — fiscal year close"  # updated by AI · approved by @jsmith
consumers:  # Cortex · LangGraph · Genie · Claude
framework: any # LangGraph, Cortex, Genie, or your own
Recent activity
AI drafted revenue.yml v3.1.2 — updated fiscal window definition
2h ago
@jsmith approved — no changes needed
2h ago
Pushed to 4 agents — all consuming v3.1.2 automatically
2h ago
Consuming this repo
Snowflake Cortex
LangGraph
Databricks Genie
Claude (MCP)
All on v3.1.2

One definition of refund rate, wherever the question gets asked.

A metric definition locked inside one BI tool serves the people who open that tool. Governed definitions have to reach every analytics agent, copilot, and notebook that will ever ask the question.

Cortex Analyst
Natural Language Query
Run
Powered by Snowflake Cortex
via Atlan MCP
Fetching context from Atlan MCP...
→ resolve_metadata · search_assets
MMetricCertified
revenue
Net sales after returns, post-tax
@jsmith
TTable
98/100
orders_fact
owner: Data Engineering
Primary transaction table
Generated SQLQuery ready
1SELECT
2 product_line,
3 SUM(net_sales) AS revenue -- metric defined by Atlan
4FROM orders_fact
5WHERE fiscal_quarter = 'Q4'
6GROUP BY product_line;

See the context layer, built live.

Watch Atlan engineers bootstrap, test, and deploy enterprise context on real data — from cold start to production-ready agents.

The Enterprise Context Layer Architecture in ActionWed, Aug 26 · 11 AM ET

The teams winning with AI are not the ones with the best models. They are the ones building context that compounds. Watch Atlan mine knowledge from your existing stack, build and certify a context layer through a development lifecycle, and deploy it to any agent platform.

spinner
Isabella Steains
Isabella SteainsStrategic Solutions Engineer

One definition of the number.
Every agent, every time.

[Website env: production]