Admin Panel
The admin panel provides configuration and monitoring capabilities for your SmarterAvatar deployment.
Accessing the Admin Panel
Navigate to /admin-analytics on your deployment:
https://your-domain.com/admin-analytics
Features Overview
Dashboard
The main dashboard shows:
- Active Sessions - Current live avatar sessions
- Total Conversations - Historical count
- Average Duration - Session length metrics
- Recent Activity - Latest conversations
Analytics
Detailed analytics including:
- Session counts over time
- Average conversation duration
- Peak usage times
- User engagement metrics
- Topic distribution
Branding
Customize your deployment without code changes:
| Setting | Description |
|---|---|
| Company Name | Appears in navigation/meta |
| Logo (Light) | Logo for light mode |
| Logo (Dark) | Logo for dark mode |
| Primary Color | Main brand color |
| Welcome Message | Initial avatar greeting |
| Persona Name | Avatar's name |
Changes apply immediately—no redeploy needed.
Prompt Management
Configure the AI's behavior:
System Prompt
- Define persona and personality
- Set response guidelines
- Add domain-specific instructions
Prompt Partials
- Create reusable prompt sections
- Combine partials for different contexts
- A/B test prompt variations
Response Overrides
Define custom responses for specific inputs:
| Override Type | Example |
|---|---|
| Exact Match | "hours" → "We're open 9-5 EST" |
| Contains | "pricing" → "Visit example.com/pricing" |
| Starts With | "How do I" → "Here's how..." |
Hard Override: Always use this response Soft Override: Suggest to LLM, allow adaptation
Phonetic Overrides
Control pronunciation of specific terms:
| Original | Pronunciation |
|---|---|
| API | "A P I" |
| SQL | "sequel" |
| AWS | "A W S" |
| Your-Brand | "Your Brand" |
Knowledge Base
Manage your RAG document library:
Upload Documents
- PDF, TXT, Markdown, DOCX
- Automatic chunking and indexing
- Progress tracking
File Management
- View indexed files
- Check indexing status
- Delete outdated documents
Sync Status
- See Gemini File Search status
- Re-index if needed
- Monitor storage usage
Session Insights
AI-powered analysis of conversations:
- Common questions
- Unanswered queries
- Sentiment analysis
- Suggested improvements
Provider Testing
Verify provider connectivity:
- LLM - Test Gemini/OpenAI/Anthropic
- STT - Test Whisper/Deepgram
- Avatar - Test HeyGen connection
Each test shows latency and status.
Permissions
The admin panel is accessible at the /admin-analytics route. For production deployments, consider adding authentication:
- HTTP Basic Auth
- OAuth integration
- IP allowlisting
Best Practices
Regular Review
- Check analytics weekly
- Review unanswered questions
- Update knowledge base as needed
Prompt Iteration
- Start with simple prompts
- Add specificity based on conversations
- Test changes in staging first
Cost Monitoring
- Track session counts
- Monitor credit usage
- Set budget alerts in provider dashboards