concepts
Glossary
The words this product uses, and what each one means precisely.
Source — a database Evalyst reaches through a native driver (Postgres, MySQL, Snowflake, BigQuery), attached to your workspace with read-only credentials. Not to be confused with a connector.
Connector — an agent-written module for an API or service that isn’t a SQL database. Validated in a sandbox. See connectors.
Semantic model — the versioned record of what your data means: metrics, exclusions, gotchas, join keys. Yours, not ours. See the semantic model.
Ground-truth question — a question with an answer a human confirmed. The unit the gate is built from.
Eval bank — the set of confirmed ground-truth questions for one source.
Silent error — an answer that is confident, plausible, and wrong, with nothing to signal it. The headline number in every run, and the one that must be zero.
Abstention — the agent declining to answer because the data can’t support a conclusion. Counted as a success, not a failure.
The gate — the rule that a change to a semantic model cannot go live unless the bank comes back with zero silent errors and at least 90% accuracy. See the eval gate.
Verified badge — the scorecard on a source: accuracy, silent-error count, bank size, last run. A measurement of that source’s own bank, not a claim about the product.
Read-only verified — the state of a source whose credentials were proven unable to write at attach time. A source where an admin accepted write-capable credentials instead keeps saying unverified, deliberately and permanently, until real reader credentials are supplied.
Widget — a saved chart or table pinned to a dashboard, backed by one of three things: a parameterized query against one source, a cross-source workflow, or a materialized rollup. Refreshing one re-runs that artifact with no model involved.
Workflow — a cross-source analysis: reduce at each source, then combine the small results in DuckDB. A workflow names as many extracts as the question needs, and an extract is either a query against an attached database or the rows a connector last pulled from an API — so one query can join two production databases and a billing API together.
Workspace — your organisation’s tenancy boundary. Every row carries it, and it is enforced both in the application and in the database.