> ## Documentation Index
> Fetch the complete documentation index at: https://docs.textql.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Your Ontology, End to End

> A hands-on workshop on turning the context your organization already has — databases, documents, spreadsheets, diagrams, transcripts — into a governed, queryable ontology with A…

A hands-on workshop on turning the context your organization already has — databases, documents, spreadsheets, diagrams, transcripts — into a **governed, queryable ontology** with Ana, and keeping it current as new information arrives.

It runs as short, hands-on modules: a goal, copy-paste prompts, what you'll see, and a checkpoint before moving on.

## Two ways to build — do either, or both

<CardGroup cols={2}>
  <Card title="From a connected database">Point Ana at a data source: discover the schema, draft the docs, define governed metrics, reconcile conflicts. Modules 2–5.</Card>
  <Card title="From a pile of documents">Start from the messy reality most teams have — SOPs, metric docs, diagrams, transcripts — and watch it become one coherent model. Modules 6–8.</Card>
  <Card title="The before/after baseline">Ask the same hard question cold and warm — the clearest proof of what the ontology buys you. Module 1.</Card>
  <Card title="Role-based access">One governed ontology, many teams — each with its own scope and voice. Module 9.</Card>
</CardGroup>

## How to use this workshop

* Read **Module 0** for the concepts — what an ontology is here, and the method.
* Run the **baseline** (Module 1). You'll come back to it at the end of each track.
* Pick your track: **A** if you have a connected database, **B** if you're starting from documents. Doing both is the full picture.
* Every step has a **Prompt** block — copy, paste into Ana, adapt anything in `[brackets]`.

<Note>
  **Example data** — The example prompts target the workshop's demo datasets (see the [Datasets & Document Sources](/workshops/build-your-ontology/reference) reference) and the example scenario in the companion repo, [TextQLLabs/ontology-workshop-guide](https://github.com/TextQLLabs/ontology-workshop-guide) (access is granted by the TextQL team — ask your TextQL contact if you can't open it). Swap in your own data sources and documents to run it for real.
</Note>

<Accordion title="For facilitators — running this as a guided session">
  **T-minus-1-day pre-flight:** run the workshop's key prompts end-to-end in the session workspace — confirm logins, connectors, and the features this workshop touches are enabled for every attendee; have a fallback demo workspace ready in case a customer connector fails live. **Pacing:** when a long prompt is running (2–4 min), fire it first, then discuss the concept while Ana works — never watch a spinner in silence. If behind schedule, cut sections marked optional, never the checkpoints. **Group sessions:** attendees drive, you narrate; collect every miss or wrong answer in a shared doc — that list is the ontology backlog. With 10+ attendees on one warehouse, stagger the heavy prompts.
</Accordion>

<Note>
  **🤖 Prefer to have Ana run this workshop?** Open a thread with your data connected and paste the prompt below — Ana walks you through it on your own data, one step at a time. You run each prompt; she coaches. *(Air-gapped / VPC tenants where Ana can't reach the web: download [`ana-runner.md`](https://github.com/TextQLLabs/workshops/blob/main/build-your-ontology/ana-runner.md) and paste its module list instead.)*
</Note>

```text Run with Ana theme={null}
Hey Ana — facilitate the "Build Your Ontology" workshop with me in this thread, on the data connected here. Pull the steps from https://textqllabs.github.io/workshops/build-your-ontology/ and run it interactively: look at my data first (2–3 lines), then go ONE module at a time. For each module, give ME the prompt to copy and run as my next message, tell me what to look for, then wait and coach me on my result. Start with what you see, then Module 0.
```

[**▶ Open in Ana — prompt loaded**](https://app.textql.com/chat/new?prefill=Hey%20Ana%20%E2%80%94%20facilitate%20the%20%22Build%20Your%20Ontology%22%20workshop%20with%20me%20in%20this%20thread%2C%20on%20the%20data%20connected%20here.%20Pull%20the%20steps%20from%20https%3A//textqllabs.github.io/workshops/build-your-ontology/%20and%20run%20it%20interactively%3A%20look%20at%20my%20data%20first%20%282%E2%80%933%20lines%29%2C%20then%20go%20ONE%20module%20at%20a%20time.%20For%20each%20module%2C%20give%20ME%20the%20prompt%20to%20copy%20and%20run%20as%20my%20next%20message%2C%20tell%20me%20what%20to%20look%20for%2C%20then%20wait%20and%20coach%20me%20on%20my%20result.%20Start%20with%20what%20you%20see%2C%20then%20Module%200.)

Ana fetches the steps from the link — no copy/paste of the workshop needed. (Air-gapped / VPC tenants where Ana can't reach the web: paste the module list from this workshop's [ana-runner.md](https://github.com/TextQLLabs/workshops/blob/main/build-your-ontology/ana-runner.md) instead.)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.