Skip to main content
An ontology is a typed model of your business, defined in one TypeScript project. It joins the data from your systems into objects, such as customers and invoices, and exposes reads and actions over them. Agents call those reads and actions as tools. People use them through spaces. Cedar policies in the same project decide who may do what. The ontology is part of Tilde Cloud.

How it relates to agents

An agent should not hold database credentials or call ten APIs to answer one question. With an ontology, the agent sees a small set of typed tools, such as customerOverview or creditCustomer, and each call is checked against your policies. The ontology between your data sources and its callers: agents, people, and spaces
Click to zoom
  • Agents get every read and action as a tool through the Tilde Ontology tool provider. See Give an agent the ontology.
  • People open spaces in Live, which call the same reads and actions.
  • Policies see both the person and the agent acting for them. An agent never does more than the person it serves.

The building blocks

A project at a glance

An ontology project is a Git repository:
ontology.ts brings the pieces together:
ontology/ontology.ts
Tilde installs @tilde/ontology for you when it builds the project. Every build error names the TypeScript file, line, and field it comes from.

Next steps

Build your first ontology

Create, deploy, and link an ontology to an agent in a few minutes.

Sources and models

Bring data in, and shape it with SQL.