Interface overview
This page has three main sections:
Sidebar
- Chat - The current active section (highlighted ) where you can edit your ontology
- Sources - View raw data connections
- Conversations - See your past questions and AstroBee’s responses
Left entity browser
- Version dropdown - Shows ontology version and timestamp
- Entity list - All business entities and relationships between them AstroBee has identified
Entity browser
Shows information about the selected entity in two tabs:
- Company Domain - String type identifying company website
- Industry Sample - The industry category (e.g. healthcare, e-commerce)
- Company Domain Normalized - Cleaned version of domain for matching created by AstroBee
- Contact via
company_domain_normalized(Many to One relationship) - Links show the join conditions between entities
Understanding your ontology
Entities
Each entity represents a core business concept that AstroBee has identified from your data:| Entity | Description |
|---|---|
| Company | Organization associated to contacts, product users, and billing based on website/domain |
| Contact | A person engaged via marketing/sales (lead, MQL, SQL, customer) from CRM |
| Product User | An application user with account activity and engagement metrics |
| Billing Account | The paying account profile used for invoicing and payments |
| Subscription | A recurring billing plan agreement status with MRR, currency, and start dates |
| Plan | The commercial tier (e.g., Starter, Growth, Enterprise) associated with users and subscriptions |
Properties
Properties describe each entity and come in different types:| Property Type | Description |
|---|---|
| Identifiers | Unique keys like shipment_id or carrier_name |
| Descriptive fields | Attributes like dates, names, descriptions |
| Calculated metrics | Derived values like averages or totals |
| Data types | String, Integer, Timestamp, etc. |
Relationships
Relationships show how entities connect to each other:| Relationship Type | Description |
|---|---|
| One to Many | One company has many billing accounts |
| Many to Many | Multiple relationships between entities |
Editing your ontology
To edit your ontology, simply type your requests in natural language. There are two types of editing: quick editing and deep editing (accessible via the dropdown in the chat input).
Quick edits
Quick edits are for fast, focused changes with minimal context required. Use these for simple changes to individual properties or relationships. These quick edits provide immediate feedback and take a few seconds at most without requiring deep thinking on the agent’s part - like renaming or deleting entities or other simple operations.Making requests
Describe what you want to change in plain English:- “Rename Total Shipments to Shipments”
- “Add customer satisfaction metrics”
- “Create a new entity for product categories”
Making business model requests
Detailed reasoning behind changes
- Renaming property - Explains the specific change being made
- Business rationale - Why the change improves clarity
- Impact analysis - How the change affects your model
Reviewing changes
After processing, you’ll see an update summary:
Ontology update summary
Detailed ontology changes view
- What changed - Specific modifications made to your ontology
- Generated entities - New business concepts AstroBee created
- Follow-up suggestions - Recommendations for further improvements
- Save or discard - Options to apply or reject the changes
Saving your changes
After reviewing the updates:
- Click “Save Model” to apply changes permanently
- “Discard Changes” to cancel and return to the previous version
- Success notification confirms your ontology has been updated
Deep edits
Deep edits use reasoning to research and synthesize multi-step edits. Switch to this mode via the dropdown for complex joins, creating new business entities, restructuring relationships, or when you need comprehensive analysis across multiple data sources. For example, you might type this exact query:Deep edits in action
- Complex entity creation - AstroBee successfully created a new “Customer” entity that consolidates data across multiple business domains
- Multi-table aggregation - Generated key measures like contact counts, user engagement metrics, billing account counts, and MRR calculations
- Intelligent relationships - Established proper connections between the new Customer entity and existing entities (Company, Contact, Product User, Billing Account)
- SQL view generation - Created sophisticated SQL that aggregates data from contacts, product usage, and billing systems
- Business logic integration - Applied normalization rules and assumptions for data consistency across domains
Rename ontology
You can rename your entire ontology to better reflect your business or project. Click the ellipsis () next to your ontology name, select ” Rename” and enter a new name like “Sass ontology” The change applies immediately and creates a new version, updating both the display name and system identifier to keep your ontologies organized as projects evolve.Delete ontology
To permanently delete an ontology, click the ellipsis () next to the ontology name and select ” Delete.” You’ll see a confirmation dialog warning that this action cannot be undone. Once deleted, the ontology is completely removed and you’ll be redirected to the model selection screen to choose or create a different ontology.Version management
Your ontology is versioned automatically:- Timestamps show when each version was created
- Version numbers increment with each change (v5, v6, etc.)
- Rollback capability lets you return to previous versions if needed
