Skip to main content

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:

SettingDescription
Company NameAppears in navigation/meta
Logo (Light)Logo for light mode
Logo (Dark)Logo for dark mode
Primary ColorMain brand color
Welcome MessageInitial avatar greeting
Persona NameAvatar'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 TypeExample
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:

OriginalPronunciation
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