title: “AI Agents” description: “Agent Hub SNISHOP ERP — galeri agen template dan custom dengan Cmd+K search, category filter, dan scheduled execution.”

AI Agents

Halaman AI Agents menampilkan Agent Hub — galeri lengkap semua agen AI yang tersedia di sistem, baik agen template (bawaan) maupun agen custom yang dibuat oleh perusahaan. Dari sini, user bisa menjelajahi agen berdasarkan kategori, menjalankan agen terjadwal, dan mengakses detail setiap agen.

Arsitektur Agent Hub

Data Loading Sequence

Dua Jenis Agen

Template Agents (Bawaan Sistem)

Agen yang sudah dikonfigurasi oleh sistem dengan definisi tetap:

Field	Tipe	Detail
`agent_key`	string	Unique key (contoh: `business_analysis`)
`name`	string	Nama agen
`tagline`	string	Deskripsi singkat satu baris
`description`	string	Deskripsi lengkap (max 2.000)
`category`	enum	`business`, `content`, `writing`, `social`, `other`
`icon`	string	Nama ikon Lucide (default: `Sparkles`)
`color`	string	Warna hex (default: `#3b82f6`)
`price_per_run`	number	Biaya per eksekusi dalam Rupiah (default: 5.000)
`credit_cost`	number	Kredit per eksekusi (default: 1)
`features`	array[string]	Daftar fitur utama
`use_cases`	array[string]	Daftar kasus penggunaan
`input_fields`	array[object]	Form input: `{key, label, type, placeholder, required}`
`system_prompt`	string	Prompt sistem (max 4.000)
`model`	string	Model default (default: `automatic`)
`use_internet`	boolean	Gunakan internet search (default: false)
`status`	enum	`active`, `coming_soon`, `inactive`
`order`	number	Urutan tampilan

Custom Agents (Buatan Perusahaan)

Agen yang dibuat oleh user/admin perusahaan melalui chat atau form:

Field	Tipe	Detail
`agent_key`	string	Unique key
`name`	string	Nama agen
`company_id`	string	ID perusahaan pemilik
`system_prompt`	string	Prompt sistem custom
`is_active`	boolean	Status aktif/nonaktif
`status`	string	Status agen
`category`	string	Kategori
`description`	string	Deskripsi
`tagline`	string	Tagline

Template vs Custom Comparison

Kategori Agen

Kategori	Ikon	Deskripsi
All	Grid	Tampilkan semua agen
Business	Briefcase	Analisis bisnis, laporan keuangan, KPI
Writing	PenTool	Penulisan konten, copywriting, editing
Content	FileText	Generate konten produk, deskripsi
Social	Share2	Konten media sosial, hashtag
Other	Sparkles	Kegunaan umum

Fitur Utama

Cmd/Ctrl+K Search

Shortcut keyboard untuk pencarian cepat agen berdasarkan nama. Search bar muncul di bagian atas grid dan memfilter hasil secara real-time.

Search Architecture

Scheduled Execution

Trigger Types

Trigger	Tipe	Deskripsi
Harian	`schedule_daily`	Setiap hari
Mingguan	`schedule_weekly`	Setiap minggu
Bulanan	`schedule_monthly`	Setiap bulan
Stok Rendah	`event_low_stock`	Saat stok di bawah minimum
Invoice Overdue	`event_invoice_overdue`	Saat invoice jatuh tempo
Transaksi Baru	`event_new_transaction`	Saat ada transaksi baru
Tugas Jatuh Tempo	`event_task_due`	Saat tugas mendekati deadline
Custom	`custom`	Trigger kustom

Notifikasi

Channel	Deskripsi
`in_app`	Notifikasi dalam aplikasi
`whatsapp`	Kirim via WhatsApp
`email`	Kirim via email
`all`	Semua channel

Entity: AIAgentRun

Setiap eksekusi agen dicatat sebagai AIAgentRun:

Field	Tipe	Detail
`user_id`	string	ID user yang menjalankan
`user_email`	string	Email user
`company_id`	string	ID perusahaan aktif
`agent_key`	string	Key agen yang dijalankan
`agent_name`	string	Nama agen
`input_data`	object	Input yang diberikan
`output`	string	Hasil output (max 100.000)
`cost_amount`	number	Biaya Rupiah (default: 0)
`cost_credit`	number	Kredit terpakai (default: 0)
`payment_method`	enum	`balance`, `credit`, `free`
`status`	enum	`success`, `failed`
`created_at`	timestamp	Waktu eksekusi
`model`	string	Model yang digunakan

Model Selection

Harga per eksekusi dihitung berdasarkan model yang dipilih:

Model Tier Comparison

Tier	Models	Best For	Cost	Quality
Standard	hermes-3-llama-3	Simple tasks, quick answers	Low	Good
Advanced	claude-3-5-sonnet, gpt-4o	Analysis, recommendations	Medium	Better
Premium	gemini-1-5-pro	Complex reasoning, multi-step	High	Best

Cara Akses

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

Flow Penggunaan

Tips

Mulai dari agen template untuk tugas umum — sudah teruji dan optimal
Buat agen custom untuk tugas repetitif spesifik bisnis Anda
Gunakan scheduled agents untuk monitoring otomatis
Monitor biaya melalui Agent History untuk mengoptimalkan penggunaan
Pilih model Standard untuk tugas sederhana, Premium untuk analisis kompleks

Related Documentation:

Entity Relationship Diagram

Tabel Schema Lengkap

AIAgent — Custom Agent Perusahaan

Entitas agen AI yang dibuat oleh perusahaan. Setiap agen memiliki scope per-company dan bisa dibuat dari template atau sepenuhnya custom.

Field	Tipe	Required	Default	Deskripsi
`agent_key`	string	Ya	—	Kunci unik agent (auto-generated slug dari nama)
`company_id`	string	Ya	—	ID perusahaan pemilik (scope company-level)
`created_by`	string	Ya	—	Email user yang membuat agent
`name`	string	Ya	—	Nama AI Agent
`system_prompt`	string	Ya	—	Instruksi sistem utama untuk LLM (max 4.000 karakter)
`tagline`	string	Tidak	—	Deskripsi singkat satu baris
`description`	string	Tidak	—	Penjelasan lengkap fungsi agent (max 2.000 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 untuk tampilan card
`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 eksekusi
`status`	enum	Tidak	`active`	`active` = jalan otomatis, `paused` = tidak otomatis tapi bisa manual, `inactive` = nonaktif
`source_template_key`	string	Tidak	`null`	Link ke AIAgentTemplate asal jika dibuat dari template (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	—	Waktu agent dibuat
`updated_date`	datetime	Tidak	—	Waktu agent terakhir diperbarui

AIAgentTemplate — Template Agent Bawaan Sistem

Definisi agen AI bawaan yang tersedia untuk semua perusahaan. Template ini di-seed oleh sistem dan menjadi blueprint untuk custom agent.

Field	Tipe	Required	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 agent (max 2.000 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 untuk tampilan card
`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 agen
`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 (max 4.000 karakter)
`model`	string	Tidak	`automatic`	Model LLM default
`use_internet`	boolean	Tidak	`false`	Gunakan konteks internet
`status`	enum	Tidak	`active`	Status: `active`, `coming_soon`, `inactive`
`order`	number	Tidak	`0`	Urutan tampilan di grid

AIAgentRun — Riwayat Eksekusi Agent

Setiap kali agen dijalankan (manual atau scheduled), satu record AIAgentRun dibuat untuk audit trail dan billing.

Field	Tipe	Required	Default	Deskripsi
`user_id`	string	Ya	—	ID user yang menjalankan
`agent_key`	string	Ya	—	Kunci agen yang dijalankan
`user_email`	string	Tidak	—	Email user eksekutor
`company_id`	string	Tidak	—	ID perusahaan aktif (null untuk personal)
`company_name`	string	Tidak	—	Nama perusahaan saat agent dijalankan
`agent_name`	string	Tidak	—	Nama agen saat run (snapshot)
`model_used`	string	Tidak	—	Model AI yang dipakai pada run ini
`model_name`	string	Tidak	—	Nama tampilan model
`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 eksekusi: `success`, `failed`

AIAgentModel — Katalog Model LLM

Daftar model AI yang tersedia untuk digunakan oleh agen. Setiap model memiliki multiplier harga dan tier kualitas.

Field	Tipe	Required	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 (max 500 karakter)
`price_multiplier`	number	Tidak	`1`	Pengali biaya — biaya akhir = harga dasar agent × multiplier
`tier`	enum	Tidak	`standard`	Tingkatan kualitas: `standard`, `advanced`, `premium`
`supports_internet`	boolean	Tidak	`false`	Model mendukung konteks internet
`is_active`	boolean	Tidak	`true`	Status aktif model
`order`	number	Tidak	`0`	Urutan tampil di dropdown

AIAgentSettings — Pengaturan Global AI Agent

Konfigurasi global untuk sistem billing dan pembayaran AI Agent. Hanya ada satu record dengan setting_key = 'global'.

Field	Tipe	Required	Default	Deskripsi
`setting_key`	string	Ya	`global`	Kunci pengaturan (selalu `global` untuk pengaturan utama)
`description`	string	Tidak	—	Catatan pengaturan (max 1.000 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 run (Rupiah) bila agent 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

AIAgentSchedule — Jadwal & Trigger Agent

Konfigurasi eksekusi otomatis agen berdasarkan jadwal (cron) atau event bisnis.

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`
`created_by`	string	Ya	—	Email user yang membuat schedule
`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: `in_app`, `whatsapp`, `email`, `all`
`created_date`	datetime	Tidak	—	Waktu schedule dibuat

State Machine — Agent Template Lifecycle

Sequence Diagram — Template Instantiation & Agent Cloning

Instantiation: Template ke Custom Agent

Cloning: Duplikasi Agent dalam Perusahaan

Enum Tables

template_category — Kategori Template Agent

Nilai Enum	Label	Deskripsi
`business`	Bisnis	Analisis bisnis, laporan keuangan, KPI, strategi
`content`	Konten	Generate konten produk, deskripsi, katalog
`writing`	Penulisan	Copywriting, editing, proofreading, blog
`social`	Media Sosial	Konten sosial media, hashtag, caption
`other`	Lainnya	Kegunaan umum, custom purpose

agent_status_template — Status Template Agent

Nilai Enum	Label	Deskripsi
`active`	Aktif	Template muncul di Hub dan bisa dijalankan/di-clone
`coming_soon`	Segera Hadir	Template terlihat dengan badge “Segera Hadir”, belum bisa dijalankan
`inactive`	Nonaktif	Template tersembunyi dari Hub

agent_status_custom — Status Custom Agent

Nilai Enum	Label	Deskripsi
`active`	Aktif	Agent berjalan otomatis dan bisa dijalankan manual
`paused`	Dijeda	Tidak berjalan otomatis (scheduled off), tapi masih bisa dijalankan manual
`inactive`	Nonaktif	Agent nonaktif sepenuhnya, tidak bisa dijalankan

agent_capability — Kapabilitas Agent

Nilai	Deskripsi
`text_generation`	Generate teks, artikel, deskripsi produk
`data_analysis`	Analisis data keuangan, KPI, tren
`internet_search`	Pencarian konteks internet (memerlukan `use_internet = true`)
`scheduled_execution`	Mendukung eksekusi terjadwal via AIAgentSchedule
`multi_input`	Menerima multiple input fields dari user
`export_output`	Output bisa di-export ke format file

model_tier — Tingkatan Model LLM

Nilai Enum	Label	Multiplier	Best For
`standard`	Standar	×1.0	Tugas sederhana, jawaban cepat
`advanced`	Lanjutan	×1.5	Analisis, rekomendasi, konten panjang
`premium`	Premium	×3.0	Complex reasoning, multi-step task

trigger_type — Jenis Trigger Schedule

Nilai Enum	Kategori	Deskripsi
`schedule_daily`	Jadwal	Setiap hari pada waktu yang ditentukan
`schedule_weekly`	Jadwal	Setiap minggu pada hari dan waktu tertentu
`schedule_monthly`	Jadwal	Setiap bulan pada tanggal dan waktu tertentu
`event_low_stock`	Event	Dipicu saat stok produk di bawah threshold
`event_invoice_overdue`	Event	Dipicu saat invoice melewati jatuh tempo
`event_new_transaction`	Event	Dipicu saat ada transaksi baru masuk
`event_task_due`	Event	Dipicu saat tugas mendekati deadline
`event_custom`	Event	Trigger kustom yang dikonfigurasi user

payment_method — Metode Pembayaran Run

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

notification_channel — Channel Notifikasi

Nilai Enum	Deskripsi
`in_app`	Notifikasi dalam aplikasi
`whatsapp`	Kirim via WhatsApp
`email`	Kirim via email
`all`	Semua channel aktif

RBAC — Hak Akses AI Agents

Role	Lihat Hub	Buat Custom Agent	Jalankan Agent	Lihat Run History	Kelola Schedule	Kelola Template	Kelola Model & Settings
Super Admin	Ya	Ya	Ya	Ya (semua company)	Ya	Ya	Ya
Admin Perusahaan	Ya	Ya	Ya	Ya (per company)	Ya	Tidak	Tidak
Manajer	Ya	Ya	Ya	Ya (per company)	Ya	Tidak	Tidak
Staff	Ya	Tidak	Ya	Ya (milik sendiri)	Tidak	Tidak	Tidak
Viewer	Ya	Tidak	Tidak	Ya (milik sendiri)	Tidak	Tidak	Tidak

RLS Policy Ringkasan

Entitas	Create	Read	Update	Delete
`AIAgentTemplate`	Admin sistem	Publik (semua role)	Admin sistem	Admin sistem
`AIAgent`	Admin, Manajer	Member company	Admin, Manajer (owner)	Admin (owner)
`AIAgentRun`	System (auto)	Member (milik sendiri + admin)	—	—
`AIAgentModel`	Admin sistem	Publik (semua role)	Admin sistem	Admin sistem
`AIAgentSettings`	Admin sistem	Admin	Admin sistem	—
`AIAgentSchedule`	Admin, Manajer	Member company	Admin, Manajer	Admin

​title: “AI Agents” description: “Agent Hub SNISHOP ERP — galeri agen template dan custom dengan Cmd+K search, category filter, dan scheduled execution.”

​AI Agents

​Arsitektur Agent Hub

​Data Loading Sequence

​Dua Jenis Agen

​Template Agents (Bawaan Sistem)

​Custom Agents (Buatan Perusahaan)

​Template vs Custom Comparison

​Kategori Agen

​Fitur Utama

​Cmd/Ctrl+K Search

​Search Architecture

​Scheduled Execution

​Trigger Types

​Notifikasi

​Entity: AIAgentRun

​Model Selection

​Model Tier Comparison

​Cara Akses

​Flow Penggunaan

​Tips

​Entity Relationship Diagram

​Tabel Schema Lengkap

​AIAgent — Custom Agent Perusahaan

​AIAgentTemplate — Template Agent Bawaan Sistem

​AIAgentRun — Riwayat Eksekusi Agent

​AIAgentModel — Katalog Model LLM

​AIAgentSettings — Pengaturan Global AI Agent

​AIAgentSchedule — Jadwal & Trigger Agent

​State Machine — Agent Template Lifecycle

​Sequence Diagram — Template Instantiation & Agent Cloning

​Instantiation: Template ke Custom Agent

​Cloning: Duplikasi Agent dalam Perusahaan

​Enum Tables

​template_category — Kategori Template Agent

​agent_status_template — Status Template Agent

​agent_status_custom — Status Custom Agent

​agent_capability — Kapabilitas Agent

​model_tier — Tingkatan Model LLM

​trigger_type — Jenis Trigger Schedule

​payment_method — Metode Pembayaran Run

​notification_channel — Channel Notifikasi

​RBAC — Hak Akses AI Agents

​RLS Policy Ringkasan