Connect first graph onboarding

Canonical repo copy: docs/connect-first-graph-onboarding.md — same operational steps; update that file first, then keep this page aligned.

Goal: Build your first knowledge graph in Restormel Connect using Surreal Cloud, two model capabilities (chat + embedding), the starter philosophy corpus, and Graph Designer — then run ingest and browse the result at /keys/dashboard/connect/graph.

Start from the expandable guide on Connect home or follow the phases below.

Phases

  1. Surreal Cloud — create an instance, paste your connection string on Pipeline → Graph store.
  2. AI keys & routes — add Connections, then publish chat and embedding ingestion routes on Models & keys.
  3. Starter corpus — load three demo documents on Pipeline → Sources.
  4. Describe schema — use Graph Designer on Pipeline → Domain with the suggested first-graph intent.
  5. First ingest — start a run on Pipeline → Run (requires CONNECT_INGEST_WORKER_MODE=full on the worker).
  6. Explore — browse your knowledge graph.

Suggested Graph Designer intent

Extract philosophical claims and argument structure from short ethics and epistemology passages—premises, conclusions, objections, and discourse relations like supports, contradicts, and responds_to.

Embedding providers (first run)

Use OpenAI, Together, Voyage, or Vercel AI Gateway for the embedding route. Domain packs may reference other models in metadata — bind a supported provider in your published embedding route.

Related