> ## 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.

# Dashboard Overview

> Comprehensive overview of your Ravvio dashboard and its components

## Dashboard Introduction

Your Ravvio dashboard provides a comprehensive view of your AI agent's performance and setup progress, serving as the central hub for managing all aspects of your chatbot platform.

<img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/dashboard-overview.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=1d4770277748d34711c4fd289ae0b4be" alt="Main dashboard interface showing welcome section, agent status, and progress tracker" width="1906" height="857" data-path="images/dashboard-overview.png" />

### Dashboard Purpose

The dashboard is designed to:

<CardGroup cols={2}>
  <Card title="Monitor Progress" icon="progress">
    Track your agent configuration and setup completion status
  </Card>

  <Card title="Performance Insights" icon="chart-bar">
    View key metrics and analytics about your agent's performance
  </Card>

  <Card title="Quick Actions" icon="zap">
    Access frequently used features and tools efficiently
  </Card>

  <Card title="System Health" icon="heart">
    Monitor your agent's operational status and system health
  </Card>
</CardGroup>

## Main Dashboard Components

### Welcome Section

Your dashboard begins with a personalized welcome area featuring:

<AccordionGroup>
  <Accordion title="Personalized Greeting">
    * Welcome message with your name
    * Current date and time display
    * Contextual information about your account status
  </Accordion>

  <Accordion title="Agent Status Overview">
    * Quick view of your AI agent's current state
    * Setup completion indicators
    * Operational health status
  </Accordion>

  <Accordion title="Progress Tracking">
    * Visual representation of setup completion
    * Step-by-step configuration guidance
    * Achievement indicators and milestones
  </Accordion>
</AccordionGroup>

### Agent Information Card

Central display of your AI agent details:

<img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/dashboard-agent-status.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=03518380035f3ac325e066b294df5e84" alt="Agent information card with operational status" width="1599" height="646" data-path="images/dashboard-agent-status.png" />

| Information           | Purpose                             | Actions Available      |
| --------------------- | ----------------------------------- | ---------------------- |
| **Agent Name**        | Display configured agent identity   | Quick edit option      |
| **Unique Agent ID**   | Integration and tracking identifier | Copy to clipboard      |
| **Setup Status**      | Configuration completion indicator  | View detailed progress |
| **Operational State** | Real-time agent health status       | Access diagnostics     |

<Note>
  Your agent ID is crucial for website integration. Keep this identifier secure and accessible.
</Note>

### Setup Progress Tracker

Visual tracking of your agent configuration with four key areas:

<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 with completion indicators" width="532" height="489" data-path="images/dashboard-progress-tracker.png" />

<Steps>
  <Step title="System Prompt Configuration">
    **Purpose**: Customize AI behavior and personality
    **Status**: Shows completion percentage
    **Action**: Direct link to system prompt editor
  </Step>

  <Step title="Knowledge Base">
    **Purpose**: Upload and manage training documents
    **Status**: Document count and processing status
    **Action**: Quick access to document upload
  </Step>

  <Step title="Agent Name Customization">
    **Purpose**: Personalize your agent's identity
    **Status**: Default vs. customized name indicator
    **Action**: Inline name editing capability
  </Step>

  <Step title="Integration Readiness">
    **Purpose**: Prepare for website embedding
    **Status**: Deployment readiness assessment
    **Action**: Generate integration code
  </Step>
</Steps>

## Performance Metrics

### Key Statistics Display

<CardGroup cols={2}>
  <Card title="Total Sessions" icon="users">
    All-time conversation count with your AI agent
  </Card>

  <Card title="Active Sessions" icon="activity">
    Currently ongoing conversations
  </Card>

  <Card title="Total Messages" icon="message-circle">
    Complete message exchange count
  </Card>

  <Card title="Recent Activity" icon="trending-up">
    Sessions and interactions in the last 7 days
  </Card>
</CardGroup>

### Performance Indicators

<AccordionGroup>
  <Accordion title="Engagement Metrics">
    * Average messages per conversation
    * Session duration statistics
    * User return rate indicators
    * Conversation completion rates
  </Accordion>

  <Accordion title="System Health">
    * Agent response time performance
    * Knowledge base index status
    * System uptime and availability
    * Error rate and resolution tracking
  </Accordion>

  <Accordion title="Usage Trends">
    * Daily and weekly usage patterns
    * Peak activity time identification
    * Seasonal trend analysis
    * Growth trajectory indicators
  </Accordion>
</AccordionGroup>

## Navigation and Layout

### Dashboard Layout Structure

The dashboard follows a logical layout hierarchy:

1. **Header Section**: Navigation, user controls, and quick actions
2. **Welcome Area**: Personalized greeting and high-level status
3. **Progress Section**: Configuration completion tracking
4. **Metrics Area**: Performance statistics and indicators
5. **Quick Actions**: Tabbed interface for common tasks

### Responsive Design

<Tip>
  The dashboard automatically adapts to different screen sizes, ensuring optimal experience on desktop, tablet, and mobile devices.
</Tip>

#### Desktop Experience

* Full-width layout with multiple columns
* Expanded navigation and menu options
* Detailed statistics and charts display
* Comprehensive quick action panels

#### Mobile Experience

* Single-column responsive layout
* Collapsible navigation menus
* Touch-optimized interface elements
* Swipeable tabs and sections

## Dashboard Customization

### Personalization Options

<CardGroup cols={2}>
  <Card title="Display Preferences" icon="eye">
    Customize information density and layout preferences
  </Card>

  <Card title="Notification Settings" icon="bell">
    Control dashboard alerts and update notifications
  </Card>

  <Card title="Quick Actions" icon="settings">
    Organize frequently used tools and features
  </Card>

  <Card title="Theme Options" icon="palette">
    Adjust visual appearance and color schemes
  </Card>
</CardGroup>

### Widget Organization

Arrange dashboard components based on your workflow:

* **Drag and Drop**: Reorganize sections to match your priorities
* **Show/Hide Widgets**: Display only relevant information
* **Size Adjustment**: Customize widget dimensions for optimal viewing
* **Default Layouts**: Reset to standard configuration when needed

<Warning>
  Some dashboard elements cannot be moved or hidden as they contain critical system information.
</Warning>

## Dashboard Performance

### Loading and Responsiveness

The dashboard is optimized for:

* **Fast Initial Load**: Critical information appears immediately
* **Progressive Enhancement**: Additional details load in background
* **Real-time Updates**: Key metrics refresh automatically
* **Efficient Navigation**: Smooth transitions between sections

### Data Refresh

<AccordionGroup>
  <Accordion title="Automatic Updates">
    * Key metrics refresh every 5 minutes
    * Status indicators update in real-time
    * Notifications appear instantly
    * Background sync maintains data freshness
  </Accordion>

  <Accordion title="Manual Refresh">
    * Refresh button available for immediate updates
    * Individual widget refresh options
    * Full dashboard reload capability
    * Force sync for troubleshooting
  </Accordion>
</AccordionGroup>

## Getting Started Tips

### First-Time Users

<Steps>
  <Step title="Take the Tour">
    Complete the welcome tour to understand key features and navigation
  </Step>

  <Step title="Review Progress">
    Check your setup progress and prioritize incomplete configurations
  </Step>

  <Step title="Explore Metrics">
    Familiarize yourself with available statistics and their meanings
  </Step>

  <Step title="Test Features">
    Use quick actions to access and test various platform capabilities
  </Step>
</Steps>

### Optimization Recommendations

<Tip>
  Focus on completing setup steps in order to maximize your dashboard's usefulness and your agent's performance.
</Tip>

* **Complete System Prompt**: Essential for agent behavior
* **Upload Knowledge Base**: Enables accurate responses
* **Customize Agent Name**: Improves brand consistency
* **Test Integration**: Verify deployment readiness

<Note>
  The dashboard becomes more useful as you complete setup steps and begin using your AI agent actively.
</Note>