Skip to content

Admin Panel Guide

Jump to bottom
Ömer Tarık Yılmaz edited this page Apr 5, 2026 · 1 revision

Admin Panel Guide

The White-Ops admin panel is a full-featured web interface for managing agents, tasks, workflows, workers, and system configuration. It is served at http://localhost:3000 by default.

This guide covers all 21 pages organized into four sections: Main, Intelligence, Operations, and System.

Table of Contents

Main Section

Dashboard

Page: Dashboard.tsx

The landing page after login. Provides an at-a-glance overview of the entire platform.

KPI Cards:

  • Total Agents (active / idle / stopped)
  • Total Tasks (pending / in progress / completed / failed)
  • Active Workers (online / offline)
  • Success Rate (percentage of completed vs. failed tasks)

Charts:

  • Task completion over time (line chart, 7/30/90-day views)
  • Agent utilization (bar chart, tasks per agent)
  • Task status distribution (pie/donut chart)

System Health:

  • Worker CPU / RAM / disk usage gauges
  • API server response time
  • Redis and PostgreSQL connection status
  • Recent error count

Real-time Updates: The dashboard subscribes to WebSocket events and updates KPI cards and charts live as tasks complete, agents change state, or workers report metrics.

Agents

Page: Agents.tsx | Detail: AgentDetail.tsx

Manage all AI agents in the system.

Table View:

Column Description
Name Agent display name
Status active, idle, stopped, error
LLM Provider Anthropic, OpenAI, Google, Ollama
Model Specific model (e.g., claude-sonnet-4-20250514)
Tools Number of assigned tools
Tasks Completed Lifetime count
Created Timestamp
Actions Start, Stop, Edit, Delete

CRUD Operations:

  • Create: Name, description, LLM provider/model, tool selection (multi-select from 55 tools), optional system prompt override
  • Read: Click a row to open the Agent Detail page with full configuration, task history, and performance metrics
  • Update: Edit any field, reassign tools, change LLM model
  • Delete: Soft-delete with confirmation dialog

Start / Stop:

  • Start activates the agent so it can receive task assignments
  • Stop gracefully deactivates the agent; in-progress tasks complete before stopping

Tasks

Page: Tasks.tsx | Detail: TaskDetail.tsx

View and manage all tasks across the platform.

Filters:

Filter Options
Status pending, in_progress, completed, failed, cancelled
Priority low, medium, high, critical
Agent Dropdown of all agents
Date Range Start and end date pickers
Search Full-text search on title and description

Task List Columns: Title, Status (color-coded badge), Priority, Assigned Agent, Created, Duration, Actions.

Create Task Form:

  • Title (required)
  • Description / Instructions (Markdown supported)
  • Assign to Agent (dropdown)
  • Priority level
  • Required Tools (optional override)
  • Scheduled start time (optional)
  • Attachments (file upload)

Task Detail Page:

  • Full task configuration
  • Execution timeline with timestamps
  • Agent's step-by-step reasoning and tool calls
  • Tool execution results
  • Final output / result
  • Error details (if failed)
  • Attached files

Workflows

Page: Workflows.tsx

List and manage multi-step workflows.

List View:

Column Description
Name Workflow name
Steps Number of steps in the workflow
Status draft, active, paused, completed
Last Run Timestamp of most recent execution
Runs Total execution count
Actions Run, Edit, Duplicate, Delete

Builder Link: Click Edit or Create Workflow to open the Workflow-Builder, a visual DAG editor for designing multi-step workflows.

Run: Execute a workflow manually. The system creates tasks for each step and manages dependencies according to the workflow DAG.

Messages

Page: Messages.tsx

View agent-to-agent communication threads.

Features:

  • Thread-based view grouped by conversation
  • Sender and recipient agent names with avatars
  • Timestamp and message content preview
  • Filter by agent, date range, or search text
  • Message detail view with full content
  • Related task links (if message was sent during task execution)

Messages are generated when agents communicate during collaboration sessions or when a task explicitly instructs an agent to coordinate with another agent.

Files

Page: Files.tsx

Browse and manage files stored in MinIO.

Features:

  • File list with name, size, MIME type, uploader (agent or user), upload date
  • Download individual files
  • Preview support for common formats (text, images, PDF)
  • Upload new files manually
  • Filter by file type, agent, or date range
  • Delete files (admin only)
  • Bulk operations (download selected, delete selected)

Files are created by agents during task execution (e.g., generated reports, exported data, downloaded content) or uploaded manually by users.

Intelligence Section

Collaboration

Page: Collaboration.tsx

Manage multi-agent collaboration sessions where multiple agents work together on complex tasks.

Features:

  • Session List: View active and completed collaboration sessions
  • Create Session: Define a goal, select participating agents, set coordination rules
  • Session Detail:
    • Shared workspace view showing all agents' contributions
    • Real-time message stream between collaborating agents
    • Task delegation history (which agent handled what)
    • Final consolidated output
  • Session Status: active, completed, paused, failed

Knowledge Base

Page: Knowledge.tsx

A searchable repository of information that agents can reference during task execution.

Features:

  • Search: Full-text search across all entries with relevance ranking
  • Categories: Organize entries by topic (e.g., Company Policies, Technical Docs, FAQs, Procedures)
  • Create Entry: Title, content (Markdown), category, tags
  • Edit / Delete: Manage existing entries
  • Agent Access: Agents query the knowledge base during task execution for context and reference material
  • Import: Bulk import from files (Markdown, text, PDF)

Analytics

Page: Analytics.tsx

Detailed performance metrics and insights.

Sections:

Task Success Rate:

  • Overall success/failure percentage
  • Trend over time (line chart)
  • Breakdown by priority level
  • Failure reason categorization

Agent Performance:

  • Tasks completed per agent
  • Average task duration per agent
  • Success rate per agent
  • Tool usage frequency per agent
  • LLM token consumption per agent

Worker Utilization:

  • CPU / RAM / disk usage over time
  • Tasks processed per worker
  • Agent capacity vs. actual usage
  • Uptime percentage per worker

Time Range: Selectable: 24 hours, 7 days, 30 days, 90 days, custom range.

Activity Feed

Page: ActivityFeed.tsx

A chronological event log of everything happening in the system.

Event Types:

Event Description
agent.status Agent started, stopped, or changed state
task.created New task created
task.updated Task status or details changed
task.completed Task finished successfully
task.failed Task execution failed
worker.online Worker connected to the master
worker.offline Worker lost connection or stopped
message.new New agent-to-agent message
notification System notification
system.alert System-level alert (high resource usage, errors)

Features:

  • Real-time streaming via WebSocket
  • Filter by event type, agent, worker, or date range
  • Search within event details
  • Click any event to see full context (links to related task, agent, or worker)
  • Auto-scroll with pause on hover

Operations Section

Schedules

Page: ScheduledTasks.tsx

Create and manage recurring or time-delayed tasks.

Features:

  • Schedule List: Name, cron expression (human-readable), next run time, last run, status (active/paused)
  • Create Schedule:
    • Name and description
    • Task template selection (or create inline)
    • Cron expression with visual helper (e.g., "Every weekday at 9am")
    • Assigned agent
    • Enable / disable toggle
  • Edit / Delete: Modify schedule parameters or remove
  • Run Now: Trigger a scheduled task immediately
  • History: View past executions and their outcomes

Templates

Page: TaskTemplates.tsx

Reusable task configurations that can be used to create tasks quickly.

Features:

  • Template List: Name, description, default agent, tools, usage count
  • Create Template:
    • Name and description
    • Default task instructions (with placeholder variables)
    • Default agent assignment
    • Default priority
    • Required tools
    • Default attachments
  • Use Template: Click to create a new task pre-filled from the template
  • Edit / Duplicate / Delete: Manage templates
  • Variables: Templates support {{variable}} placeholders that are filled in at task creation time

Agent Presets

Page: AgentPresets.tsx

12 pre-configured agent profiles for common use cases. Each preset defines a name, description, system prompt, LLM configuration, and tool set.

Preset Description Key Tools
Research Analyst Web research and summarization web_search, scraper, summarizer, notes
Content Writer Creates documents, articles, reports word, notes, summarizer, translator
Data Analyst Processes and visualizes data excel, data_analysis, visualization, reporter
Email Manager Handles email triage and responses email_internal, email_external, calendar, notification
DevOps Engineer Infrastructure and code operations shell, docker_ops, git_ops, api_caller
Project Manager Tracks projects and coordinates work project_tracker, task_tracker, time_tracker, calendar
Finance Clerk Invoicing, expenses, bookkeeping invoice, expense_report, bookkeeping, tax_calculator
HR Assistant Employee directory, leave, payroll employee_directory, leave_manager, payroll
Customer Support CRM and communication crm, email_external, notification, knowledge_base
Document Processor PDF, OCR, file management pdf, ocr, file_manager, converter
Integration Specialist Connects external services github, jira, slack, notion, webhook
General Assistant Broad tool access for any task 15+ tools across multiple categories

Click Use Preset to create a new agent with the preset's configuration pre-filled.

System Section

Workers

Page: Workers.tsx

Monitor and manage the worker fleet.

Worker List:

Column Description
Name Worker hostname / name
Status online, offline, pending_approval
IP Address Network address
CPU Current usage percentage + core count
RAM Current usage + total MB
Disk Current usage percentage
Agents Active / max agent capacity
Uptime Time since last registration
Actions Approve, Remove

Monitoring Gauges:

  • Real-time CPU, RAM, and disk usage gauges per worker
  • Updated every 30 seconds via heartbeat data
  • Color-coded thresholds (green < 60%, yellow 60-80%, red > 80%)

Approval Process:

  • New workers register with status pending_approval
  • An admin must click Approve before the worker can receive tasks
  • This prevents unauthorized machines from joining the fleet

See Worker-Management for detailed worker administration.

Users

Page: UserManagement.tsx

Manage user accounts and role-based access control (RBAC).

User List: Email, name, role, status (active/disabled), last login, created date.

Create / Edit User: Email, password, display name, role assignment.

RBAC Permissions Table:

Permission Admin Operator Viewer
agents:create Yes Yes --
agents:read Yes Yes Yes
agents:update Yes Yes --
agents:delete Yes -- --
tasks:create Yes Yes --
tasks:read Yes Yes Yes
tasks:update Yes Yes --
tasks:delete Yes -- --
workflows:create Yes Yes --
workflows:read Yes Yes Yes
workflows:update Yes Yes --
workflows:delete Yes -- --
users:create Yes -- --
users:read Yes -- --
users:update Yes -- --
users:delete Yes -- --
workers:read Yes Yes Yes
workers:approve Yes -- --
workers:remove Yes -- --
files:read Yes Yes Yes
files:upload Yes Yes --
files:delete Yes -- --
messages:read Yes Yes Yes
settings:read Yes -- --
settings:update Yes -- --
audit:read Yes -- --

Audit Log

Page: AuditLog.tsx

A tamper-evident log of all significant actions in the system.

Logged Events:

  • User logins and logouts
  • Agent create / update / delete / start / stop
  • Task create / update / cancel
  • Workflow create / update / delete / execute
  • Worker approve / remove
  • User create / update / delete
  • Settings changes
  • File uploads and deletions

Filters:

Filter Options
Action Type CRUD operations, auth events, system events
User Who performed the action
Resource Type Agent, task, workflow, worker, user, settings, file
Date Range Start and end date
Search Free-text search on event details

Columns: Timestamp, User, Action, Resource Type, Resource ID, Details (expandable JSON), IP Address.

Settings

Page: Settings.tsx

System-wide configuration organized into six categories.

1. LLM Configuration

Setting Description
Default Provider anthropic, openai, google, ollama
Default Model Model identifier for the selected provider
API Keys Anthropic, OpenAI, Google API keys (masked)
Ollama URL Base URL for local Ollama instance
Temperature Default LLM temperature (0.0 - 1.0)
Max Tokens Default max tokens per response

2. Email Configuration

Setting Description
Internal Mail Domain Domain for agent email addresses
SMTP Host / Port External SMTP server for outbound email
SMTP Credentials Username and password
SMTP From Address Default sender address
IMAP Host / Port Inbound email server
IMAP Credentials Username and password

3. Security

Setting Description
JWT Expiration Token lifetime in minutes
Rate Limit Requests per minute per IP
Session Timeout Inactive session timeout
Password Policy Minimum length, complexity requirements

4. General

Setting Description
App Name Display name for the platform
Environment production, development, staging
Debug Mode Enable/disable debug logging
CORS Origins Allowed frontend origins

5. Notifications

Setting Description
Task Completion Notify on task complete/fail
Worker Alerts Notify on worker online/offline
System Alerts Notify on high resource usage
Notification Channels WebSocket, email, or both

6. Storage

Setting Description
MinIO Endpoint S3-compatible storage URL
MinIO Bucket Default file bucket name
Max File Size Upload size limit
Retention Policy Auto-delete files after N days

Clone this wiki locally