Skip to main content
An entity is a named collection of rows — e.g. deals, contacts, products. A relationship links two entities — e.g., deals.owner_id → contacts.id.

​
How entities get created

  • HubSpot — each object type (deal, contact, company, ticket) becomes an entity automatically.
  • Uploaded files — the filename (minus extension) becomes the entity name. Rename in the Data Sources panel.
  • MCP servers — the server declares entities via its schema.

​
Relationships

Xura infers foreign-key-style links from column names + values. You can also declare them explicitly in the Knowledge Graph tab.

​
Why entities matter for planning

When you click Plan from description on a Flow, the planner sees the list of entity names + their fields. It uses those exact names in the generated query_data steps — no hallucination. Without governance + entity clarity, the planner falls back to generic names (“team_members”) that don’t exist in your data → runtime errors.