Skip to main content
Context is in early access. Early access features are pre-production software under section 1.4 of the Cloud Services Agreement and are not for production use. To join the program, request early access.
An AI model knows your data sources by their table and column names. It does not know that your team calls the total_sales column “revenue,” or which of three customer tables is the one that finance trusts. Context fills that gap. It gives AI models business terms, dataset definitions, and column mappings, so that they can translate a question into an accurate query.

Why Context Matters

Context improves three things:
  • Accuracy: the model maps your business language to the right columns and datasets.
  • Speed: replies come back faster.
  • Cost: the model uses fewer tokens to find the data that it needs.

Kinds of Context

Connect AI has two kinds of context: global context, which describes your data, and user context, which describes you. The following table compares them. Connect AI doesn’t rank one kind of context above the other. Both go to the model together, and the model decides how to use them. Put shared definitions and business rules in global context, and personal details, such as your role, the filters you usually apply, and how you want answers, in user context.

What Global Context Contains

Global context forms a graph of the following entity types:
  • Global Context: terms and rules that apply to every connection and dataset.
  • Connection: context for one data source, which applies to all of its datasets.
  • Dataset: field-level details for one table or query.
  • Metric: a reusable measure on one or more fields.
  • Glossary: business terms and rules, optionally linked to columns. For example, a glossary entry can map Revenue to the total_sales column.

How Models Get Context

How context reaches the model depends on how the model connects to Connect AI.

Where Context Comes From

You can add global context in the following ways:
  • Import an existing semantic model: a dbt semantic layer, a Snowflake semantic view, or a Power BI file.
  • Generate context with AI.
  • Write context in the built-in editor, starting from a template.
Context is built from metadata, such as dbt manifests, Power BI definitions, and joins. When you generate context with AI, you can also include sample values from your tables to improve accuracy. Sample values are sent to the LLM. You can turn them off for the whole account by turning off Include Sample Values in Settings > Security. Sample values are not available on accounts with a HIPAA Business Associate Agreement. Changes to global context take effect as soon as you save them. There is no approval step. Approving generated context keeps it from being overwritten when someone generates or imports context again.

Performance

A search_context call typically takes 1.5 to 2 seconds.

Early Access

Context is available through the early access program, which accepts a limited number of participants. To apply, request early access. CData replies within two business days, reviews each request, and then turns on Context for your account.

Next Steps

Context Editor

Add, import, and review global context.

User Context

Tell the model about yourself.
Last modified on November 19, 2026