Documentation Get help

About the Ontology platform

The Ontology platform brings the records your business runs on into Flowstate, so agents and code can work on them. You choose which records come in, say in plain words what they mean, link them to the Work, People and Teams Flowstate already holds, and add actions that run when a record is created, changed or deleted.

It’s in Organisation → Modules → Ontology platform. If your organisation doesn’t have it yet, it shows locked in the sidebar, and its page says what it does and who to talk to, usually your Flowstate account manager.

An example we’ll use throughout

Say your sales team keeps deals in HubSpot and your delivery team plans Work in Flowstate. Today someone reads each new deal and works out which piece of Work it pays for.

With the Ontology platform you:

  1. Copy your HubSpot deals into Flowstate as a type called Deals.
  2. Write what a deal is, and what each of its properties means, the way you’d explain it to a new colleague.
  3. Add a link that reads “Deal pays for Work”.
  4. Add an action: when a deal is created or changed, an agent reads it, finds the Work it belongs to and links them. When two pieces of Work fit, it asks someone.
  5. Follow each run on the Runs tab and see what it cost on the Usage tab.

The same section also follows a people example: an added Bench status property on People, and a short code action that keeps it filled in.

The parts

The page has five tabs.

TabWhat it holdsGuide
TypesEach kind of record, its properties and its objects. Flowstate’s own types are there from the start.Types and properties
LinksHow objects of one type relate to objects of another.Link two types
ActionsWhat runs when an object is created, changed or deleted, and who or what runs it.Add an action
RunsEvery time an action ran: its steps, what it cost and any question it’s waiting on.Follow a run
UsageThis month’s AI spend, compute and runs, by action.Usage, billing and model rates

A few words you’ll see:

  • Type: one kind of record, like Work, People or HubSpot deals. Think of it as a table.
  • Object: one record of a type, like one deal. A row in the table.
  • Property: one thing every object of a type holds, like a deal’s amount. A column.
  • Link: a relationship between two types, like “Deal pays for Work”.
  • Action: something that runs on an object when it’s created, changed or deleted.
  • Run: one time an action ran, on one object.

If you’ve used other ontology tools, a type is what they call an object type, a link is a link type, and an action is close to an action type with an automation that starts it.

Set it up

  1. Connect an app and choose what to copy, or add documents to a file type. For deals and projects, a ready-made setup also links each one to its Work.
  2. Say what each type and property means. Agents read these words, so this step decides how well they work.
  3. Link your types to each other and to Work, People and Teams.
  4. Add an action, set its access and limits, and try it on one object.
  5. Switch it on and follow its runs.

Using the Ontology platform is billed: AI spend and compute are measured for every run. See Usage, billing and model rates.

Who can do what

Four permissions control the page. Administrators hold all four. See Who can do what.

What stays the same

  • Your apps are read, not changed. Flowstate copies records from a connected app and changes nothing there until you allow an action to. See Connect an app.
  • Flowstate’s own properties never change through an action. An action can change properties you’ve added, not built-in ones such as a person’s name or email.
  • Nothing outside reaches your data. An action can use only what its access allows: no internet, no other workspace.
  • AI models don’t train on your data. Data sent to AI models is covered by Flowstate’s enterprise agreements with the model providers, and isn’t used to train their models.