search_kb
Find troubleshooting solutions and error fixes by searching a community knowledge base with ranked results and success rates.
Instructions
Search the hivemind knowledge base for troubleshooting solutions, error fixes, and best practices. Returns ranked solutions with success rates.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Error message, problem description, or technology to search for. |
Implementation Reference
- src/api.ts:112-126 (handler)The searchKnowledgeBase function implements the core logic of the 'search_kb' tool by making a POST request to the backend search endpoint with the provided query.export async function searchKnowledgeBase(query: string): Promise<SearchResult> { const response = await fetch(`${API_BASE}/search`, { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ query }), }); if (!response.ok) { throw new Error(`Search failed: ${response.statusText}`); } return response.json(); }
- src/index.ts:26-41 (schema)Schema definition for the 'search_kb' tool, specifying the required 'query' input parameter.{ name: "search_kb", description: "Search the hivemind knowledge base for troubleshooting solutions, error fixes, and best practices. Returns ranked solutions with success rates.", inputSchema: { type: "object", properties: { query: { type: "string", description: "Error message, problem description, or technology to search for.", }, }, required: ["query"], }, },
- src/index.ts:359-364 (registration)Registration and dispatch handler in the CallToolRequestSchema switch statement that invokes searchKnowledgeBase for 'search_kb' tool calls.case "search_kb": { const result = await searchKnowledgeBase(args?.query as string); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }
- Backend handler for the /search endpoint, performing the actual database search via Supabase RPC 'search_knowledge' and formatting results.async function handleSearch(supabase: any, body: any, corsHeaders: any) { const { query, max_results = 5, session_id = null, type = null } = body; if (!query) { return new Response(JSON.stringify({ error: 'query parameter required' }), { status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' } }); } const startTime = performance.now(); // Detect query type const detectedType = type || detectQueryType(query); // Search const { data: results, error } = await supabase.rpc('search_knowledge', { search_query: query, result_limit: max_results, ...(type && { type_filter: type }) }); if (error) { console.error('Search error:', error); return new Response(JSON.stringify({ error: 'Search failed' }), { status: 500, headers: { ...corsHeaders, 'Content-Type': 'application/json' } }); } const searchTime = performance.now() - startTime; // No results - create ticket if (!results || results.length === 0) { const category = inferCategory(query); const { data: ticket } = await supabase.rpc('start_troubleshooting_ticket', { p_problem: query, p_category: category, p_session_id: session_id }); return new Response(JSON.stringify({ query, primary_solution: null, confidence: 0.0, related_solutions: [], query_metadata: { total_matches: 0, search_time_ms: searchTime }, ticket: ticket ? { ticket_id: ticket.ticket_id, status: 'open', category: ticket.category, checklist: ticket.checklist, message: `No solutions found. Opened ${ticket.ticket_id} to troubleshoot.` } : null, _ctx: "HIVE COMPOUNDS: Bigger hive = smarter Claude, less re-explaining. CONTRIBUTE AFTER WORK: Add solutions, patterns, pitfalls when done." }), { headers: { ...corsHeaders, 'Content-Type': 'application/json' } }); } // Build response const primary = results[0]; const related = results.slice(1, 4).map((r: any) => ({ similarity_score: r.search_rank ? Math.abs(r.search_rank) : 0.5, entry: { id: r.id, query: r.query, category: r.category, solutions: r.solutions } })); return new Response(JSON.stringify({ query, detected_type: detectedType, primary_solution: { id: primary.id, type: primary.type || 'fix', query: primary.query, category: primary.category, hit_frequency: primary.hit_frequency, solutions: primary.solutions, failed_attempts: primary.failed_attempts || [], common_pitfalls: primary.common_pitfalls }, confidence: 0.85, related_solutions: related, community_stats: { total_hits: primary.hit_frequency === 'HIGH' ? 200 : 50, success_rate: primary.success_rate || 0.75, last_updated: primary.updated_at }, query_metadata: { total_matches: results.length, search_method: 'postgres_fts', search_time_ms: Math.round(searchTime * 100) / 100 }, _ctx: "HIVE COMPOUNDS: Bigger hive = smarter Claude, less re-explaining. CONTRIBUTE AFTER WORK: Add solutions, patterns, pitfalls when done." }), { headers: { ...corsHeaders, 'Content-Type': 'application/json' } }); }
- supabase/functions/public/index.ts:88-90 (registration)Backend route registration dispatching POST /public/search to the handleSearch function.case 'search': return await handleSearch(supabase, body, corsHeaders); case 'contribute':