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#
- Getting Started
- Dashboard Overview
- Persona Management
- Session Monitoring
- Knowledge Base
- Analytics & Reporting
- Settings & Administration
- Platform Integrations
- Keyboard Shortcuts
- Troubleshooting
Getting Started#
Accessing the Dashboard#
- Navigate to
https://console.serwaa.ai/ - Sign in with your organization credentials
- Select your organization (if you belong to multiple)
First-Time Setup#
When you first access the dashboard, complete these steps:
-
Complete Organization Profile
- Go to Settings > Organization
- Fill in your organization details
- Add billing information if required
-
Invite Team Members
- Go to Settings > Users
- Click "Invite Member"
- Assign appropriate roles
-
Configure Integrations
- Go to Settings > Integrations
- Connect your video conferencing platforms
- Set up CRM integrations if needed
-
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#
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│ 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:
- 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:
- Click "Add Expertise"
- Enter the domain name (e.g., "Customer Support")
- Select proficiency level
- Repeat for additional domains
Example Expertise Configuration:
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:
- Click "Train Avatar"
- Follow the capture guide:
- Record 30-60 seconds of video
- Ensure even lighting
- Include varied expressions
- Show all face angles
- Upload the video
- Wait for training (typically 1-4 hours)
- 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:
- Choose provider
- Browse available voices
- Click "Preview" to hear samples
- Select the best match
Voice Cloning (ElevenLabs):
- Click "Clone Voice"
- Upload 1-3 minutes of clean audio
- Wait for processing
- Preview and adjust settings
Editing a Persona#
- Navigate to the persona detail page
- Click Edit in the header
- Modify any step in the wizard
- Click Save Changes
Cloning a Persona#
Create a copy of an existing persona:
- Open the persona
- Click Clone
- Modify as needed
- 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#
- Open the persona
- Click More > Delete
- 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:
- Find the session in the list
- Click Start
- The AI assistant will join the meeting
Pausing a Session#
For active sessions:
- Click Pause
- The AI stops responding but remains connected
- Click Resume to continue
Ending a Session#
- Click End
- Confirm the action
- 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 |
|---|---|---|
| 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#
- Click Upload Documents
- Drag and drop files or click to browse
- Add optional metadata:
- Title
- Description
- Tags
- Assigned personas
- Click Upload
- 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#
- Click Add Source
- Select Sync
- Configure:
- Source name
- Connection (Google Drive, OneDrive, etc.)
- Folder path
- Sync schedule
- File type filters
- 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:
- Navigate to a document
- Click Add to Collection
- Select existing or create new collection
- 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#
- Click Export in the analytics header
- Select report format (CSV, PDF, Excel)
- Choose data range and metrics
- 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#
- Click Invite Member
- Enter email address
- Select role
- 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#
- Click Create Role
- Enter role name and description
- 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#
- Click Create API Key
- Enter a descriptive name
- Click Generate
- Copy the key immediately - it won't be shown again
- 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 begansession.ended- Session completedsession.error- Session encountered error
Persona Events:
persona.created- New persona createdpersona.updated- Persona modifiedpersona.deleted- Persona removed
Training Events:
training.started- Avatar/voice training begantraining.completed- Training finished
Knowledge Events:
document.uploaded- New document addeddocument.processed- Document readydocument.failed- Processing failed
Creating a Webhook#
- Click Add Webhook
- Enter webhook name
- Enter endpoint URL (must be HTTPS)
- Select events to subscribe
- Click Create
- Copy the signing secret
Testing Webhooks#
- Find the webhook in the list
- Click Test
- A test event is sent to your endpoint
- Check delivery status
Viewing Webhook Logs#
- Click View Logs
- See delivery history:
- Timestamp
- Event type
- Response status
- Response time
- Retry failed deliveries if needed
Platform Integrations#
Connect Psyche with external services.
Video Conferencing Platforms#
Zoom#
Connection Steps:
- Go to Settings > Integrations
- Click Connect on Zoom card
- Sign in with your Zoom account
- Authorize the Psyche app
- Connection status shows "Connected"
Configuration:
- Default meeting settings
- Recording preferences
- Participant permissions
Google Meet#
Prerequisites:
- Google Workspace account
- Admin consent for organization
Connection Steps:
- Click Connect on Google Meet card
- Sign in with Google Workspace account
- Grant required permissions
- Verify domain if required
Microsoft Teams#
Prerequisites:
- Microsoft 365 subscription
- Azure AD app consent
Connection Steps:
- Click Connect on Teams card
- Sign in with Microsoft account
- Admin consent required for first setup
- Grant app permissions
Cisco WebEx#
Connection Steps:
- Click Connect on WebEx card
- Sign in with WebEx account
- Authorize integration
- Configure settings
CRM Integrations#
Salesforce#
Features:
- Sync contact information
- Log session activity
- Create follow-up tasks
Setup:
- Click Connect on Salesforce card
- Authorize OAuth connection
- Map fields between platforms
- Configure sync settings
HubSpot#
Features:
- Contact synchronization
- Activity logging
- Conversation history
Setup:
- Click Connect on HubSpot card
- Sign in to HubSpot
- Select connected account
- Configure field mappings
Communication Integrations#
Slack#
Features:
- Session notifications
- Real-time alerts
- Summary reports
Setup:
- Click Connect on Slack card
- Select Slack workspace
- Choose notification channel
- 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:
- Check all required fields are filled
- Verify you have Editor or Admin role
- Ensure organization has available persona quota
- Check for validation errors on each step
Session Won't Start#
Symptoms: Session remains in Pending status
Solutions:
- Verify video platform integration is connected
- Check meeting URL is valid and accessible
- Ensure persona is in Active status
- Review session configuration for errors
Documents Stuck in Processing#
Symptoms: Documents remain in processing state for extended time
Solutions:
- Check document format is supported
- Verify file isn't corrupted
- Ensure file size is within limits
- Try uploading a smaller test document
- Contact support if issue persists
Webhook Deliveries Failing#
Symptoms: Webhook shows failed delivery status
Solutions:
- Verify endpoint URL is accessible
- Check endpoint accepts POST requests
- Ensure HTTPS certificate is valid
- Verify signature validation code
- Check endpoint response time (must be < 10s)
Avatar Training Failed#
Symptoms: Avatar status shows Error
Solutions:
- Check video meets requirements:
- 30-60 seconds duration
- 1080p or higher resolution
- Good lighting
- Clear face visibility
- Re-upload with improved video
- 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 |
| < 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#
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:
- Use landscape orientation for tables
- Install as PWA for quick access
- Enable notifications for alerts