title: “Agent Dashboard” description: “Dashboard monitoring kesehatan semua AI agent — stats grid, failing agents alert, daily execution chart, dan recent runs.”

Agent Dashboard

Agent Dashboard memberikan pandangan menyeluruh tentang kesehatan dan performa semua AI agent dalam satu tampilan. Halaman ini dirancang untuk monitoring cepat — Anda bisa langsung melihat agen mana yang bermasalah tanpa harus membuka detail satu per satu.

Arsitektur Dashboard

Data Flow Pipeline

Stats Grid — 4 Kartu

Kartu	Sumber Data	Perhitungan
Total Agen	`AIAgent.list()`	Jumlah semua agen (aktif + nonaktif)
Agen Aktif	`AIAgent.list()`	Filter `is_active = true`
Total Eksekusi	`AIAgentRun.list()`	Count semua run
Success Rate	`AIAgentRun.list()`	`(success / total) × 100%`

Stats Computation Detail

Failing Agents Alert

Panel peringatan yang menampilkan agen dengan kegagalan berulang: Alert panel membantu mengidentifikasi agen yang perlu diperbaiki atau dimatikan sebelum menyebabkan masalah lebih lanjut.

Alert Threshold Configuration

Threshold	Failure Count	Severity	Action
Warning	3-5 failures	Orange	Investigate agent configuration
Critical	6-10 failures	Red	Disable agent, check system prompt
Emergency	>10 failures	Flashing Red	Immediate intervention required

Alert Resolution Flow

Daily Execution Chart

Grafik batang (Recharts BarChart) yang menampilkan jumlah eksekusi per hari:

Aspek	Detail
Tipe	BarChart vertikal
Sumbu X	Tanggal (hari)
Sumbu Y	Jumlah eksekusi
Data Source	`AIAgentRun.list()` — group by date
Filter	Periode waktu (7 hari, 30 hari, custom)

Chart Data Pipeline

Recent Runs List

Daftar eksekusi terbaru dengan informasi:

Kolom	Detail
Agent	Nama agen yang dijalankan
User	User yang menjalankan
Status	`success` (hijau) / `failed` (merah)
Waktu	Timestamp eksekusi
Biaya	`cost_amount` dalam Rupiah
Metode	`balance` / `credit` / `free`

Run Status Distribution

Entities Used

Entity	Role	Key Fields
AIAgent	Agent definitions	`agent_key`, `name`, `is_active`, `category`
AIAgentRun	Execution records	`agent_key`, `status`, `cost_amount`, `created_at`
AIAgentSchedule	Schedule configs	`trigger_type`, `last_triggered_at`, `notification_channel`
AIAgentTemplate	Template definitions	`system_prompt`, `price_per_run`, `model`

Cara Akses

Dari sidebar, klik menu AI & Analitik > Agent Dashboard.

Flow Penggunaan

Monitoring Best Practices

Praktik	Frekuensi	Metrik Target
Review success rate	Harian	> 90%
Cek failing agents	Harian	0 critical alerts
Analisis tren eksekusi	Mingguan	Stabil atau growing
Evaluasi biaya	Bulanan	Within budget
Audit agen tidak terpakai	Bulanan	Remove unused agents

Tips

Jadwalkan review dashboard mingguan untuk menjaga kualitas agen
Segera investigasi agen yang success rate-nya turun di bawah 80%
Bandingkan performa sebelum dan sesudah perubahan konfigurasi
Matikan agen yang tidak lagi diperlukan untuk menghemat kredit
Gunakan data daily execution untuk merencanakan kapasitas kredit bulanan

Diagram Relasi Entitas Agent Dashboard

Tabel Skema Entitas

AIAgent — Definisi Agen AI

Field	Tipe	Wajib	Default	Deskripsi
`agent_key`	string	Ya	—	Kunci unik agen (auto-generated slug dari nama)
`company_id`	string	Ya	—	ID perusahaan (scope company-level)
`created_by`	string	Ya	—	Email user yang membuat agen
`name`	string	Ya	—	Nama AI Agent
`tagline`	string	Tidak	—	Deskripsi singkat satu baris
`description`	string	Tidak	—	Penjelasan lengkap fungsi agen (maks 2000 karakter)
`category`	enum	Tidak	`"other"`	Kategori agen: `business`, `content`, `writing`, `social`, `other`
`icon`	string	Tidak	`"Sparkles"`	Nama icon lucide-react
`color`	string	Tidak	`"#4F46E5"`	Warna tema agen
`system_prompt`	string	Ya	—	Instruksi sistem utama untuk LLM (maks 4000 karakter)
`input_fields`	array	Tidak	—	Field input dinamis untuk agen (objek: key, label, type, placeholder, required)
`model`	string	Tidak	`"automatic"`	Model LLM default
`use_internet`	boolean	Tidak	`false`	Gunakan konteks internet
`status`	enum	Tidak	`"active"`	Status agen: `active` (jalan otomatis), `paused` (tidak otomatis tapi bisa manual), `inactive` (nonaktif)
`source_template_key`	string	Tidak	—	Link ke AIAgentTemplate asal jika dibuat dari template (nullable)
`run_count`	number	Tidak	`0`	Total eksekusi agen
`total_cost_amount`	number	Tidak	`0`	Total biaya Rupiah semua run
`total_cost_credit`	number	Tidak	`0`	Total kredit yang dipakai semua run
`created_date`	datetime	Tidak	—	Tanggal dibuat
`updated_date`	datetime	Tidak	—	Tanggal diperbarui terakhir

AIAgentRun — Catatan Eksekusi Agen

Field	Tipe	Wajib	Default	Deskripsi
`user_id`	string	Ya	—	ID user yang menjalankan
`user_email`	string	Tidak	—	Email user yang menjalankan
`company_id`	string	Tidak	—	ID perusahaan aktif (null untuk personal)
`company_name`	string	Tidak	—	Nama perusahaan saat agen dijalankan
`agent_key`	string	Ya	—	Kunci agen yang dijalankan
`agent_name`	string	Tidak	—	Nama agen saat run
`model_used`	string	Tidak	—	Model AI yang dipakai pada run ini
`model_name`	string	Tidak	—	Nama tampilan model yang dipakai
`input_data`	object	Tidak	—	Input yang diberikan user
`output`	string	Tidak	—	Hasil dari AI Agent (maks 100000 karakter)
`cost_amount`	number	Tidak	`0`	Biaya Rupiah yang dipotong
`cost_credit`	number	Tidak	`0`	Kredit yang dipotong
`payment_method`	enum	Tidak	`"balance"`	Metode pembayaran: `balance`, `credit`, `free`
`status`	enum	Tidak	`"success"`	Status eksekusi: `success`, `failed`

AIAgentSchedule — Jadwal & Trigger Agen

Field	Tipe	Wajib	Default	Deskripsi
`agent_id`	string	Ya	—	Referensi ke AIAgent (agent_key)
`company_id`	string	Ya	—	ID perusahaan
`trigger_type`	enum	Ya	—	Jenis trigger: `schedule_daily`, `schedule_weekly`, `schedule_monthly`, `event_low_stock`, `event_invoice_overdue`, `event_new_transaction`, `event_task_due`, `event_custom`
`trigger_config`	object	Tidak	—	Konfigurasi trigger. Schedule: `{hour, minute, day_of_week?, day_of_month?}`. Event: `{threshold?, product_category?, days_before?}`
`is_active`	boolean	Tidak	`true`	Apakah schedule/trigger aktif
`last_triggered_at`	datetime	Tidak	—	Waktu terakhir trigger fired
`trigger_count`	number	Tidak	`0`	Berapa kali trigger sudah fired
`notification_channel`	enum	Tidak	`"in_app"`	Channel notifikasi hasil agen: `in_app`, `whatsapp`, `email`, `all`
`created_by`	string	Ya	—	Email user yang membuat schedule
`created_date`	datetime	Tidak	—	Tanggal dibuat

AIAgentTemplate — Template Agen AI

Field	Tipe	Wajib	Default	Deskripsi
`agent_key`	string	Ya	—	Kunci unik template (contoh: `business_analysis`)
`name`	string	Ya	—	Nama AI Agent
`tagline`	string	Tidak	—	Deskripsi singkat satu baris
`description`	string	Tidak	—	Penjelasan lengkap fungsi agen (maks 2000 karakter)
`category`	enum	Tidak	`"other"`	Kategori: `business`, `content`, `writing`, `social`, `other`
`icon`	string	Tidak	`"Sparkles"`	Nama icon lucide-react
`color`	string	Tidak	`"#3b82f6"`	Warna tema template
`price_per_run`	number	Tidak	`5000`	Biaya per penggunaan dalam Rupiah
`credit_cost`	number	Tidak	`1`	Biaya alternatif dalam kredit AI bila saldo tidak cukup
`features`	array[string]	Tidak	—	Daftar fitur utama
`use_cases`	array[string]	Tidak	—	Daftar kasus penggunaan
`input_fields`	array[object]	Tidak	—	Field input yang diminta dari user (key, label, type, placeholder, required)
`system_prompt`	string	Tidak	—	Instruksi sistem untuk LLM (maks 4000 karakter)
`model`	string	Tidak	`"automatic"`	Model LLM yang dipakai
`use_internet`	boolean	Tidak	`false`	Gunakan konteks internet
`status`	enum	Tidak	`"active"`	Status: `active`, `coming_soon`, `inactive`
`order`	number	Tidak	`0`	Urutan tampilan

AIAgentModel — Daftar Model AI

Field	Tipe	Wajib	Default	Deskripsi
`model_key`	string	Ya	—	Kunci model untuk InvokeLLM (contoh: `automatic`, `gpt_5_mini`, `claude_sonnet_4_6`)
`name`	string	Ya	—	Nama tampilan model (contoh: `Standar (Cepat & Hemat)`)
`description`	string	Tidak	—	Penjelasan singkat kualitas/kecepatan model (maks 500 karakter)
`price_multiplier`	number	Tidak	`1`	Pengali biaya. Biaya akhir = harga dasar agen x multiplier
`tier`	enum	Tidak	`"standard"`	Tingkatan kualitas model: `standard`, `advanced`, `premium`
`supports_internet`	boolean	Tidak	`false`	Model mendukung konteks internet
`is_active`	boolean	Tidak	`true`	Model aktif digunakan
`order`	number	Tidak	`0`	Urutan tampilan

AIAgentSettings — Pengaturan Global AI Agent

Field	Tipe	Wajib	Default	Deskripsi
`setting_key`	string	Ya	`"global"`	Kunci pengaturan (selalu `global` untuk pengaturan utama)
`description`	string	Tidak	—	Catatan pengaturan AI Agent (maks 1000 karakter)
`credit_to_rupiah_rate`	number	Tidak	`10`	Nilai 1 kredit dalam Rupiah (misal: 10 berarti 1 kredit = Rp10)
`base_price_per_run`	number	Tidak	`1000`	Harga dasar default per penggunaan dalam Rupiah bila agen tidak set harga sendiri
`allow_credit_payment`	boolean	Tidak	`true`	Izinkan user membayar dengan kredit
`allow_balance_payment`	boolean	Tidak	`true`	Izinkan user membayar dengan saldo Rupiah

Siklus Hidup Monitoring Agen

Diagram Urutan — Pemuatan Data Dashboard

Diagram Urutan — Pelacakan Performa Agen

Diagram Urutan — Eksekusi Agen dan Pencatatan Biaya

Tabel Referensi Enum

Kategori Agen (`AIAgent.category` / `AIAgentTemplate.category`)

Nilai	Deskripsi
`business`	Agen terkait analisis bisnis, laporan keuangan, dan operasional
`content`	Agen pembuat konten pemasaran, blog, dan media sosial
`writing`	Agen untuk penulisan dokumen, surat, dan naskah
`social`	Agen untuk manajemen media sosial dan interaksi sosial
`other`	Kategori umum untuk agen lainnya

Status Agen (`AIAgent.status`)

Nilai	Deskripsi	Perilaku
`active`	Agen aktif dan berjalan	Bisa dijalankan otomatis (schedule/event) dan manual
`paused`	Agen dijeda sementara	Tidak bisa dijalankan otomatis, masih bisa dijalankan manual
`inactive`	Agen dinonaktifkan	Tidak bisa dijalankan sama sekali

Status Template (`AIAgentTemplate.status`)

Nilai	Deskripsi
`active`	Template tersedia dan bisa digunakan
`coming_soon`	Template akan datang, belum bisa digunakan
`inactive`	Template dinonaktifkan

Status Eksekusi (`AIAgentRun.status`)

Nilai	Deskripsi	Tampilan
`success`	Eksekusi berhasil selesai	Badge hijau
`failed`	Eksekusi gagal (error/timeout)	Badge merah

Metode Pembayaran (`AIAgentRun.payment_method`)

Nilai	Deskripsi
`balance`	Dibayar dari saldo Rupiah perusahaan
`credit`	Dibayar dari kredit AI
`free`	Gratis (tidak ada pemotongan)

Jenis Trigger (`AIAgentSchedule.trigger_type`)

Nilai	Kategori	Deskripsi
`schedule_daily`	Jadwal	Trigger setiap hari pada waktu tertentu
`schedule_weekly`	Jadwal	Trigger setiap minggu pada hari dan waktu tertentu
`schedule_monthly`	Jadwal	Trigger setiap bulan pada tanggal dan waktu tertentu
`event_low_stock`	Event	Trigger saat stok produk rendah
`event_invoice_overdue`	Event	Trigger saat ada faktur jatuh tempo
`event_new_transaction`	Event	Trigger saat ada transaksi baru
`event_task_due`	Event	Trigger saat ada tugas yang mendekati tenggat
`event_custom`	Event	Trigger event kustom yang dikonfigurasi sendiri

Channel Notifikasi (`AIAgentSchedule.notification_channel`)

Nilai	Deskripsi
`in_app`	Notifikasi di dalam aplikasi
`whatsapp`	Notifikasi via WhatsApp
`email`	Notifikasi via email
`all`	Semua channel notifikasi

Tier Model (`AIAgentModel.tier`)

Nilai	Deskripsi	Karakteristik
`standard`	Model standar	Cepat dan hemat, cocok untuk tugas sederhana
`advanced`	Model lanjutan	Keseimbangan antara kualitas dan kecepatan
`premium`	Model premium	Kualitas tertinggi, cocok untuk tugas kompleks

Tabel RBAC — Hak Akses Agent Dashboard

Role	Lihat Dashboard	Lihat Semua Agen	Jalankan Agen	Kelola Jadwal	Kelola Pengaturan	Hapus Agen
Super Admin	Ya	Ya	Ya	Ya	Ya	Ya
Admin Perusahaan	Ya	Ya (perusahaan)	Ya	Ya	Ya	Ya
Manajer	Ya	Ya (perusahaan)	Ya	Ya	Tidak	Tidak
Staff	Ya	Ya (perusahaan)	Ya	Tidak	Tidak	Tidak
Viewer	Ya	Ya (perusahaan)	Tidak	Tidak	Tidak	Tidak

Catatan RBAC

Super Admin: Akses penuh ke semua agen di seluruh perusahaan
Admin Perusahaan: Akses penuh dalam scope perusahaan yang dikelola
Manajer: Bisa menjalankan agen dan mengelola jadwal, tetapi tidak bisa mengubah pengaturan global atau menghapus agen
Staff: Hanya bisa menjalankan agen yang diizinkan, tidak bisa mengelola jadwal
Viewer: Hanya bisa melihat dashboard dan data agen, tidak bisa menjalankan atau mengubah apapun
Semua role tunduk pada Row-Level Security (RLS) berdasarkan company_id

Related Documentation:

​title: “Agent Dashboard” description: “Dashboard monitoring kesehatan semua AI agent — stats grid, failing agents alert, daily execution chart, dan recent runs.”

​Agent Dashboard

​Arsitektur Dashboard

​Data Flow Pipeline

​Stats Grid — 4 Kartu

​Stats Computation Detail

​Failing Agents Alert

​Alert Threshold Configuration

​Alert Resolution Flow

​Daily Execution Chart

​Chart Data Pipeline

​Recent Runs List

​Run Status Distribution

​Entities Used

​Cara Akses

​Flow Penggunaan

​Monitoring Best Practices

​Tips

​Diagram Relasi Entitas Agent Dashboard

​Tabel Skema Entitas

​AIAgent — Definisi Agen AI

​AIAgentRun — Catatan Eksekusi Agen

​AIAgentSchedule — Jadwal & Trigger Agen

​AIAgentTemplate — Template Agen AI

​AIAgentModel — Daftar Model AI

​AIAgentSettings — Pengaturan Global AI Agent

​Siklus Hidup Monitoring Agen

​Diagram Urutan — Pemuatan Data Dashboard

​Diagram Urutan — Pelacakan Performa Agen

​Diagram Urutan — Eksekusi Agen dan Pencatatan Biaya

​Tabel Referensi Enum

​Kategori Agen (AIAgent.category / AIAgentTemplate.category)

​Status Agen (AIAgent.status)

​Status Template (AIAgentTemplate.status)

​Status Eksekusi (AIAgentRun.status)

​Metode Pembayaran (AIAgentRun.payment_method)

​Jenis Trigger (AIAgentSchedule.trigger_type)

​Channel Notifikasi (AIAgentSchedule.notification_channel)

​Tier Model (AIAgentModel.tier)

​Tabel RBAC — Hak Akses Agent Dashboard

​Catatan RBAC