OspraiOsprai Docs

Knowledge Graph

Visualise relationships between equipment, systems, and spaces.

The Knowledge Graph automatically extracts entities and relationships from your documents, building a connected map of your project's equipment, systems, and spaces.

What gets extracted

Entity typeExamples
EquipmentAHU-01, Panel A3, QSC amplifier, ETC Source Four
SpacesRoom 204, Zone A, Level 3, Main Ballroom
SystemsHVAC distribution, audio zoning, lighting control
SpecificationsLoad ratings, cable types, power requirements

Relationships are extracted too: "installed in", "connected to", "supplies", "controls", "specified in".

How it works

When you upload a document, Osprai automatically extracts entities and relationships using AI. These are stored in a graph database and linked back to the source documents.

Background processing

Entity extraction runs in the background after document upload. Your document is searchable immediately. The knowledge graph builds over the next few minutes.

Using the graph

  1. Navigate to Knowledge Graph in the sidebar
  2. Browse entities or search for a specific item
  3. Click an entity to see its relationships and source documents
  4. Follow relationships to understand how equipment connects across your project

Querying the graph in Chat

You don't need to visit the graph page to use it. The AI automatically queries the knowledge graph when your question involves relationships:

"What equipment is connected to Panel A3?"
"Which rooms have speakers installed?"
"What does the signal path look like from the mixer to the main PA?"

The AI combines graph traversal with document search for comprehensive answers.

Tips

  • Upload multiple related documents. The graph becomes more useful as it connects information across documents (e.g., a spec + a drawing + an equipment schedule)
  • Use equipment tags. Questions with specific identifiers (AHU-01, Panel A3) get precise graph matches
  • Check relationships. If the AI says equipment A is connected to equipment B, click the citation to verify in the source document

On this page