Vizra.ai |

Documentation

๐Ÿ–ฅ๏ธ

Web Dashboard

Your command center for AI agents! ๐ŸŽฎ The Vizra ADK comes with a beautiful web dashboard that lets you monitor, test, and manage your agentsโ€”all from your browser. No terminal required!

๐ŸŽฏ What's the Web Dashboard?

The web dashboard is a Livewire-powered interface that ships with the Vizra ADK package. It provides real-time monitoring, interactive testing, and management capabilities for your agentsโ€”all through your browser! ๐ŸŒ

๐Ÿ“Š Real-time Monitoring

Live agent stats, system health, and activity tracking

๐Ÿ’ฌ Interactive Testing

Chat with your agents directly from the browser

๐Ÿงช Evaluation Runner

Run and visualize evaluation results with ease

๐Ÿš€ Quick Commands

Copy-ready artisan commands for rapid development

๐Ÿš€ Accessing the Dashboard

By default, the web dashboard is accessible at the /vizra route of your Laravel application:

The dashboard URL will be displayed after running the installation command.

๐Ÿงฉ Dashboard Components

๐Ÿ“Š Main Dashboard

The main dashboard provides an overview of your Vizra ADK installation:

  • โ€ข
    Package Information: Current version and configuration status
  • โ€ข
    Agent Registry: Live display of all registered agents
  • โ€ข
    Quick Commands: Copy-ready artisan commands for common tasks
  • โ€ข
    System Status: Health indicators and configuration checks

๐Ÿ’ฌ Chat Interface

The chat interface allows interactive testing of your agents:

Features include:

  • โœ“ Real-time streaming responses
  • โœ“ Session management
  • โœ“ Message history
  • โœ“ Agent selection dropdown

๐Ÿงช Evaluation Runner

The evaluation runner provides a visual interface for running and monitoring evaluations:

โš™๏ธ Configuration

The web dashboard can be configured in your config/vizra.php file:

'routes' => [
    'web' => [
        'enabled' => env('VIZRA_WEB_ENABLED', true),
        'prefix' => 'vizra',
        'middleware' => ['web'],
    ],
],

๐Ÿšซ Disabling the Dashboard

To disable the web dashboard in production:

# Disable web dashboard
VIZRA_WEB_ENABLED=false

๐Ÿ”— Custom Route Prefix

To change the dashboard URL prefix:

'routes' => [
    'web' => [
        'prefix' => 'ai-dashboard', // Now accessible at /ai-dashboard
    ],
],

๐Ÿ” Adding Authentication

To protect the dashboard with authentication:

'routes' => [
    'web' => [
        'middleware' => ['web', 'auth'], // Requires authentication
    ],
],

๐Ÿ—บ๏ธ Dashboard Routes

The web dashboard registers the following routes:

Route Description
/vizra Main dashboard overview
/vizra/chat Interactive agent testing
/vizra/eval Evaluation runner interface

๐Ÿ’ป Dashboard Command

The vizra:dashboard command provides quick access:

# Display dashboard URL
php artisan vizra:dashboard

# Open dashboard in browser
php artisan vizra:dashboard --open

๐Ÿ”’ Security Considerations

โš ๏ธ

Important Security Notes

  • โ€ข Always protect the dashboard with authentication in production
  • โ€ข Consider IP whitelisting for sensitive environments
  • โ€ข Disable the dashboard entirely if not needed (VIZRA_WEB_ENABLED=false)
  • โ€ข Use HTTPS in production environments

๐ŸŽ‰ Ready to Explore?

Now that you understand the web dashboard, dive deeper into:

Ready for Professional AI Agent Evaluation? ๐Ÿš€

Evaluate and debug your Vizra ADK agents with professional cloud tools. Get early access to Vizra Cloud and be among the first to experience advanced evaluation and trace analysis at scale.

Cloud evaluation runs
Trace visualization
Team collaboration

Join other developers already on the waitlist. No spam, just launch updates.