<!--
  Full-page Markdown export (rendered HTML → GFM).
  Source: https://neotoma.io/es/inspector/relationships-and-graph
  Generated: 2026-04-27T12:48:31.879Z
-->
# Inspector, Relationships & graph

Relationships are the typed edges that turn a flat list of entities into a navigable graph. Inspector exposes them as a flat list (good for filtering and audit) and as an interactive graph explorer (good for understanding context around a single entity).

## Relationship list

The list at `/relationships` shows every typed edge, `PART_OF`, `REFERS_TO`, `EMBEDS`, `SUPERSEDES`, and any custom types, with source and target entity, the agent that created the edge, and the relationship's trust tier (it inherits the writer's). Filters: by relationship type, by source or target `entity_type`, and by agent.

inspector.neotoma.io/relationships?type=PART\_OF

Inspector

Neotoma

Dashboard

Conversations

Turns

Compliance

Activity

Feedback

Entities

Observations

Sources

Relationships

Graph Explorer

Schemas

Timeline

Interpretations

Agents

Agent grants

Settings

Relationships

6,907 edges across 12 types

PART\_OF (4,210)REFERS\_TO (1,884)EMBEDS (612)

| Source | Type | Target | Agent | Created |
| --- | --- | --- | --- | --- |
| msg · turn 4 (user) | PART\_OF | conversation · Q2 review | claude-code | 12:30 |
| msg · turn 4 (user) | REFERS\_TO | transaction · Vercel | claude-code | 12:30 |
| receipt · vercel-2026-04 | EMBEDS | file\_asset · vercel-2026-04.pdf | claude-code | 11:08 |
| task · follow up Sarah | REFERS\_TO | contact · Sarah Park | cursor-agent | 10:55 |

Typed edges with source, target, agent, and tier. Each edge is one row, immutable like observations.

◆

## Graph explorer

The Graph Explorer (`/graph`) renders a 1- or 2-hop neighborhood around a chosen entity, using `@xyflow/react` for layout. Nodes are coloured by `entity_type`; edges by relationship type. Useful examples: confirming that a refund linked to the right charge, that a calendar event linked to the correct attendees, or that an embedded file linked back to the right container row.

inspector.neotoma.io/graph?center=ent\_4ad…&hops=2

Inspector

Neotoma

Dashboard

Conversations

Turns

Compliance

Activity

Feedback

Entities

Observations

Sources

Relationships

Graph Explorer

Schemas

Timeline

Interpretations

Agents

Agent grants

Settings

Graph Explorer

Center: Subscription · Vercel · 2 hops · 14 nodes

PART\_OFREFERS\_TOEMBEDS

transactionreceiptagent\_messagecontact · Verceltaskfile\_assetemail\_messagereminder

Drag to pan · scroll to zoom14 nodes · 19 edges

Force-directed neighborhood around a single entity. Click a node to recentre; right-click an edge to inspect the underlying relationship row.

◆

## Edge inspection

Right-clicking an edge opens its underlying relationship row: type, source, target, creator agent, trust tier, and any relationship-level metadata. Like observations, relationships are immutable; "removing" an edge is modeled with a separate `SUPERSEDES` link rather than a destructive delete.

◆

## Common workflows

-   **Audit a turn**, center the graph on an `agent_message` to see every entity it created or referenced, with PART\_OF and REFERS\_TO edges.
-   **Find orphans**, filter relationships by source or target type and look for entities with zero incoming edges to a conversation.
-   **Trace a file**, center on a `file_asset` and walk EMBEDS edges back to every container row that referenced it.

For the underlying API and edge semantics, see [REST API](/api).