# Fast RAGbot V2 - Quick Start Guide

## 5-Minute Setup

### Step 1: Get API Key
Choose one AI provider and get an API key:
- **Gemini**: https://aistudio.google.com/
- **OpenAI**: https://platform.openai.com/api-keys
- **Claude**: https://console.anthropic.com/

### Step 2: Configure Model
1. Go to **Settings > Fast RAGbot > Models** tab
2. Select your preferred model (radio button)
3. Enter API key in the corresponding field
4. Click **"Test Active Model"** to verify
5. Click **"Save Changes"**

### Step 3: Add Content Source
1. Go to **Indexing** tab
2. Click **"Add Source"**
3. Enter:
   - Label: "My Website"
   - Base URL: https://yoursite.com
4. Click **"Index"** button next to the source
5. Wait for indexing to complete

### Step 4: Customize Widget (Optional)
1. Go to **UI/UX** tab
2. Set widget color (default: #007cba)
3. Choose position: bottom-right or bottom-left
4. Add custom logo URL (optional)
5. Enable "Pull Theme CSS" if desired
6. Click **"Save Changes"**

### Step 5: Test Chat
1. Visit your website frontend
2. Click the chat button (bottom-right or bottom-left)
3. Ask a question about your website content
4. Verify answer appears with source citations

## Advanced Features

### Upload Documents
1. Go to **Indexing** tab
2. Click **"Upload Documents"**
3. Select PDF, DOCX, PPTX, XLSX, TXT, XML, or CSV files
4. Wait for upload and indexing

### Enable Pre-Chat Form
1. Go to **General** tab
2. Check **"Pre-Chat Form"**
3. Customize label text
4. Click **"Save Changes"**
5. Users will now provide name/email before chatting

### View Chat Logs
1. Go to **Chat Logs** tab
2. View all conversations with timestamps
3. Click **"Export CSV"** to download logs

### Use Shortcode
Add to any page/post:
```
[ragbot_chat]
```

For inline chat panel:
```
[ragbot_chat inline="true"]
```

## Troubleshooting

### Chat widget not appearing?
- Verify API key is configured and tested
- Check that at least one source is indexed
- Clear browser cache

### Indexing fails?
- Verify base URL is accessible
- Check robots.txt allows crawling
- Ensure API key has proper permissions

### No answers found?
- Verify content is indexed (check Indexing tab)
- Lower similarity threshold in Indexing tab
- Increase top K results

### Follow-up suggestions not showing?
- Only appear when answer not found
- Requires active LLM with generation capability
- Claude users: use Gemini/OpenAI for embeddings

## Best Practices

1. **Start with one domain**: Index your main site first
2. **Test thoroughly**: Use "Test Active Model" before indexing
3. **Monitor logs**: Check Chat Logs tab regularly
4. **Adjust parameters**: Tune chunk size and threshold based on results
5. **Update regularly**: Re-index when content changes significantly

## Support

For issues or questions:
- Check the **Help** tab in settings
- Review plugin documentation
- Visit support forum

## Next Steps

- Add more content sources (up to 3 total)
- Upload additional documents
- Customize widget to match your brand
- Enable pre-chat form for lead capture
- Export and analyze chat logs