Graphs Reference
Complete reference for knowledge graph features, statuses, and options.
Graphs Reference
This page documents all graph-related UI elements, status values, and system behavior.
Graph statuses
| Status | Meaning |
|---|---|
| Queued | Job enqueued, waiting for a worker to start processing |
| Processing | Graph is actively being built |
| Completed | Graph was successfully created or updated |
| Failed | A fatal error occurred; the operation could not complete |
| Extraction Incomplete | Partial progress was saved; the graph can be resumed |
Status transitions
Queued→Processing— Worker picks up the jobProcessing→Completed— All batches processed successfullyProcessing→Failed— Fatal error during processingProcessing→Extraction Incomplete— Job interrupted but progress was staged
Cancelled operations result in either Completed (if the graph has data) or Failed (if the graph was empty).
Graph detail tabs
Overview
Displays summary statistics:
| Field | Description |
|---|---|
| Entity count | Total entities in the graph, broken down by type |
| Relationship count | Total relationships, broken down by type |
| Document count | Number of source documents |
| Top connected entities | Entities with the most relationships (network hubs) |
| Processing metadata | Model used, tokens consumed, timestamps |
For processing graphs, shows real-time progress: chunks processed, entities extracted, current stage.
Source Data
Table of documents included in the graph:
| Column | Description |
|---|---|
| Document | Filename with link to document viewer |
| Entities | Count of entities extracted from this document |
| Relationships | Count of relationships from this document |
| Actions | Remove document from graph |
Removing a document triggers a graph update that removes its entities and relationships.
Entities
Paginated table of all entities:
| Column | Description |
|---|---|
| Name | Entity label |
| Type | Entity type (Person, Organization, Location, etc.) |
| Properties | Key-value attributes extracted from documents |
| Sources | Documents and chunks where the entity was mentioned |
| Actions | View details, select for merge |
Click an entity row to open the detail dialog showing full properties and source attributions.
Relationships
Paginated table of all relationships:
| Column | Description |
|---|---|
| Source | Source entity name |
| Relationship | Relationship type (works_for, located_in, etc.) |
| Target | Target entity name |
| Properties | Relationship attributes (dates, amounts, etc.) |
| Sources | Documents and chunks where the relationship was found |
Schema
Displays the extraction schema used for this graph:
- Entity types being extracted
- Relationship types being identified
- Property definitions for each type
User-defined schemas are on the roadmap. Currently, graphs use a default schema.
Activity
Processing history and events:
- When the graph was created
- Update operations and their status
- Errors encountered during processing
Create graph dialog
| Field | Required | Description |
|---|---|---|
| Graph Name | Yes | Unique identifier for the graph |
| Select Documents | No | Individual documents to include |
| Select Folders | No | Folders whose documents will be included |
At least one document or folder must be selected. Processing documents are filtered out and cannot be added.
Update graph dialog
| Field | Required | Description |
|---|---|---|
| Add Documents | No | Additional documents to add (existing ones are disabled) |
| Add Folders | No | Folders to add (duplicate documents are skipped) |
| Additional Metadata Filters | No | JSON object for advanced document selection |
When selecting folders that overlap with existing graph content, a confirmation dialog shows how many documents will be added versus skipped.
Merge entities dialog
| Field | Description |
|---|---|
| Entities to merge | List of selected entities |
| Merged entity label | The canonical name for the combined entity |
If selected entities have different types, a warning is shown. The merged entity uses the type of the entity whose label is chosen as canonical.
Other labels become aliases on the merged entity. All relationships are updated to point to the merged entity. Source attributions from all original entities are preserved.
Entity merging is irreversible.
Processing stages
During graph creation or update:
| Stage | Description |
|---|---|
| Queued | Waiting for worker |
| Initializing | Setting up the job |
| Extraction | Entities and relationships are being extracted from chunks |
| Resolution | Duplicate entities are being identified and merged |
| Storage | Final data is being saved to the database |
The Overview tab shows the current stage, chunk progress, and live entity/relationship counts.
Error states
Stalled processing
If no progress updates are received for 5+ minutes, the graph shows a "stalled" warning. This may indicate a worker crash. Options:
- Wait for automatic recovery
- Cancel and retry the operation
Failed graphs
Failed graphs display an error panel with:
- Error type and message
- Which stage the error occurred in
- Whether the error is recoverable
For graphs with Extraction Incomplete status, you can resume processing from where it stopped.
Limits
| Limit | Value |
|---|---|
| Entities per graph | No hard limit (performance may degrade at very large scales) |
| Documents per graph | No hard limit |
| Concurrent graph processing | Determined by worker pool |