Tools and Guides
Understanding RA-H's capabilities
Tools
RA-H agents have access to tools that let them interact with your knowledge base.
Search and Discovery
| Tool | Description |
|---|---|
| Node Search | Find nodes by title, content, or dimensions |
| Semantic Search | Find content by meaning using embeddings |
| Web Search | Pull in external information via Tavily |
| Edge Queries | Explore relationships between nodes |
Content Operations
| Tool | Description |
|---|---|
| Create Nodes | Add new knowledge items to your database |
| Update Nodes | Append insights to existing nodes (append-only) |
| Create Edges | Connect nodes with explained relationships |
| Update Edges | Modify relationship metadata |
Extraction
| Tool | Description |
|---|---|
| YouTube | Extract and process video transcripts |
| Website | Pull content from web pages |
| Extract text from PDF documents |
All extraction tools automatically create nodes with appropriate metadata, dimensions, and embeddings.
Guides
Guides are markdown documents that help AI agents understand your knowledge base. They're especially useful for external agents connecting via MCP.
Why Guides?
When an external agent (like Claude Code) connects to RA-H, it has access to tools but lacks context about:
- How your knowledge base is organized
- What dimensions mean in your system
- Best practices for creating/linking nodes
- Your specific conventions and patterns
Guides bridge this gap.
Built-in Guides
| Guide | Purpose |
|---|---|
| connect | How to find and create connections between nodes |
| integrate | Deep analysis and integration patterns |
| prep | Preparing content for the knowledge base |
| research | Research workflow patterns |
| survey | Survey and discovery patterns |
Managing Guides
Via UI:
- Open Settings (gear icon)
- Click the "Guides" tab
- View, create, or edit guides
Via Guides Pane:
- Click the Guides icon in the left toolbar
- Browse and read guides in a dedicated pane
Creating Custom Guides
Guides use markdown with optional YAML frontmatter:
---
description: Brief description shown in guide list
---
# My Custom Guide
Your guide content here...
MCP Guide Tools
External agents can manage guides via MCP:
| Tool | Purpose |
|---|---|
rah_list_guides | List all available guides |
rah_read_guide | Read a specific guide's content |
rah_write_guide | Create or update a guide |