ra-h-os/src/config/guides/integrate.md

name, description

name	description
Integrate	Full analysis — find connections across the knowledge graph, create edges, and document an integration analysis.

Integrate

Find meaningful connections across the knowledge graph, create edges, and append an Integration Analysis.

Steps

1. Retrieve & Understand

   • Call getNodesById for the focused node
   • Identify: what type of thing is this? (person, project, paper, idea, video, etc.)
   • Extract key entities: names, projects, concepts, techniques
   • Note the core insight in one sentence

2. Search for Connections Search the database using entities from step 1:

   a) Structural connections:

   • Names mentioned → queryNodes to find nodes about those people
   • Projects/tools mentioned → queryNodes to find those nodes

   b) Thematic connections:

   • Use searchContentEmbeddings with key concepts
   • Look for shared themes, complementary ideas, contradictions

   Target: 3-5 strong connections (quality over quantity)

3. Create Edges For each connection found, call createEdge:

   • from_node_id: the focused node ID
   • to_node_id: the connected node ID
   • explanation: "why this connection matters"

   Direction rule: write the explanation so it reads FROM → TO. Examples:

   • Insight → Source: "Came from / inspired by"
   • Episode → Podcast: "Episode of this podcast"

   The tool handles duplicates gracefully — if edge exists, it returns an error and you continue.

   Create 3-5 edges total.

4. Document in Content Call updateNode ONCE using the content field with ONLY this new section:

   ---
   ## Integration Analysis
   
   [2-3 sentences: what this is, why it matters, core insight]
   
   **Connections:**
   - [NODE:123:"Title"] — [why connected]
   - [NODE:456:"Title"] — [why connected]
   

   Use updates.content (NOT chunk). Send ONLY the new section. The tool appends automatically.

5. Return Summary Reply with: Task / Actions / Result / Nodes / Follow-up (≤100 words)

Rules

• Keep total tool calls ≤ 12
• Create edges BEFORE documenting (step 3 before step 4)
• Call updateNode exactly once
• Adapt to any node type
• Use think at any point if you need to plan your approach