title: “AI Agent” description: “Daftar agen AI SNISHOP ERP — status, konfigurasi, toggle aktif/nonaktif, dan monitoring performa real-time.”

AI Agent

Halaman AI Agent menampilkan daftar semua agen yang terdaftar di sistem. Dari sini Anda bisa melihat status setiap agen, melakukan konfigurasi dasar, memantau performa, dan mengaktifkan atau menonaktifkan agen kapan saja tanpa mengganggu operasional sistem lainnya.

Gambaran Halaman

Component Hierarchy

AgentCard (91 baris)

Setiap agen ditampilkan sebagai kartu dengan informasi:

Elemen	Detail
Icon	Lucide icon sesuai konfigurasi (24 ikon tersedia)
Nama	Nama agen
Tagline	Deskripsi singkat satu baris
Kategori	Badge kategori berwarna
Status	Aktif (hijau) / Nonaktif (abu) / Coming Soon (kuning)
Harga	`price_per_run` dalam Rupiah
Link	Navigasi ke `/AIAgentDetail?key={agent_key}`

AgentCard Visual States

Status Agen

Status	Warna	Deskripsi
Active	Hijau	Agen siap dijalankan
Coming Soon	Kuning	Agen dalam pengembangan
Inactive	Abu-abu	Agen dinonaktifkan

Kategori

Kategori	Deskripsi	Contoh Penggunaan
Business	Analisis bisnis dan keuangan	Laporan laba rugi, analisis KPI, health score
Content	Generate konten produk	Deskripsi produk, marketing copy
Writing	Penulisan dan editing	Artikel, email, proposal
Social	Konten media sosial	Post Instagram, TikTok, WhatsApp
Other	Kegunaan umum	Custom agent untuk berbagai keperluan

Toggle Aktif/Nonaktif

Agen custom bisa diaktifkan atau dinonaktifkan kapan saja:

Toggle Impact Analysis

Aspect	Active	Inactive
Execution	Can be run manually	Cannot be run
Scheduled Runs	Execute on schedule	Paused
Visibility	Full card (green badge)	Dimmed card (gray badge)
API Access	Available	Blocked
Cost	Incurs cost per run	No cost

Pencarian

Cmd/Ctrl+K Search

Shortcut keyboard untuk pencarian cepat:

Aspek	Detail
Trigger	Tekan `Cmd+K` (Mac) atau `Ctrl+K` (Windows)
Scope	Nama agen, tagline, deskripsi
Filter	Real-time saat mengetik
Navigasi	Arrow keys + Enter untuk memilih

Search Algorithm

Tab kategori untuk memfilter agen berdasarkan jenis:

Scheduled Execution on Load

Setiap kali halaman dibuka, sistem otomatis menjalankan agen yang jadwalnya sudah jatuh tempo:

Schedule Due Date Logic

Monitoring Performa

Indikator performa yang ditampilkan:

Metrik	Sumber
Status terakhir	`AIAgentRun.status` terbaru
Terakhir dijalankan	`AIAgentRun.created_at` terbaru
Success rate	Rasio success/total dari `AIAgentRun`
Biaya total	Sum `cost_amount` dari `AIAgentRun`

Performance Metrics Computation

Entities Used

Entity	Role	Key Fields
AIAgentTemplate	Template definitions	`agent_key`, `name`, `category`, `system_prompt`, `price_per_run`
AIAgent	Custom agent definitions	`agent_key`, `company_id`, `is_active`, `system_prompt`
AIAgentRun	Execution records	`agent_key`, `status`, `cost_amount`, `created_at`
AIAgentSchedule	Schedule configurations	`trigger_type`, `last_triggered_at`, `notification_channel`
AIAgentSettings	Per-user settings	`user_id`, `agent_key`, `preferences`

Cara Akses

Dari sidebar, klik menu AI & Analitik > AI Agents.

Flow Penggunaan

Tips

Mulai dari agen yang menangani tugas paling repetitif untuk dampak terbesar
Monitor error rate secara rutin untuk memastikan agen berjalan optimal
Nonaktifkan agen yang tidak digunakan untuk menghemat kredit
Buat agen custom untuk tugas spesifik yang tidak tercakup agen template
Gunakan scheduled agents untuk monitoring otomatis tanpa intervensi manual

Related Documentation:

Entity Relationship Diagram

Tabel Schema

AIAgent — Agen AI Custom (20 field)

Field	Tipe	Required	Default	Deskripsi
`agent_key`	string	Ya	—	Kunci unik agent (auto-generated slug dari nama)
`company_id`	string	Ya	—	ID perusahaan (scope company-level)
`created_by`	string	Ya	—	Email user yang membuat agent
`name`	string	Ya	—	Nama AI Agent
`tagline`	string	Tidak	—	Deskripsi singkat satu baris
`description`	string	Tidak	—	Penjelasan lengkap fungsi agent (max 2000 karakter)
`category`	enum	Tidak	`"other"`	Kategori: `business`, `content`, `writing`, `social`, `other`
`icon`	string	Tidak	`"Sparkles"`	Nama icon lucide-react
`color`	string	Tidak	`"#4F46E5"`	Warna hex agent
`system_prompt`	string	Ya	—	Instruksi sistem utama untuk LLM (max 4000 karakter)
`input_fields`	array[object]	Tidak	—	Field input dinamis: `{key, label, type, placeholder, required}`
`model`	string	Tidak	`"automatic"`	Model LLM default
`use_internet`	boolean	Tidak	`false`	Gunakan konteks internet saat menjalankan agent
`status`	enum	Tidak	`"active"`	Status agen: `active`, `paused`, `inactive`
`source_template_key`	string	Tidak	—	Link ke AIAgentTemplate asal (nullable)
`run_count`	number	Tidak	`0`	Total eksekusi agent
`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 agent dibuat
`updated_date`	datetime	Tidak	—	Tanggal agent terakhir diperbarui

AIAgentRun — Riwayat Eksekusi Agen (14 field)

Field	Tipe	Required	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 agent dijalankan
`agent_key`	string	Ya	—	Kunci agen yang dijalankan
`agent_name`	string	Tidak	—	Nama agen saat dijalankan
`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 (max 100.000 karakter)
`cost_amount`	number	Tidak	`0`	Biaya Rupiah yang dipotong
`cost_credit`	number	Tidak	`0`	Kredit yang dipotong
`payment_method`	enum	Tidak	`"balance"`	Metode bayar: `balance`, `credit`, `free`
`status`	enum	Tidak	`"success"`	Status run: `success`, `failed`

AIAgentTemplate — Template Agen Bawaan Sistem (17 field)

Field	Tipe	Required	Default	Deskripsi
`agent_key`	string	Ya	—	Kunci unik agent (e.g. `business_analysis`)
`name`	string	Ya	—	Nama AI Agent
`tagline`	string	Tidak	—	Deskripsi singkat satu baris
`description`	string	Tidak	—	Penjelasan lengkap fungsi agent (max 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 hex template
`price_per_run`	number	Tidak	`5000`	Biaya per penggunaan dalam Rupiah
`credit_cost`	number	Tidak	`1`	Biaya alternatif dalam kredit AI
`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
`system_prompt`	string	Tidak	—	Instruksi sistem untuk LLM (max 4000 karakter)
`model`	string	Tidak	`"automatic"`	Model LLM yang dipakai
`use_internet`	boolean	Tidak	`false`	Gunakan konteks internet
`status`	enum	Tidak	`"active"`	Status template: `active`, `coming_soon`, `inactive`
`order`	number	Tidak	`0`	Urutan pengurutan tampilan

AIAgentModel — Katalog Model AI (8 field)

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

AIAgentSettings — Pengaturan Global AI Agent (6 field)

Field	Tipe	Required	Default	Deskripsi
`setting_key`	string	Ya	`"global"`	Kunci pengaturan (selalu `global` untuk pengaturan utama)
`description`	string	Tidak	—	Catatan pengaturan AI Agent (max 1000 karakter)
`credit_to_rupiah_rate`	number	Tidak	`10`	Nilai 1 kredit dalam Rupiah (1 kredit = Rp10)
`base_price_per_run`	number	Tidak	`1000`	Harga dasar default per penggunaan (Rupiah)
`allow_credit_payment`	boolean	Tidak	`true`	Izinkan user membayar dengan kredit
`allow_balance_payment`	boolean	Tidak	`true`	Izinkan user membayar dengan saldo Rupiah

AIAgentSchedule — Jadwal & Trigger Agen (10 field)

Field	Tipe	Required	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?}`, event: `{threshold?, 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: `in_app`, `whatsapp`, `email`, `all`
`created_by`	string	Ya	—	Email user yang membuat schedule
`created_date`	datetime	Tidak	—	Tanggal schedule dibuat

State Machine — Siklus Hidup Agen

Dampak Transisi Status

Status	Eksekusi Manual	Scheduled Runs	Tampilan UI	Akses API	Biaya
Active	Diperbolehkan	Aktif sesuai jadwal	Badge hijau	Tersedia	Terkena biaya
Paused	Diperbolehkan	Di-skip	Badge kuning	Terbatas	Terkena biaya
Inactive	Ditolak	Di-skip	Badge abu-abu	Diblokir	Tidak ada

Sequence Diagrams

Eksekusi Agen Manual

Scheduled Execution (Otomatis)

Tool Calling & Error Recovery

Error Recovery Flow

Enum Tables

agent_status — Status Agen Custom

Nilai	Label	Deskripsi
`active`	Aktif	Agent berjalan otomatis dan bisa dijalankan manual
`paused`	Dijeda	Scheduled runs di-skip, tapi masih bisa dijalankan manual
`inactive`	Nonaktif	Agent tidak bisa dijalankan sama sekali

template_status — Status Template Agen

Nilai	Label	Deskripsi
`active`	Aktif	Template tersedia dan bisa dibuat menjadi agent
`coming_soon`	Segera Hadir	Template dalam pengembangan, belum bisa digunakan
`inactive`	Nonaktif	Template disembunyikan dari daftar

agent_category — Kategori Agen

Nilai	Label	Deskripsi
`business`	Bisnis	Analisis bisnis, keuangan, laporan, KPI
`content`	Konten	Generate konten produk, marketing copy
`writing`	Penulisan	Artikel, email, proposal, editing
`social`	Media Sosial	Post Instagram, TikTok, WhatsApp blast
`other`	Lainnya	Custom agent untuk berbagai keperluan

model_tier — Tingkatan Model AI

Nilai	Label	Deskripsi
`standard`	Standar	Cepat dan hemat, cocok untuk tugas sederhana
`advanced`	Lanjutan	Kualitas lebih baik, cocok untuk analisis kompleks
`premium`	Premium	Model terbaik, cocok untuk tugas kritis

model_provider — Provider Model (via model_key)

Nilai	Contoh model_key	Deskripsi
Automatic	`automatic`	Sistem memilih model optimal secara otomatis
OpenAI	`gpt_5_mini`, `gpt_5`	Model dari OpenAI
Anthropic	`claude_sonnet_4_6`, `claude_opus_4`	Model dari Anthropic

run_status — Status Eksekusi Agen

Nilai	Label	Deskripsi
`success`	Berhasil	Agent menghasilkan output valid
`failed`	Gagal	Agent gagal menghasilkan output (error/timeout)

payment_method — Metode Pembayaran Run

Nilai	Label	Deskripsi
`balance`	Saldo Rupiah	Biaya dipotong dari saldo Rupiah user
`credit`	Kredit AI	Biaya dipotong dari kredit AI user
`free`	Gratis	Tidak ada biaya (promo atau konfigurasi khusus)

trigger_type — Jenis Trigger Schedule

Nilai	Kategori	Deskripsi
`schedule_daily`	Jadwal	Trigger setiap hari
`schedule_weekly`	Jadwal	Trigger setiap minggu
`schedule_monthly`	Jadwal	Trigger setiap bulan
`event_low_stock`	Event	Trigger saat stok produk rendah
`event_invoice_overdue`	Event	Trigger saat invoice jatuh tempo
`event_new_transaction`	Event	Trigger saat ada transaksi baru
`event_task_due`	Event	Trigger saat tugas mendekati deadline
`event_custom`	Event	Trigger berdasarkan kondisi custom

notification_channel — Channel Notifikasi

Nilai	Label	Deskripsi
`in_app`	Dalam Aplikasi	Notifikasi muncul di dalam aplikasi
`whatsapp`	WhatsApp	Notifikasi dikirim via WhatsApp
`email`	Email	Notifikasi dikirim via email
`all`	Semua Channel	Notifikasi dikirim ke semua channel

RBAC — Hak Akses AI Agent

Role	Lihat Daftar Agen	Lihat Detail Agen	Jalankan Agen	Buat Agent Custom	Edit Agent	Hapus Agent	Kelola Schedule	Lihat Semua Run	Kelola Settings
Super Admin	Ya	Ya	Ya	Ya	Ya	Ya	Ya	Ya (semua company)	Ya
Admin	Ya	Ya	Ya	Ya	Ya	Ya	Ya	Ya (company sendiri)	Ya
Manager	Ya	Ya	Ya	Ya	Ya (milik sendiri)	Tidak	Ya	Ya (company sendiri)	Tidak
Staff	Ya	Ya	Ya	Tidak	Tidak	Tidak	Tidak	Ya (milik sendiri)	Tidak
Viewer	Ya	Ya (read-only)	Tidak	Tidak	Tidak	Tidak	Tidak	Ya (milik sendiri)	Tidak

Catatan RBAC

Agent Template bersifat read-only untuk semua role kecuali Super Admin
AIAgentSettings hanya bisa diubah oleh Super Admin dan Admin
Biaya run selalu dibebankan ke company yang menjalankan, bukan individual
Scheduled runs hanya berjalan untuk agen dengan status active
Data run antar company terisolasi (multi-tenant)

​title: “AI Agent” description: “Daftar agen AI SNISHOP ERP — status, konfigurasi, toggle aktif/nonaktif, dan monitoring performa real-time.”

​AI Agent

​Gambaran Halaman

​Component Hierarchy

​AgentCard (91 baris)

​AgentCard Visual States

​Status Agen

​Kategori

​Toggle Aktif/Nonaktif

​Toggle Impact Analysis

​Pencarian

​Cmd/Ctrl+K Search

​Search Algorithm

​Category Filter Tabs

​Scheduled Execution on Load

​Schedule Due Date Logic

​Monitoring Performa

​Performance Metrics Computation

​Entities Used

​Cara Akses

​Flow Penggunaan

​Tips

​Entity Relationship Diagram

​Tabel Schema

​AIAgent — Agen AI Custom (20 field)

​AIAgentRun — Riwayat Eksekusi Agen (14 field)

​AIAgentTemplate — Template Agen Bawaan Sistem (17 field)

​AIAgentModel — Katalog Model AI (8 field)

​AIAgentSettings — Pengaturan Global AI Agent (6 field)

​AIAgentSchedule — Jadwal & Trigger Agen (10 field)

​State Machine — Siklus Hidup Agen

​Dampak Transisi Status

​Sequence Diagrams

​Eksekusi Agen Manual

​Scheduled Execution (Otomatis)

​Tool Calling & Error Recovery

​Error Recovery Flow

​Enum Tables

​agent_status — Status Agen Custom

​template_status — Status Template Agen

​agent_category — Kategori Agen

​model_tier — Tingkatan Model AI

​model_provider — Provider Model (via model_key)

​run_status — Status Eksekusi Agen

​payment_method — Metode Pembayaran Run

​trigger_type — Jenis Trigger Schedule

​notification_channel — Channel Notifikasi

​RBAC — Hak Akses AI Agent

​Catatan RBAC