Skip to main content

Answer business questions with Genie Ontology

A broad business question can belong to several dashboards or agents. Genie Ontology is the context layer that gives Genie One and Genie Code a business-aware map of your organization. It combines modeled knowledge that you define in Unity Catalog, such as metric views, domains, and Pages, with learned knowledge that Genie infers from your assets and usage. See Genie Ontology.

Use an ontology when a broad question could belong to several dashboards or agents. With an ontology, Genie One can reach the governed surface that fits a broad question without the user choosing one first.

Domain
-> optional Subdomain
-> Page
-> linked dashboard or Genie Agent

In this design, the domain and the optional subdomain group assets in the Discover page. Each Page defines a business concept and links to the dashboard or Genie Agent that answers questions about it.

note

Genie One answers from a Page's definition when a question uses a concept that the Page defines, and it cites the Page. Before you rely on an answer, check its citations, as the Organize assets with domains, subdomains, and Pages page shows.

The Bakehouse example design​

The Bakehouse example uses one direct page for an executive overview and one subdomain for deeper questions:

Domain: Bakehouse Sales Operations
├── Page: Franchise Performance at a Glance
│ └── Bakehouse Franchise Performance dashboard
└── Subdomain: Sales Analytics
└── Page: Sales Q&A Assistant
└── Bakehouse Sales Assistant Genie Agent

In this design, the dashboard Page describes overview, snapshot, and visual comparison questions. The Sales Q&A Assistant Page in the Sales Analytics subdomain describes questions about a ranking, a computed comparison, or a specific franchise. It links to the Genie Agent.

Both surfaces use starterjourney_catalog.bakehouse_gold.franchise_sales_metrics, so they share the Total Sales, Order Count, and Avg Order Value definitions. The surfaces don't guarantee identical results, because the dashboard can return cached results. See Keep dashboard data fresh.

Requirements​

You need the following before you start:

In this section​

Work through the pages in order. The metric view is the shared definition for the dashboard and the agent, and the domains page ties them together.

Page

What you do

Generate metadata with AI comments

Generate and review AI comments on your tables and columns so that Genie reads accurate descriptions

Define sales metrics as a metric view

Define franchise_sales_metrics as the shared measure definitions for dashboards and agents

Build and share the Franchise Performance dashboard

Build and publish the Bakehouse Franchise Performance dashboard on that metric view

Create the Bakehouse Sales Assistant

Create the Bakehouse Sales Assistant so that business users can ask questions in plain English

Organize assets with domains, subdomains, and Pages

A published domain, subdomain, and Pages, with citation checks in Genie One

Page

What you do

Generate metadata with AI comments

Generate and review AI comments on your tables and columns so that Genie reads accurate descriptions

Define sales metrics as a metric view

Define franchise_sales_metrics as the shared measure definitions for dashboards and agents

Build and share the Franchise Performance dashboard

Build and publish the Bakehouse Franchise Performance dashboard on that metric view

Create the Bakehouse Sales Assistant

Create the Bakehouse Sales Assistant so that business users can ask questions in plain English

Organize assets with domains, subdomains, and Pages

A published domain, subdomain, and Pages, with citation checks in Genie One

Next steps​