Eve library

Psyche Admin Dashboard Guide

Guide

Revision 1

On this page

This guide provides comprehensive documentation for using the Psyche Admin Dashboard to manage AI virtual assistants, monitor sessions, configure knowledge bases, and analyze platform performance.


Table of Contents#

  1. Getting Started
  2. Dashboard Overview
  3. Persona Management
  4. Session Monitoring
  5. Knowledge Base
  6. Analytics & Reporting
  7. Settings & Administration
  8. Platform Integrations
  9. Keyboard Shortcuts
  10. Troubleshooting

Getting Started#

Accessing the Dashboard#

  1. Navigate to https://console.serwaa.ai/
  2. Sign in with your organization credentials
  3. Select your organization (if you belong to multiple)

First-Time Setup#

When you first access the dashboard, complete these steps:

  1. Complete Organization Profile

    • Go to Settings > Organization
    • Fill in your organization details
    • Add billing information if required
  2. Invite Team Members

    • Go to Settings > Users
    • Click "Invite Member"
    • Assign appropriate roles
  3. Configure Integrations

    • Go to Settings > Integrations
    • Connect your video conferencing platforms
    • Set up CRM integrations if needed
  4. Create Your First Persona

    • Go to Personas > Create New
    • Follow the creation wizard
    • Deploy to start using

User Roles#

Role Description
Admin Full access to all features and settings
Editor Create/edit personas, sessions, knowledge
Viewer Read-only access to dashboard and analytics

Dashboard Overview#

The main dashboard provides a real-time overview of your Psyche platform.

Key Metrics#

text
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│ Active Sessions │ Total Personas  │ Avg Response    │ Satisfaction    │
│      12         │       8         │    342ms        │     94%         │
│ +2 from hour    │ 2 in training   │ -15% yesterday  │ +3% this week   │
└─────────────────┴─────────────────┴─────────────────┴─────────────────┘

Active Sessions: Current live AI assistant sessions across all platforms.

Total Personas: Number of configured AI personas (active and in training).

Avg Response Time: Average end-to-end response latency (target: <500ms).

Satisfaction Score: Aggregate user satisfaction rating.

Recent Sessions Widget#

Displays the most recent sessions with:

  • Session name and participant count
  • Status indicator (Active, Pending, Ended)
  • Duration
  • Quick action buttons

System Status#

Real-time system health indicators:

  • Green (Success): All systems operational
  • Yellow (Warning): Minor issues detected
  • Red (Error): Critical issues requiring attention

Quick Actions#

Action Description
Create Persona Start the persona creation wizard
Start Session Launch a new AI assistant session
View Analytics Jump to analytics dashboard
Upload Documents Add documents to knowledge base

Persona Management#

Personas define the personality, expertise, appearance, and voice of your AI assistants.

Viewing Personas#

Navigate to Personas in the sidebar to see all configured personas.

Persona Card Information#

Each persona card displays:

  • Avatar image or initials
  • Name and status badge
  • Description (2-line summary)
  • Expertise tags
  • Session count
  • Satisfaction score
  • Action buttons

Persona Statuses#

Status Color Description
Active Green Ready for use in sessions
Training Blue Avatar or voice model training
Inactive Gray Paused, not available for new sessions
Draft Yellow Configuration incomplete
Archived Gray Removed from active use

Search and Filter#

  • Search: Find personas by name, description, or expertise
  • Status Filter: Filter by Active, Training, Inactive, or Draft

Creating a Persona#

Click Create New to start the 5-step creation wizard.

Step 1: Identity#

Configure basic information:

Field Description Required
Full Name Display name of the persona Yes
Job Title Professional title Yes
Company Organization name No
Bio Brief description Yes
Photo Profile image upload No

Best Practices:

  • Use realistic names that match your brand
  • Keep bios concise (2-3 sentences)
  • Include relevant professional background

Step 2: Personality#

Configure character traits using the OCEAN model:

Big Five Personality Traits:

Trait Low (0) High (1)
Openness Conventional Creative, curious
Conscientiousness Flexible Organized, reliable
Extraversion Reserved Outgoing, energetic
Agreeableness Competitive Cooperative, warm
Neuroticism Emotionally stable Sensitive, anxious

Communication Style Options:

  • Formal
  • Professional
  • Casual
  • Friendly
  • Technical

Conversational Tone Options:

  • Warm
  • Neutral
  • Enthusiastic
  • Calm
  • Assertive

Custom Instructions: Add specific behavioral guidelines:

text
- Always introduce yourself by name
- Ask clarifying questions before providing solutions
- Use analogies to explain complex concepts
- End conversations with a satisfaction check

Step 3: Expertise#

Define knowledge domains and proficiency:

Proficiency Level Description
Beginner Basic understanding
Intermediate Working knowledge
Advanced Deep expertise
Expert Authority-level knowledge

Adding Expertise:

  1. Click "Add Expertise"
  2. Enter the domain name (e.g., "Customer Support")
  3. Select proficiency level
  4. Repeat for additional domains

Example Expertise Configuration:

text
Sales Strategy          Expert
Product Knowledge       Expert
CRM Systems             Advanced
Contract Negotiation    Intermediate

Step 4: Avatar (Optional)#

Configure visual appearance for video sessions.

Avatar Style Options:

Style Description Use Case
Photorealistic Lifelike human appearance Customer-facing
Animated Stylized cartoon appearance Casual, internal
Stylized Artistic interpretation Creative, branding

Quality Settings:

Quality Resolution FPS GPU Required
480p 854x480 24 Minimal
720p 1280x720 30 Standard
1080p 1920x1080 30 High
4K 3840x2160 30 Very High

Training a Custom Avatar:

  1. Click "Train Avatar"
  2. Follow the capture guide:
    • Record 30-60 seconds of video
    • Ensure even lighting
    • Include varied expressions
    • Show all face angles
  3. Upload the video
  4. Wait for training (typically 1-4 hours)
  5. Monitor progress in the persona detail page

Step 5: Voice (Optional)#

Configure text-to-speech settings.

Voice Provider Options:

  • ElevenLabs (recommended for natural speech)
  • Google Cloud TTS
  • Amazon Polly
  • Microsoft Azure

Voice Configuration:

Setting Range Description
Speed 0.5x - 2x Speech rate multiplier
Pitch -50% - +50% Voice pitch adjustment

Selecting a Voice:

  1. Choose provider
  2. Browse available voices
  3. Click "Preview" to hear samples
  4. Select the best match

Voice Cloning (ElevenLabs):

  1. Click "Clone Voice"
  2. Upload 1-3 minutes of clean audio
  3. Wait for processing
  4. Preview and adjust settings

Editing a Persona#

  1. Navigate to the persona detail page
  2. Click Edit in the header
  3. Modify any step in the wizard
  4. Click Save Changes

Cloning a Persona#

Create a copy of an existing persona:

  1. Open the persona
  2. Click Clone
  3. Modify as needed
  4. Save with a new name

Activating/Deactivating#

  • Pause: Prevents persona from being used in new sessions
  • Activate: Makes persona available for sessions

Deleting a Persona#

  1. Open the persona
  2. Click More > Delete
  3. Confirm deletion

Note: Deleted personas cannot be recovered. Consider archiving instead.


Session Monitoring#

Monitor and manage AI assistant sessions across all platforms.

Session List#

Navigate to Sessions to view all sessions.

Session Statistics#

Metric Description
Active Now Currently running sessions
Today Total sessions started today
Messages Total messages across all sessions
Participants Total unique participants

Session Table Columns#

Column Description
Session Name and participant count
Status Current session state
Persona Assigned AI persona
Platform Video conferencing platform
Duration Time since session started
Messages Number of messages exchanged
Actions Available operations

Session Statuses#

Status Color Description
Active Green Session in progress
Pending Yellow Scheduled but not started
Paused Orange Temporarily stopped
Ended Gray Session completed
Error Red Session encountered an error

Managing Sessions#

Starting a Session#

For pending sessions:

  1. Find the session in the list
  2. Click Start
  3. The AI assistant will join the meeting

Pausing a Session#

For active sessions:

  1. Click Pause
  2. The AI stops responding but remains connected
  3. Click Resume to continue

Ending a Session#

  1. Click End
  2. Confirm the action
  3. Session transcript is saved automatically

Viewing Session Details#

Click on a session row to view:

  • Real-time transcript
  • Participant list
  • Message history
  • Performance metrics
  • Recording (if enabled)

Live Session View#

For active sessions, the live view shows:

  • Real-time conversation transcript
  • AI response status
  • Current speaker indicator
  • Latency metrics
  • Interrupt controls

Knowledge Base#

Manage documents and knowledge sources that power AI responses.

Overview#

Navigate to Knowledge Base to manage content.

Statistics#

Metric Description
Total Documents Number of uploaded documents
Ready Documents available for use
Processing Documents being processed
Quality Score Average document quality rating

Documents Tab#

View and manage individual documents.

Document Card Information#

  • File icon indicating type
  • Filename and description
  • File size
  • Processing status with progress
  • Quality score (when ready)
  • Metadata tags
  • Source and upload time

Document Statuses#

Status Icon Description
Pending Clock Waiting to start processing
Uploading Upload File transfer in progress
Processing Loader Initial processing
Chunking Scissors Splitting into segments
Embedding Sparkles Creating vector embeddings
Indexing Database Adding to search index
Ready Checkmark Available for AI retrieval
Error Alert Processing failed
Archived Archive Removed from active use

Supported File Types#

Format Max Size Description
PDF 100 MB Documents, manuals
DOCX 50 MB Word documents
XLSX 50 MB Spreadsheets
PPTX 50 MB Presentations
TXT 10 MB Plain text files
MD 10 MB Markdown documents
JSON 50 MB Structured data

Uploading Documents#

  1. Click Upload Documents
  2. Drag and drop files or click to browse
  3. Add optional metadata:
    • Title
    • Description
    • Tags
    • Assigned personas
  4. Click Upload
  5. Monitor processing status

Best Practices:

  • Use descriptive filenames
  • Add relevant tags for organization
  • Assign documents to specific personas when relevant
  • Break very large documents into logical sections

Sources Tab#

Manage automated knowledge sources.

Source Types#

Type Description
Manual Manually uploaded documents
Sync Automated folder/drive synchronization
Connector Third-party service integration
API External API connections
Webhook Event-driven document updates

Creating a Sync Source#

  1. Click Add Source
  2. Select Sync
  3. Configure:
    • Source name
    • Connection (Google Drive, OneDrive, etc.)
    • Folder path
    • Sync schedule
    • File type filters
  4. Click Create

Source Management#

  • Sync Now: Manually trigger synchronization
  • View: See all documents from this source
  • Configure: Edit source settings
  • Disable: Stop automatic syncing

Collections#

Organize documents into collections:

  1. Navigate to a document
  2. Click Add to Collection
  3. Select existing or create new collection
  4. Collections can be assigned to personas

Analytics & Reporting#

Comprehensive analytics for platform performance and usage.

Accessing Analytics#

Navigate to Analytics in the sidebar.

Time Period Selection#

Period Description
Last 24 hours Real-time operational view
Last 7 days Weekly trends
Last 30 days Monthly performance
Last 90 days Quarterly analysis
Custom Select specific date range

Overview Tab#

Key performance indicators:

Metric Description Target
Total Sessions Sessions in selected period -
Total Messages Messages exchanged -
Active Users Unique users -
Quality Score Overall platform quality > 90%

Session Volume Tab#

Sessions by Day#

Bar chart showing daily session distribution.

  • Identify peak usage days
  • Spot trends over time
  • Compare to previous periods

Sessions by Platform#

Horizontal bar chart showing platform breakdown:

  • Zoom
  • Google Meet
  • Microsoft Teams
  • WebEx

Peak Hours#

Column chart showing hourly distribution.

  • Identify optimal support hours
  • Plan capacity accordingly

Conversations Tab#

Key Metrics#

Metric Description Target
Avg Messages/Session Messages per session 15-30
Avg Response Time Time to first AI response < 500ms
Avg Duration Session length -
Response Accuracy Correct responses percentage > 95%

Messages by Type#

Type Description
User Questions Queries from participants
AI Responses Persona-generated responses
Tool Results Responses from tool integrations
System Platform-generated messages

Top Topics#

Table showing trending conversation topics:

  • Topic name
  • Session count
  • Trend indicator (up/down)

Engagement Tab#

User Metrics#

Metric Description
New Users First-time users in period
Satisfaction User satisfaction score
Engagement Rate Active participation percentage
NPS Score Net Promoter Score

User Segments#

Segment Description
Enterprise Large organization users
Business Mid-size business users
Startup Small company users
Individual Personal use

User Retention#

Donut chart showing:

  • Returning users percentage
  • New users percentage

Quality Tab#

Technical Metrics#

Metric Description Target
Avatar Quality Visual rendering quality score > 95%
Voice Quality Audio synthesis quality score > 95%
Avg Latency End-to-end response time < 500ms
Error Rate Percentage of failed operations < 1%

Latency Distribution#

Percentile Description Target
P50 Median latency < 300ms
P95 95th percentile < 500ms
P99 99th percentile < 1000ms

Errors by Type#

Distribution of error categories:

  • Network errors
  • Timeout errors
  • Processing errors
  • Integration errors

Exporting Reports#

  1. Click Export in the analytics header
  2. Select report format (CSV, PDF, Excel)
  3. Choose data range and metrics
  4. Download report

Settings & Administration#

Configure platform settings and manage your organization.

Organization Tab#

Organization Profile#

Field Description
Name Organization display name
Slug URL-friendly identifier (read-only)
Description About your organization
Website Company website URL
Industry Business sector
Contact Email Primary contact
Contact Phone Phone number
Address Physical address

Plan & Billing#

  • View current subscription plan
  • See included features
  • Access billing portal
  • Update billing email

Users Tab#

Team Members Table#

Column Description
Member Name and email
Role Admin, Editor, or Viewer
Status Active, Pending, or Inactive
MFA Two-factor authentication status
Last Active Most recent login

Inviting Team Members#

  1. Click Invite Member
  2. Enter email address
  3. Select role
  4. Click Send Invitation

The invited user receives an email with setup instructions.

Managing Members#

Click the action menu (three dots) to:

  • Edit: Update member details
  • Change Role: Assign different role
  • Remove: Remove from organization

Roles Tab#

Default Roles#

Role Permissions
Admin Full access to all features
Editor Create/edit content, no admin settings
Viewer Read-only access to dashboard

Creating Custom Roles#

  1. Click Create Role
  2. Enter role name and description
  3. Select permissions:

Persona Permissions:

  • Read: View personas
  • Write: Create/edit personas
  • Delete: Remove personas
  • Train: Initiate avatar/voice training

Session Permissions:

  • Read: View sessions
  • Write: Start/manage sessions
  • Delete: Remove session history
  • Supervise: Access live session controls

Knowledge Base Permissions:

  • Read: View documents
  • Write: Upload/edit documents
  • Delete: Remove documents
  • Configure: Manage sources

Analytics Permissions:

  • Read: View analytics
  • Export: Download reports

Settings Permissions:

  • Read: View settings
  • Write: Modify settings
  • Users: Manage team members
  • Roles: Manage roles
  • API: Manage API keys
  • Billing: Access billing

API Keys Tab#

Managing API Keys#

Action Description
Create Generate new API key
Regenerate Create new key, invalidate old
Rename Update key name
Revoke Permanently disable key

Creating an API Key#

  1. Click Create API Key
  2. Enter a descriptive name
  3. Click Generate
  4. Copy the key immediately - it won't be shown again
  5. Store securely

API Key Security#

  • Keys are shown only once at creation
  • Use different keys for different environments
  • Rotate keys regularly (recommended: every 90 days)
  • Revoke unused keys

Webhooks Tab#

Webhook Configuration#

Field Description
Name Descriptive name for the webhook
URL Endpoint to receive events
Events Subscribed event types
Status Active or Inactive

Available Events#

Session Events:

  • session.started - Session began
  • session.ended - Session completed
  • session.error - Session encountered error

Persona Events:

  • persona.created - New persona created
  • persona.updated - Persona modified
  • persona.deleted - Persona removed

Training Events:

  • training.started - Avatar/voice training began
  • training.completed - Training finished

Knowledge Events:

  • document.uploaded - New document added
  • document.processed - Document ready
  • document.failed - Processing failed

Creating a Webhook#

  1. Click Add Webhook
  2. Enter webhook name
  3. Enter endpoint URL (must be HTTPS)
  4. Select events to subscribe
  5. Click Create
  6. Copy the signing secret

Testing Webhooks#

  1. Find the webhook in the list
  2. Click Test
  3. A test event is sent to your endpoint
  4. Check delivery status

Viewing Webhook Logs#

  1. Click View Logs
  2. See delivery history:
    • Timestamp
    • Event type
    • Response status
    • Response time
  3. Retry failed deliveries if needed

Platform Integrations#

Connect Psyche with external services.

Video Conferencing Platforms#

Zoom#

Connection Steps:

  1. Go to Settings > Integrations
  2. Click Connect on Zoom card
  3. Sign in with your Zoom account
  4. Authorize the Psyche app
  5. Connection status shows "Connected"

Configuration:

  • Default meeting settings
  • Recording preferences
  • Participant permissions

Google Meet#

Prerequisites:

  • Google Workspace account
  • Admin consent for organization

Connection Steps:

  1. Click Connect on Google Meet card
  2. Sign in with Google Workspace account
  3. Grant required permissions
  4. Verify domain if required

Microsoft Teams#

Prerequisites:

  • Microsoft 365 subscription
  • Azure AD app consent

Connection Steps:

  1. Click Connect on Teams card
  2. Sign in with Microsoft account
  3. Admin consent required for first setup
  4. Grant app permissions

Cisco WebEx#

Connection Steps:

  1. Click Connect on WebEx card
  2. Sign in with WebEx account
  3. Authorize integration
  4. Configure settings

CRM Integrations#

Salesforce#

Features:

  • Sync contact information
  • Log session activity
  • Create follow-up tasks

Setup:

  1. Click Connect on Salesforce card
  2. Authorize OAuth connection
  3. Map fields between platforms
  4. Configure sync settings

HubSpot#

Features:

  • Contact synchronization
  • Activity logging
  • Conversation history

Setup:

  1. Click Connect on HubSpot card
  2. Sign in to HubSpot
  3. Select connected account
  4. Configure field mappings

Communication Integrations#

Slack#

Features:

  • Session notifications
  • Real-time alerts
  • Summary reports

Setup:

  1. Click Connect on Slack card
  2. Select Slack workspace
  3. Choose notification channel
  4. Configure alert preferences

Keyboard Shortcuts#

Navigate the dashboard efficiently with keyboard shortcuts.

Global Shortcuts#

Shortcut Action
? Show keyboard shortcuts
/ Focus search
g + d Go to Dashboard
g + p Go to Personas
g + s Go to Sessions
g + k Go to Knowledge Base
g + a Go to Analytics

List Views#

Shortcut Action
j Move down in list
k Move up in list
Enter Open selected item
n Create new item

Actions#

Shortcut Action
Escape Close modal/dialog
Ctrl+S Save changes
Ctrl+Enter Submit form

Troubleshooting#

Common Issues#

Cannot Create Persona#

Symptoms: Create button disabled or error on save

Solutions:

  1. Check all required fields are filled
  2. Verify you have Editor or Admin role
  3. Ensure organization has available persona quota
  4. Check for validation errors on each step

Session Won't Start#

Symptoms: Session remains in Pending status

Solutions:

  1. Verify video platform integration is connected
  2. Check meeting URL is valid and accessible
  3. Ensure persona is in Active status
  4. Review session configuration for errors

Documents Stuck in Processing#

Symptoms: Documents remain in processing state for extended time

Solutions:

  1. Check document format is supported
  2. Verify file isn't corrupted
  3. Ensure file size is within limits
  4. Try uploading a smaller test document
  5. Contact support if issue persists

Webhook Deliveries Failing#

Symptoms: Webhook shows failed delivery status

Solutions:

  1. Verify endpoint URL is accessible
  2. Check endpoint accepts POST requests
  3. Ensure HTTPS certificate is valid
  4. Verify signature validation code
  5. Check endpoint response time (must be < 10s)

Avatar Training Failed#

Symptoms: Avatar status shows Error

Solutions:

  1. Check video meets requirements:
    • 30-60 seconds duration
    • 1080p or higher resolution
    • Good lighting
    • Clear face visibility
  2. Re-upload with improved video
  3. Contact support for specific error details

Getting Help#

In-App Support#

  • Click the help icon in the bottom-right corner
  • Search documentation
  • Start live chat (business hours)

Support Channels#

Channel Response Time Best For
Chat < 5 minutes Quick questions
Email < 24 hours Detailed issues
Phone Immediate Critical problems

Contact Information#

  • Documentation: https://docs.serwaa.ai/
  • Support Email: support@serwaa.ai
  • Status Page: https://status.serwaa.ai/
  • Community Forum: https://community.serwaa.ai/

Appendix#

Glossary#

Term Definition
Persona Configured AI assistant with personality
Session Active interaction with AI assistant
OCEAN Big Five personality model
RAG Retrieval-Augmented Generation
3DGS 3D Gaussian Splatting (avatar rendering)
TTS Text-to-Speech
STT Speech-to-Text

Status Indicators#

text
Color Legend:
  ● Green  = Active/Success/Ready
  ● Blue   = In Progress/Training
  ● Yellow = Pending/Warning
  ● Orange = Paused
  ● Gray   = Inactive/Ended
  ● Red    = Error/Failed

Browser Support#

Browser Minimum Version
Chrome 100+
Firefox 100+
Safari 15+
Edge 100+

Note: Internet Explorer is not supported.

Mobile Support#

The dashboard is fully responsive and supports:

  • iOS Safari (iPhone/iPad)
  • Android Chrome
  • Progressive Web App (PWA) installation

For the best experience on mobile:

  1. Use landscape orientation for tables
  2. Install as PWA for quick access
  3. Enable notifications for alerts