roboco/docs/rag/troubleshooting/kb-errors.md

Knowledge Base Troubleshooting

Empty Search Results

Problem: roboco_kb_search() returns nothing

Causes:

1. Content not indexed yet
2. Query too specific
3. Wrong index type filter

Solutions:

• Check what's indexed: roboco_kb_stats()
• Broaden query terms
• Remove index_types filter
• Trigger reindex: roboco_reindex_all()

Empty RAG Response

Problem: roboco_rag_query() returns empty answer

Causes:

1. No relevant context found
2. LLM returned thinking tags only
3. Query too vague

Solutions:

• Check KB has relevant content
• Rephrase query to be more specific
• Use roboco_kb_search() first to verify content exists

Mentor Not Responding

Problem: roboco_ask_mentor() fails or empty

Causes:

1. LLM timeout
2. No relevant KB content
3. Service temporarily unavailable

Solutions:

• Retry the query
• Check KB stats
• Use roboco_kb_search() as fallback

Index Failed

Problem: roboco_kb_index_code() or roboco_kb_index_docs() fails

Causes:

1. Invalid file patterns
2. Files not accessible
3. Embedding service down

Solutions:

• Verify file patterns match files
• Check file permissions
• Verify Ollama is running

Cannot Clear Index

Problem: "Not authorized to clear index"

Cause: Only PM/CEO can clear indexes

Solution: Ask PM or CEO to clear if needed

Proactive Context Empty

Problem: roboco_get_proactive_context() returns empty

Cause: No relevant context found for task

Solution: Manual search with roboco_kb_search() using task keywords