Skip to content

INDEX.md

Latest commit

 

History

History
202 lines (153 loc) · 9.81 KB

INDEX.md

File metadata and controls

202 lines (153 loc) · 9.81 KB

AutoBot Troubleshooting Index

Quick Navigation | By Component | By Symptom | By Severity | All Guides

🔍 Quick Search

Having an issue? Use this symptom-to-guide mapping:

Symptom Guide Severity
Port not accessible / Connection refused NPU Worker Port Not Accessible High
404 / 401 API errors Frontend API Calls 404/401 Errors High
ModuleNotFoundError / ImportError Stale Import Paths High
Ansible role not found Ansible Role Deployment Failures High
Tool results appear instantly LLM Streaming Fake Tool Results Medium
Backend API unresponsive Comprehensive Guide §1 Critical
VM communication failure Comprehensive Guide §2 Critical
Redis connection failure Comprehensive Guide §3 Critical
Multi-modal AI failure Comprehensive Guide §4 High
Knowledge base search error Comprehensive Guide §5 High
Frontend connection timeout Comprehensive Guide §6 High
Terminal command timeout Comprehensive Guide §7 Medium
Browser automation failure Comprehensive Guide §8 Medium
File upload failure Comprehensive Guide §9 Medium
Performance degradation Comprehensive Guide §10 Low

By Component

🔧 Infrastructure

Issue Guide Issue #
NPU worker port not accessible Guide #851
Ansible role deployment failures Guide #807, #837
VM communication breakdown Comprehensive §2 -

🔙 Backend

Issue Guide Issue #
API unresponsive Comprehensive §1 -
Stale import paths after refactoring Guide #806
LLM streaming hallucinations Guide #727
Redis connection failures Comprehensive §3 -

🎨 Frontend

Issue Guide Issue #
API calls return 404/401 errors Guide #810, #822
Frontend connection issues Comprehensive §6 -

🤖 AI / ML

Issue Guide Issue #
Multi-modal AI processing failures Comprehensive §4 -
Knowledge base search errors Comprehensive §5 -

🌐 Browser / Terminal

Issue Guide Issue #
Terminal command timeouts Comprehensive §7 -
Browser automation failures Comprehensive §8 -

By Symptom

Connection / Network Issues

Import / Module Errors

  • Stale Import Paths
  • ModuleNotFoundError: No module named 'src.xxx'
  • ImportError: cannot import name 'xxx'

Deployment / Configuration Issues

API / Service Issues

AI / LLM Issues

By Severity

🔥 Critical (System Down)

  1. Backend API Unresponsive
  2. VM Communication Failures
  3. Redis Database Failures

⚠️ High Priority (Degraded Performance)

  1. NPU Worker Port Not Accessible
  2. Frontend API 404/401 Errors
  3. Stale Import Paths
  4. Ansible Deployment Failures
  5. Multi-Modal AI Processing Failures
  6. Knowledge Base Search Failures
  7. Frontend Connection Issues

📝 Medium Priority (Feature Impact)

  1. LLM Streaming Fake Results
  2. Terminal Command Timeouts
  3. Browser Automation Failures
  4. File Upload Failures

ℹ️ Low Priority (Minor Impact)

  1. Performance Optimization

All Guides

Detailed Guides (New)

  1. NPU Worker Port Not Accessible - #851
  2. Frontend API Calls 404/401 Errors - #810, #822
  3. Stale Import Paths After Refactoring - #806
  4. Ansible Role Deployment Failures - #807, #837
  5. LLM Streaming Fake Tool Results - #727

Comprehensive Guide (Existing)

  1. Backend API Unresponsive
  2. VM Communication Failures
  3. Redis Database Failures
  4. Multi-Modal AI Processing Failures
  5. Knowledge Base Search Failures
  6. Frontend Connection Issues
  7. Terminal Command Execution Issues
  8. Browser Service Automation Failures
  9. File Upload & Management Issues
  10. Performance Optimization Issues

Reference Documents

Quick Diagnostic Commands

Before diving into specific guides, run these diagnostic commands:

# 1. Overall system health
bash run_autobot.sh --status

# 2. Service connectivity
python3 scripts/health_check_comprehensive.py

# 3. Recent errors
tail -f logs/autobot.log | grep -i error

# 4. VM network
ping -c 3 172.16.168.19  # SLM
ping -c 3 172.16.168.21  # Frontend
ping -c 3 172.16.168.22  # NPU
ping -c 3 172.16.168.23  # Redis
ping -c 3 172.16.168.24  # AI Stack
ping -c 3 172.16.168.25  # Browser

# 5. Critical services
curl -s http://127.0.0.1:8001/api/health | jq .
redis-cli -h 172.16.168.23 ping

Contributing

To add a new troubleshooting guide:

  1. Use the guide template
  2. Create docs/troubleshooting/guides/your-issue-name.md
  3. Add entry to this INDEX.md in all relevant sections
  4. Link from error messages if applicable
  5. Test all commands and verification steps

Last Updated: 2026-02-12 Total Guides: 15 (10 comprehensive + 5 detailed)