Glossary
The terms used across Curltale AI, in plain words.
| Term | Meaning |
|---|---|
| Agent | Any program or assistant that reads from Curltale AI through the MCP endpoint with a token. |
| Alfred | The assistant built into the app. It uses the same tools and rules as external agents, under the signed-in user's access. |
| Agent access | A per-field setting: full, masked (a stable hash for callers without the class) or none. |
| Archived version | An earlier published version of the model. Its content is kept; its search index is not. |
| Bridge | The link from a topic to the model entities it is about. Stored in the topic's collection, never in the model. |
| Calculated field | A value computed from the data, not a column. Its SQL is context for agents and is never run by the app. |
| Check (model) | A data-quality rule in words, optionally with SQL that counts violations (the result must be 0). The Model check runs it. |
| Chunk | A piece of text that is indexed for search: a passage of a document, a section of a topic, or a part of the model. Chunks are how the system finds things; pages are what it returns. |
| Claim | One atomic fact on a topic, with its exact quote, the source, the source wiki version and the passage it comes from. Claims are superseded, never deleted. |
| Collection | The unit of isolation in the library. Documents, topics, links and vocabulary belong to exactly one collection. |
| Connector | A saved connection to a database. One connector is active at a time. |
| Draft | The editable copy of the model. At most one draft exists. |
| Editor (role) | A library role. With a write or manage grant on a collection, it allows adding, editing and approving documents. Admins always have it. |
| Entitlement | A per-credential switch: confidential, personal, restricted, data. |
| Entity | A business thing in the model: a customer, an order, a contract. |
| Fan-out | A join that multiplies rows (for example through a shared parent), which makes sums wrong. Join planning warns about it. |
| Filter (model) | A named condition such as open order = closed_at IS NULL, with synonyms. Agents receive it pre-filled instead of guessing. |
| Four-eyes rule | An optional setting: whoever changed a draft cannot publish it. |
| Grant | Permission on a collection: read, write or manage, for a user or a token. |
| Held change | A change that contradicts a published fact, or looks like a duplicate. It is written but not published until a person decides. |
| Interview | A conversation in which a model asks an expert questions and turns the facts into a document. |
| MCP | The Model Context Protocol: the standard through which agents call tools. Curltale AI's endpoint is /mcp. |
| Model check | A report that runs the published model against the database in use: structure, relationships, data-quality rules and examples. |
| Ontology | The governed description of your data: entities, fields, relationships, filters, checks and examples. |
| Published version | The one version of the model that agents, search and Alfred read. |
| Query example | A worked query with its SQL and parameters, used as a pattern for agents and run by the Model check. |
| Relationship (model) | How two entities connect: the join, the cardinality and how far the link can be trusted (confirmed, optional, unreliable). |
| Relationship (topics) | A typed link between two topics (governs, depends on, part of, replaces). |
| Review queue | What waits for a person in a collection: contradictions, duplicates, doubted pages, suggested links, unreadable documents, vocabulary proposals. |
| Sensitivity | The class of a field: internal, confidential, personal or restricted. |
| Source | One document in a collection: an uploaded file, a captured web page or an interview. |
| Source wiki | A standalone, factual page a model writes from a source and a second model checks claim by claim. Every version is kept. |
| Surgical rewrite | Revising a topic after a source was removed: only what nothing else supports is withdrawn. |
| Token | A bearer credential for an agent. It carries entitlements for the model and data, and read grants on collections. |
| Topic | A page by subject, written from the verified source wikis of one or many sources, citing them and backed by claims. |
| Usage tag | public (may be shared with customers) or internal (for the agent's own understanding). Guidance returned with every result, not an access rule. |
| Vocabulary | The topic types and relation types a collection uses. |