Industry Ontology Schema
Contents
Plate data
- Spec
- Super Brain
- Part
- 02 of 03
- Declarations
- 10
- Version
- 1.0
Why an ontology
A vector database is not industry knowledge.
Loading an industry's documents into a retrieval index gives a model access to text. It does not give it the structure the industry actually runs on.
An ontology models that structure directly. What things exist, how they relate, what events change them, what rules constrain them, and what decisions the industry makes about them.
The test is simple. Can the system traverse from a territory to a brand to a prescriber to a compliance rule without guessing? If yes, there is an ontology. If no, there is a search index.
The ten declarations
What an industry declares about itself.
- ENTITY
- A thing the industry recognises. A brand, an asset, a patient, a batch, a loan.
- RELATIONSHIP
- How entities connect, and in which direction.
- EVENT
- Something that happens and changes state.
- METRIC
- A measure the industry agrees on, with its definition attached.
- RULE
- A constraint. Regulatory, contractual, or internal policy.
- WORKFLOW
- A sequence the industry runs, with its steps and owners.
- DECISION
- A choice the industry repeatedly makes, and what it is made from.
- ACTION
- Something that can be done to an entity, in a named system.
- ROLE
- A human position, with its scope and authority.
- AGENT
- A specialist bound to roles, decisions and actions.
Entity and relationship
Identity, attributes, and where a thing is mastered.
Entities carry identity, attributes, and the systems where they are mastered. Relationships carry direction and cardinality.
ENTITY brand
mastered_in: veeva, sap
attributes: molecule, indication, therapy_area, market
RELATIONSHIP brand -> prescribed_by -> hcp
cardinality: many_to_many
evidenced_by: rx_dataEvent, metric, rule
What changes, what is measured, what constrains.
Events change entity state. Metrics are defined once, centrally, so two agents cannot disagree about what a number means. Rules are enforced, not advisory.
EVENT prescription_written
changes: hcp.rx_behaviour, brand.volume
source: rx_data
METRIC territory_growth
definition: (current_period - prior_period) / prior_period
grain: territory, brand, month
RULE off_label_promotion
type: regulatory
enforcement: block
applies_to: recommend, executeWorkflow, decision, action
What the business does, chooses, and changes.
Workflows describe what the business already does. Decisions describe what it repeatedly chooses. Actions describe what can be changed, and where.
WORKFLOW cycle_planning
steps: segment, target, allocate, approve, publish
owner: commercial_ops
DECISION hcp_prioritisation
made_from: rx_behaviour, territory_growth, brand_plan
made_by: field_manager
cadence: per_cycle
ACTION crm_task_create
system: veeva
write_path: declared
reversible: yesRole and agent
An agent can never exceed the authority of the role it serves.
Roles come from the organisation, not from the software. Agents are bound to roles, so an agent can never exceed the authority of the position it serves.
ROLE field_manager
scope: territory
authority: call_plan, task_assignment
AGENT commercial_excellence
serves: field_manager, commercial_ops
decisions: hcp_prioritisation
actions: crm_task_createRules for writing one
Five that save the most time.
- Model what the industry argues about
- If two people in the sector would disagree on a definition, it belongs in the ontology.
- Master every entity somewhere
- An entity with no system of record is a guess.
- Define metrics once
- Duplicate definitions are the most common cause of agents contradicting each other.
- Make rules enforceable
- A rule with no enforcement type is a comment.
- Keep company specifics out
- Company brands, territories and policies belong in the Company Pack, not the industry ontology.
Read next
Where to go from here.
Plate data
- Spec
- Super Brain
- Part
- 02 of 03
- Declarations
- 10
- Version
- 1.0
Read next.
- Agent Manifest
- Part 03 of 03. How an agent binds to these declarations.
- The Super Brain spec
- Part 01 of 03. The required services.
- Packs
- Where an ontology ships, and what else travels with it.
- IndustryOS Hub
- Published ontologies to read before writing one.
One architecture. Twenty pages. Same document.
Modelling your industry? Start with the ontology.
Most of the work in an Industry OS is here. We are happy to review a draft.
A conversation, not a demo script. We ask what your systems of record are, what they cannot answer, and which decisions actually matter. If an Industry OS is not the right answer for you, we will say so.