Guide
Exploring Graphs
Learn how to navigate your knowledge graph and discover connections.
The knowledge graph visualization lets you explore entities and relationships interactively. Click nodes, filter by category, search for specific entities, and change layouts to see your content from different angles.
Opening the Graph
From Sources Panel
- Open a notebook
- Look at the Sources panel on the left
- Click Knowledge Graph in the footer
- A dialog opens with your notebook’s graph
From Graph Page
- Click Graph in the main sidebar
- Select one or more notebooks to visualize
- See a combined graph across all selected notebooks
The Interface
The graph view has several parts:
| Area | Purpose |
|---|---|
| Canvas | Main graph visualization |
| Control Panel | Layout, zoom, and display options |
| Legend | Category filters and node size guide |
| Mini-Map | Overview for navigation |
| Search | Find specific entities |
Interacting with Nodes
Click a Node
Clicking a node:
- Selects it (highlighted border)
- Centers it on screen
- Shows its connections
- Opens a details panel (in dialog mode)
Hover Over a Node
Hovering:
- Shows the node’s label
- Highlights its direct connections
- Dims unrelated nodes
View Details
When you click a node, you can see:
- Overview — Name, category, description
- Sources — Which documents mention it
- Connections — Related entities grouped by relationship type
- Excerpts — Actual text passages where it appears
Click on excerpt text to see exactly where in your sources an entity is mentioned.
Filtering
By Category
Use the legend to show/hide entity types:
- Look at the legend (usually bottom-left)
- Click a category to toggle it off/on
- The graph updates to show only selected categories
Example: Hide all “Metric” entities to focus on people and organizations.
By Source
In the dialog view:
- Look at the left panel showing sources
- Check/uncheck sources to filter
- The graph shows only entities from selected sources
Searching
Open Search
Click the search icon in the control panel, or press Cmd+F (Mac) / Ctrl+F (Windows).
How Search Works
Search looks across multiple fields:
- Entity name (highest priority)
- Description
- Category
- Domain tags
- Relationships
Navigate Results
- Use arrow buttons to move through results
- See your position: “3 of 15 results”
- Matching nodes are highlighted and centered
Layout Options
The graph can display in nine different layouts. Each reveals different patterns:
Force-Based Layouts
| Layout | Best For |
|---|---|
| No Overlaps (default) | General exploration, clean view |
| Force-Directed | Seeing natural clustering |
| Force Atlas | Larger graphs |
Structured Layouts
| Layout | Best For |
|---|---|
| Hierarchical | Seeing levels and hierarchies |
| Radial | Central entity with connections radiating out |
| Circular | Equal treatment of all nodes |
Grouped Layouts
| Layout | Best For |
|---|---|
| Circle Pack | Visualizing category groupings |
| Clustered | Seeing category clusters |
| Random | Starting fresh when other layouts feel stuck |
Changing Layouts
- Click the layout dropdown in the control panel
- Select a layout
- The graph animates to the new arrangement
Force-based layouts continuously simulate physics. Structured layouts fix positions once arranged.
Zoom and Pan
Zoom Controls
- Zoom in/out buttons — Click +/- in control panel
- Scroll wheel — Scroll to zoom in/out
- Fit to window — Click to show entire graph
- Reset — Return to default zoom level
Zoom range: 10% to 400%
Pan (Move Around)
- Click and drag on the canvas background
- Mini-map — Click anywhere to jump, or drag the viewport rectangle
Mini-Map
The mini-map shows a bird’s-eye view:
- Small rectangle = your current view
- Drag the rectangle to navigate
- Click anywhere to jump to that location
Edge Display
Control how relationship lines appear:
| Mode | Behavior |
|---|---|
| Smart (default) | Edges visible only for selected/hovered nodes |
| All | All edges visible (can get cluttered) |
| None | No edges shown (focus on entities only) |
Cycle through modes with the edge visibility button in the control panel.
Labels
Node labels can be:
- Always visible — All labels shown
- On demand — Labels appear on hover/selection
- Smart — Labels appear based on zoom level and importance
Toggle with the label visibility button.
Reading Node Size
Node size indicates importance:
- Larger nodes = More mentions across your sources
- Smaller nodes = Fewer mentions
The legend shows a size scale for reference.
Relationship Strength
Edge thickness indicates relationship strength:
- Thicker lines = Stronger/more frequent relationships
- Thinner lines = Weaker/less frequent relationships
When the same relationship is found multiple times, its strength increases.
Tips for Exploration
Start Broad, Then Focus
- Begin with the default layout to see the overall structure
- Identify interesting clusters
- Click a node to focus on its connections
- Use category filters to reduce noise
Try Different Layouts
If the graph looks cluttered:
- Try Radial centered on an important entity
- Try Hierarchical to see levels
- Try Circle Pack to see category groupings
Use Search for Large Graphs
With many entities, search is faster than scanning visually.
Filter by Source
When comparing documents:
- Select one source at a time
- See what each document contributes
- Then select multiple to see connections between documents