/kb-guide

name: kb-guide
description: "Search, read, create, and update knowledge base entries via MCP-connected KB tools. Use when the user asks to look up documentation, find existing articles, check if docs exist on a topic, create a new KB entry, update an existing document, or when domain questions should be answered from the knowledge base first."

Knowledge Base Integration Guide

When MCP knowledge base servers are configured, you can use their tools to search, read, create, and update knowledge entries.

Common MCP Knowledge Base Tools

MCP KB servers typically expose tools with these patterns:

Search / Query

• `search_documents(query, limit?)` -- full-text search across the knowledge base
• `search_notes(query)` -- search personal notes or wiki entries
• `query_knowledge(query, filters?)` -- filtered search with metadata constraints

Read

• `get_document(id)` -- retrieve a document by ID
• `read_page(path)` -- read a wiki page by path
• `list_documents(folder?, tag?)` -- list documents in a folder or by tag

Create / Update

• `create_document(title, content, metadata?)` -- create a new entry
• `update_document(id, content)` -- update an existing document
• `create_note(title, body)` -- create a quick note

Example Tool Call

When a user asks "do we have docs on deployment?", search the KB first:

Tool: search_documents
Arguments: { "query": "deployment", "limit": 5 }

Present matching results with titles and snippets. If no results are found, offer to create a new entry.

When to Use Knowledge Base

• **Before answering domain questions**: Search the KB first -- it may contain authoritative answers
• **When the user asks "do we have docs on..."**: Search the KB and return results
• **After resolving an issue**: Suggest creating a KB entry to capture the solution
• **For onboarding/FAQ questions**: Check if there's an existing KB article

Usage Pattern

1. Identify the user's intent (search, read, write) 2. Call the appropriate MCP tool by name 3. If a tool is not available, inform the user that no KB server is configured 4. Present results clearly -- include titles, snippets, and links when available

Notes

• MCP server configuration is defined in `golem.yaml` under the `mcp` key
• Available MCP tools depend on which servers are configured -- use tool discovery to check
• Always prefer searching the KB before generating answers from your own training data