Docs › Administration
The app, page by page
Every page of the app and what it does.
The top bar has the search box (type to find entities, fields, query examples, collections, documents and topics, or to jump to any page; Ctrl+K puts the cursor there; results open in place and follow your own access), a theme toggle (light or dark, remembered in the browser; the system theme until you choose), your account chip (click to change your password) and sign out. ✦ Ask Alfred floats at the bottom right. The side menu has four groups and a small tab on its edge that folds it to icons.
Ontology pages#
| Page | What it shows and does |
|---|
| Entities | Every entity grouped by domain, with a filter. Modellers create entities here (New entity) when a draft exists. A small Ontology version selector at the top right switches between the published version and the draft (the choice is remembered in the browser). |
| Entity page | Tabs: Fields, Calculated, Filters, Checks, Relationships, Examples, Example questions, plus Related documents (topics from the collections you can read that are about this entity). Every field shows meaning, type, role, sensitivity, agent access, allowed values and review status. In a draft, modellers edit everything in place. |
| Graph | The entity graph (solid = confirmed, amber = optional, red = unreliable). Tick Show the topics of my document collections to overlay them. Drag to pan, scroll to zoom. |
| Join paths | Pick two entities: the preferred path with each join and its reliability, the all-confirmed alternative, approximate paths through a shared parent (fan-out) and their cost. |
| Query examples | All query examples, filterable; modellers add and edit them in a draft; Try on data runs one. |
| Changes & versions | The draft (label, edits, what it is based on), Start a draft, Validate, Publish (with progress), Discard; all versions; the difference between the draft and the published version; the audit log; the Excel card (blank template, export, upload, backups). |
Knowledge (the Library; can be turned off in Settings > Library)#
| Page | What it shows and does |
|---|
| Collections | Your collections as cards (name, usage tag, your level, counts), with Settings, Export and Delete for managers, and the access table (who has read, write or manage, users and tokens). Admins see collections they hold nothing on and can grant themselves access, which is logged. |
| Sources | Upload files (drop them or browse), Add a web page, search inside the collection, and the list of sources with status and progress. A source opens to its page: the written, checked version of the document, its versions and checks, and the original download. |
| Topics | The collection's topics with type and filter; a topic page shows the article with citation chips, an evidence panel (every statement with its quote, source, place and original passage), aliases, related topics, links to the data model, version history, and Merge into another topic. |
| Graph | The topics of one collection and their links (colour = type), optionally with the model entities they are about. |
| Review | The collection's queue: what waits for a person to decide. The sidebar badge counts it. |
| Interview | Capture an expert's knowledge by conversation; see Interviews. |
| Vocabulary | The collection's kinds of topic and relation, what the analyzer proposed, and the manager's tools to add, edit, merge and delete. |
| Health | A check without any AI model: what needs attention in the collection. |
Data#
| Page | What it shows and does |
|---|
| Browse | Which database is in use (the demo database or a connector), its tables with row counts, grouped by schema. On the demo database, admins build or rebuild it here (scale, seed, AI step). |
| Table view | Rows of one table, paged (50 per page), sortable, with filters per column. Hover a header for the column's meaning. Keys open the related row. |
| Row view | One row with every field's business name, plus every table that points at it, with how many rows do. |
| SQL console | One read-only statement at a time (Ctrl+Enter runs), under your entitlements, up to CONSOLE_MAX_ROWS rows (or the connector's lower limit). |
| Model check | The model against the data, grouped, with filters per status. See Checking the model. |
Everything on these pages follows your entitlements: masked columns show hashes, restricted columns are hidden unless granted.
Admin#
| Page | Who | What it shows and does |
|---|
| Users & access (non-admins see Connect agents) | everyone sees the MCP details; the rest is admins | Tabs: Tokens & MCP (endpoint, connection command, tokens with their entitlements) and Users (roles and entitlements). |
| Activity | admins | Every Alfred conversation and agent session, step by step, summaries per tool and per model, and Library jobs. |
| Settings | admins | Tabs: General, AI, Ontology & data, Library, Web capture, Storage, Limits, Connectors and Maintenance (search index, questions nobody could answer, empty the ontology). A search box finds a setting across all tabs, and each row shows whether its value comes from the page, .env or the default. |
