> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravvio.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Main Dashboard Features

> Detailed overview of key dashboard components and functionality

## Core Dashboard Components

Your Ravvio dashboard is built around several key components that provide comprehensive control and insights into your AI agent's performance.

### Welcome Section Features

<CardGroup cols={2}>
  <Card title="Personalized Greeting" icon="user">
    Dynamic welcome message with your name and current date display
  </Card>

  <Card title="Agent Status Overview" icon="activity">
    Real-time view of your AI agent's operational status and health
  </Card>

  <Card title="Setup Progress Tracker" icon="progress">
    Visual indicator showing configuration completion percentage
  </Card>

  <Card title="Quick Navigation" icon="compass">
    Instant access to most important features and settings
  </Card>
</CardGroup>

### Agent Information Display

<AccordionGroup>
  <Accordion title="Agent Identity">
    **Agent Name**: Display of your customized agent name or default "\[Your Name]'s Assistant"
    **Unique Agent ID**: Alphanumeric identifier required for website integration
    **Creation Date**: When your agent was first created
    **Last Modified**: Most recent configuration update timestamp
  </Accordion>

  <Accordion title="Configuration Status">
    **System Prompt**: Completion status of AI behavior configuration
    **Knowledge Base**: Number of uploaded documents and processing status
    **Integration Settings**: Widget customization and deployment readiness
    **Performance Metrics**: Basic statistics about agent interactions
  </Accordion>

  <Accordion title="Quick Actions">
    **Edit Agent Name**: Inline editing capability for agent identity
    **Copy Agent ID**: One-click copying for integration purposes
    **View Analytics**: Direct link to comprehensive performance data
    **Access Integration**: Jump to deployment code generation
  </Accordion>
</AccordionGroup>

## Setup Progress Tracking

<img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/dashboard-progress-tracker.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=3410b1ef47e2ccaa87c6d176fe4c5899" alt=" Setup progress visualization" width="532" height="489" data-path="images/dashboard-progress-tracker.png" />

### Progress Components

The setup tracker monitors four critical configuration areas:

<Steps>
  <Step title="System Prompt Configuration">
    **Purpose**: Define your AI agent's personality, role, and response behavior
    **Status Indicators**:

    * 🔴 Not Started: Default prompt in use
    * 🟡 In Progress: Custom prompt partially configured
    * 🟢 Complete: Fully customized system prompt active

    **Quick Actions**: Edit system prompt, use AI generation, test in playground
  </Step>

  <Step title="Knowledge Base Population">
    **Purpose**: Upload training documents for accurate, context-aware responses
    **Status Indicators**:

    * 🔴 Empty: No documents uploaded
    * 🟡 Processing: Documents being indexed
    * 🟢 Ready: Documents processed and available

    **Quick Actions**: Upload documents, view processing status, manage files
  </Step>

  <Step title="Agent Name Customization">
    **Purpose**: Personalize your agent's identity to match your brand
    **Status Indicators**:

    * 🔴 Default: Using system-generated name
    * 🟢 Customized: Personalized name configured

    **Quick Actions**: Edit name inline, preview appearance, save changes
  </Step>

  <Step title="Integration Readiness">
    **Purpose**: Prepare agent for website deployment
    **Status Indicators**:

    * 🔴 Not Ready: Prerequisites incomplete
    * 🟡 Partial: Some requirements met
    * 🟢 Ready: All systems prepared for deployment

    **Quick Actions**: Generate integration code, preview widget, test deployment
  </Step>
</Steps>

### Progress Calculation

<Note>
  Progress percentage is calculated based on completion of all four setup areas. Each completed area contributes 25% to the total progress score.
</Note>

## Performance Metrics Display

### Key Statistics

<CardGroup cols={2}>
  <Card title="Session Metrics" icon="users">
    * **Total Sessions**: All-time conversation count
    * **Active Sessions**: Currently ongoing conversations
    * **Session Growth**: Trend analysis over time
    * **Average Duration**: Typical conversation length
  </Card>

  <Card title="Message Analytics" icon="message-circle">
    * **Total Messages**: Complete message exchange count
    * **Messages Per Session**: Average interaction depth
    * **Response Time**: Average agent response speed
    * **Success Rate**: Percentage of successful interactions
  </Card>

  <Card title="System Health" icon="shield">
    * **Agent Status**: Operational health indicator
    * **Index Status**: Knowledge base processing state
    * **Error Rate**: System reliability metrics
    * **Uptime**: Service availability percentage
  </Card>

  <Card title="Recent Activity" icon="clock">
    * **Last 7 Days**: Recent session and message counts
    * **Peak Hours**: Most active conversation times
    * **Daily Trends**: Usage pattern analysis
    * **Growth Indicators**: Performance improvement metrics
  </Card>
</CardGroup>

### Metric Interpretations

<AccordionGroup>
  <Accordion title="Understanding Session Data">
    **High Session Count**: Indicates strong user engagement and traffic
    **Low Session Count**: May suggest need for better promotion or placement
    **Active Sessions**: Shows real-time user engagement level
    **Session Duration**: Longer sessions typically indicate more complex queries or higher engagement
  </Accordion>

  <Accordion title="Message Analysis">
    **Messages Per Session**: Higher ratios suggest engaging conversations
    **Response Time**: Lower times indicate better user experience
    **Success Rate**: Measures how often agent provides helpful responses
    **Message Growth**: Indicates increasing user adoption
  </Accordion>

  <Accordion title="Health Monitoring">
    **Agent Status**: Green indicates optimal performance
    **Index Status**: Ensures knowledge base is functioning properly
    **Error Rates**: Low percentages indicate system stability
    **Uptime**: High percentages show reliable service availability
  </Accordion>
</AccordionGroup>

## Navigation and Control Features

### Primary Navigation

<CardGroup cols={2}>
  <Card title="Feature Access" icon="layers">
    Direct navigation to all major platform features and tools
  </Card>

  <Card title="Settings Management" icon="settings">
    Quick access to configuration options and preferences
  </Card>

  <Card title="Support Resources" icon="help-circle">
    Documentation, tutorials, and help system access
  </Card>

  <Card title="Account Controls" icon="user-settings">
    Profile management, billing, and subscription options
  </Card>
</CardGroup>

### Dashboard Customization

<AccordionGroup>
  <Accordion title="Widget Arrangement">
    * Drag and drop functionality for dashboard layout
    * Resize widgets based on importance and preference
    * Show/hide specific information panels
    * Save custom layouts for different use cases
  </Accordion>

  <Accordion title="Display Preferences">
    * Toggle between detailed and summary views
    * Customize color schemes and visual themes
    * Adjust information density and spacing
    * Configure notification display preferences
  </Accordion>

  <Accordion title="Data Refresh Settings">
    * Control automatic refresh intervals
    * Manual refresh options for real-time data
    * Configure which metrics update automatically
    * Set alert thresholds for important changes
  </Accordion>
</AccordionGroup>

## Dashboard Notifications

### Alert Types

<Steps>
  <Step title="System Alerts">
    Critical notifications about agent health, errors, or maintenance
  </Step>

  <Step title="Performance Notifications">
    Updates about usage limits, credit consumption, or performance changes
  </Step>

  <Step title="Configuration Reminders">
    Prompts to complete setup steps or update settings
  </Step>

  <Step title="Feature Announcements">
    Information about new capabilities and platform improvements
  </Step>
</Steps>

### Notification Management

<Note>
  Customize notification preferences in your profile settings to control which alerts appear on your dashboard.
</Note>

## Mobile Dashboard Experience

### Mobile Optimization

<CardGroup cols={2}>
  <Card title="Responsive Layout" icon="smartphone">
    Dashboard automatically adapts to mobile screen sizes
  </Card>

  <Card title="Touch Interface" icon="hand">
    Optimized controls for touch-based navigation
  </Card>

  <Card title="Quick Actions" icon="zap">
    Essential features accessible with minimal scrolling
  </Card>

  <Card title="Offline Indicators" icon="wifi-off">
    Clear status when internet connectivity is limited
  </Card>
</CardGroup>

### Mobile-Specific Features

* **Swipe Navigation**: Gesture-based movement between sections
* **Collapsible Panels**: Expandable sections to maximize screen space
* **Priority Information**: Most important metrics displayed prominently
* **Quick Settings**: Essential controls accessible from main screen

<Tip>
  The mobile dashboard prioritizes the most critical information and actions, ensuring you can manage your agent effectively from any device.
</Tip>