Knowledge graph

A graph is built when you ask for one. Ingesting files never commits you to a build. knowledge_graph.auto_build on the workspace chains a build after every ingestion. The graph is not a separate question tool. Once it is built, automatic search (both routes) and QA use it on their own. See Choose the right tool.

Python
TypeScript
curl

from ndi_sdk import NdiClient

with NdiClient() as client:
    workspace_id = "550e8400-e29b-41d4-a716-446655440001"
    client.jobs.wait(
        client.ingestion.build_knowledge_graph(workspace_id).job_id,
        timeout=1800,
    )

import { NdiClient } from "ndi-sdk";

const client = new NdiClient();
const workspaceId = "550e8400-e29b-41d4-a716-446655440001";
await client.jobs.wait((await client.ingestion.buildKnowledgeGraph(workspaceId)).job_id, {
  timeout: 1800,
});

curl -s -X POST "$NDI_BASE_URL/v1/workspaces/$WS/knowledge-graph/builds" \
  -H "X-API-Key: $NDI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

PATCH `knowledge_graph`

PATCH /v1/workspaces/{id} replaces the knowledge_graph block whole. Read the current block first and send exclusions back with auto_build changed — sending auto_build alone resets exclude_path_prefixes and exclude_categories to empty. See Workspaces.

Getting started

Guides

Agents

Concepts

Troubleshooting

PATCH `knowledge_graph`

​PATCH knowledge_graph

PATCH `knowledge_graph`