Skip to documentation
eli.aidocs

Atlas

Graph visualization

The graph explorer at /w/<workspace>/graph renders your entity graph in WebGL (sigma.js). It is built to make an LLM-extracted corpus legible — not a hairball — and to let you jump from any node straight to the document that justifies it. The underlying model is in Entity graph.

The overview

On load you see a degree-capped overview (top entities by connection count, up to a few thousand nodes), laid out client-side by a web-worker force-directed algorithm. Nodes are colored deterministically by entity type by default — stable colors that survive re-ingestion — with an optional community color mode backed by the persisted layout & communities. Edges are the typed relations from canonical_relations, with thickness and direction arrows driven by per-edge strength scores.

Hub-hiding is on by default

LLM-extracted corpora orbit a few generic hubs ("the company", "the client"). A default-on toggle hides the top-percentile-degree nodes so the real structure is visible. Turn it off to see the hubs; the point is that the first view is readable.

Explore

  1. Search to fly-to

    Press ⌘K and search for an entity by name; the camera flies to it and selects it.

  2. Expand a neighborhood

    Click a node to expand its immediate neighborhood — one hop of typed edges, with per-hop top-K caps and a truncated flag when a hub would blow past the cap. Keep clicking to walk the graph outward.

  3. Ask why an edge exists

    Click an edgeto open the edge explainability panel: a deterministic strength score with the measures behind it, the relation's direction, the evidence quotes that back it, and the shared documents — no model calls. The math is explained in Relation explainability.

  4. Filter by type

    Toggle entity types in the legend to focus on people, organizations, systems, or topics.

  5. Open provenance

    Selecting a node opens a side panel with its aliases, type, mention count, and top relations, plus links that jump to the source document at the exact chunk. Nothing in the graph is unattributable.

Click-through to documents

Every edge traces to relation evidence (a quote + offsets) and every node to its mentions. The provenance panel is the bridge between the abstract graph and the concrete text — click a relation to land on the sentence that produced it in the document editor.

Endpoints

The explorer is session-scoped — endpoints live under /api/w/:workspaceId/graph/ with membership checks (never a ?workspace= query param):

  • GET …/graph/overview — the degree-capped starting view.
  • GET …/graph/neighborhood— one node's neighbors with caps.
  • GET …/graph/entities — search / list entities.
  • GET …/graph/expand — frontier expansion from seeds.
  • GET …/graph/edge?src&dst — the full edge insight (strength, direction, evidence) behind the edge panel.
  • GET …/graph/edge-strengths — bulk per-edge scores for thickness and arrows.

The /w/<workspace>/entities page is a companion table view for searching and merging entities. See the Workspace API index.