Knowledge Graph Bootstrap

Step-by-Step Workflow

Step 1: Check Existing Projects

Use

list_kg_projects

first:

• If projects exist → Ask: "Would you like to add to an existing project or create a new one?"
• If no projects → Proceed to Step 2

Step 2: Create New Project (if needed)

Ask for a project name describing the research domain:

"What would you like to call this Knowledge Graph project?" Examples: 'Tech Industry Interviews', 'Climate Research', 'Company History'

Use

create_kg_project

and report the project ID.

Step 3: Bootstrap Domain Profile

This is where the magic happens:

Explain: "I'll analyze your transcript to discover entity types (people, organizations, concepts) and relationships."

Use

bootstrap_kg_project

with:

• project_id

  : The newly created ID

• transcript

  : Full transcript text (use

  get_transcript

  if needed)

• title

  : Video/source title

Step 4: Present Bootstrap Results

Format results conversationally:

## Knowledge Graph Schema Discovered!

**Project:** [Name]
**Confidence:** [X]%

### Entity Types Discovered ([N])
- **Person**: Individuals mentioned
- **Company**: Organizations, startups
- [etc.]

### Relationship Types ([N])
- **works_at**: Employment relationships
- **founded**: Company founding
- [etc.]

### Example Entities Identified ([N])
- [Entity Name] ([Type])
- [etc.]

Now extracting entities into the graph...

Step 4.5: CRITICAL — Extract from Bootstrap Transcript

IMMEDIATELY after bootstrap, call

extract_to_kg

with the SAME transcript:

extract_to_kg(
    project_id="...",
    transcript="...",        ← Same transcript used for bootstrap
    title="...",             ← Same title
    transcript_id="..."      ← REQUIRED for evidence linking
)

This populates the actual graph with entities. Bootstrap only creates the schema (types and patterns); extraction adds the nodes and edges.

After extraction completes, present:

## Knowledge Graph Complete!

**Entities Added:** [N]
**Relationships Found:** [N]

Would you like me to:
1. Extract entities from another transcript
2. View current graph statistics
3. Explore key players and connections

Step 5: Continue Building

For subsequent transcripts on a bootstrapped project:

• Use

  extract_to_kg

  directly (no re-bootstrap needed)
• IMPORTANT: Always pass

  transcript_id

  to enable evidence linking
• Show what was added vs. what already existed
• Offer to continue with more transcripts

Tool Parameters

extract_to_kg

(CRITICAL)

When calling

extract_to_kg

, always include:

• project_id

  : Target KG project ID

• transcript

  : Full transcript text

• title

  : Video/source title

• transcript_id

  : Required for evidence — Use the ID returned by

  save_transcript

extract_to_kg(
    project_id="abc123",
    transcript="...",
    title="Interview with CEO",
    transcript_id="5da6b612"  ← from save_transcript result
)

Without

transcript_id

, the graph inspector won't be able to show supporting evidence for entities.

Critical Rules

• A project MUST be bootstrapped before extraction
• Bootstrap happens ONCE per project (first transcript only)
• Bootstrap creates schema ONLY — you MUST call

  extract_to_kg

  afterward to populate the graph
• ALWAYS extract from the bootstrap transcript — don't skip to "another transcript"
• Always pass

  transcript_id

  when using

  extract_to_kg

• Always show progress in chat — user shouldn't need to check sidebar
• The sidebar syncs automatically, but chat is the primary interface

Common Mistake to Avoid

❌ WRONG:

bootstrap_kg_project(transcript)
→ "Your KG is ready! Extract from ANOTHER transcript?"

✅ CORRECT:

bootstrap_kg_project(transcript)
→ "Schema discovered! Now extracting entities..."
extract_to_kg(same_transcript)
→ "X entities and Y relationships added!"