<!-- Full-page Markdown export (rendered HTML → GFM). Source: https://neotoma.io/ar/inspector/relationships-and-graph Generated: 2026-04-27T12:48:32.339Z --> # 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).