Configuration
Mengatur provider AI, API key, model, dan fallback untuk seluruh instance
Menu Configuration di Console berisi pengaturan yang berlaku untuk seluruh instance. Saat ini isinya satu bagian: AI Provider, yaitu provider AI, API key, dan model yang dipakai semua fitur AI.
Pengaturan ini dipakai oleh semua fitur AI di semua workspace:
- NORA (Create SOP with NORA)
- BPMN review (Review with AI di editor BPMN)
- Generate BPMN (wizard pembuatan file)
- BPMN Creator chat (deskripsi proses dan dokumentasi)
- Company profile AI (Generate Purpose dan sejenisnya)
Siapa yang bisa membuka
Hanya akun dengan role platform_owner, sama seperti menu Console lainnya. Bila menu Configuration masih bertanda Soon, fitur ini belum dinyalakan pada instance Anda. Lihat Untuk tim instalasi.
Dari mana AI mengambil pengaturan
Setiap panggilan AI memeriksa urutan berikut:
- Pengaturan Console sudah pernah disimpan → pengaturan Console yang dipakai. Pengaturan AI dari server (env) diabaikan.
- Console belum pernah disimpan → AI memakai pengaturan server seperti sebelum menu ini ada. Halaman menampilkan Not configured. Services use the server's environment settings until you save here.
- Console dan server sama-sama kosong → fitur AI menolak dengan pesan AI is not configured beserta tautan ke halaman ini.
Perubahan berlaku paling lambat 30 detik setelah disimpan, tanpa restart.
Tidak ada tombol kembali ke pengaturan server
Begitu pengaturan Console tersimpan, pengaturan AI dari server tidak lagi dibaca. Bila key di Console salah atau dihapus, fitur AI gagal dan tidak beralih ke pengaturan server. Untuk kembali ke pengaturan server, hubungi tim instalasi.
Provider
Pilih salah satu provider pada Provider:
| Provider | Isian | Dikirim ke |
|---|---|---|
| OpenAI | API key OpenAI | API resmi api.openai.com |
| Anthropic | API key Anthropic (Claude) | API resmi api.anthropic.com |
| Custom (OpenAI-compatible) | Name (opsional), Base URL (wajib), API key | <Base URL>/chat/completions |
Pakai Custom untuk endpoint yang meniru API OpenAI, misalnya AI gateway milik perusahaan. Name hanya label di Console. Contoh Base URL: https://ai-gateway.example.com/v1.
Key setiap provider disimpan terpisah. Berpindah provider tidak menghapus key provider lain, jadi Anda bisa kembali tanpa mengetik ulang.
Model
- Default model wajib diisi. Model ini dipakai semua fitur yang tidak punya model sendiri. Contoh:
gpt-5.6-soluntuk OpenAI atau gateway,claude-sonnet-5-5untuk Anthropic. - Per-feature models (klik untuk membuka) memberi model berbeda untuk satu fitur. Kosongkan untuk memakai default model.
Nama model ditulis persis seperti yang dikenal provider. Gunakan Test connection untuk memastikan model itu ada.
Fallback
Fallback mengulang panggilan ke provider lain ketika provider utama gagal. Nyalakan If the main provider fails, retry on a fallback provider, lalu isi:
- Fallback provider — OpenAI (API resmi) atau Claude (Anthropic).
- API key fallback — key untuk provider fallback yang dipilih.
- Fallback model — model yang dipakai saat fallback. Model ini berlaku untuk semua fitur.
Fallback model wajib bila format API-nya berbeda dari provider utama, misalnya provider utama Custom atau OpenAI dengan fallback Claude, atau sebaliknya. Bila formatnya sama, fallback model boleh kosong. Fallback lalu memakai nama model yang sama dengan provider utama.
Fallback dipakai bila provider utama:
- menolak API key (401),
- akunnya belum dibayar atau dinonaktifkan (402),
- terkena batas rate atau kuota (429),
- mengalami galat server (5xx), atau
- tidak bisa dihubungi sama sekali.
Galat lain tidak memicu fallback, misalnya model tidak dikenal atau permintaan ditolak (400). Provider lain kemungkinan besar akan menolak permintaan yang sama.
BPMN Creator chat
Jawaban chat dikirim bertahap. Fallback hanya terjadi bila jawaban gagal dimulai. Bila jawaban terputus di tengah, pesan galat tetap muncul supaya teks tidak terulang.
Test connection
Test connection mengirim satu permintaan singkat ke setiap model yang berbeda pada form, yaitu default model dan setiap model per fitur. Bila fallback menyala, fallback ikut diuji satu kali dengan baris berlabel Fallback. Tidak ada yang disimpan.
| Hasil | Arti |
|---|---|
| OK dan latensi | Key dan model bekerja. |
| The AI provider rejected the API key. | Key salah, kedaluwarsa, atau tidak punya akses. |
| The AI provider does not recognise model "…". | Nama model salah atau tidak tersedia untuk key itu. |
| The AI provider rate limit or quota was reached. | Batas rate atau kuota akun provider habis. |
| The AI provider could not be reached. | Provider tidak bisa dihubungi atau sedang galat. |
| The AI provider rejected the request (HTTP …). | Penolakan lain. Untuk provider Custom, isi pesan dari endpoint tidak ditampilkan. |
API key
- Key disimpan terenkripsi. Setelah tersimpan, Console hanya menampilkan bentuk tersamar, misalnya
sk-…abcd. Key utuh tidak pernah dikirim kembali ke browser. - Kosongkan isian key untuk mempertahankan key yang tersimpan. Remove key menghapusnya saat Anda menyimpan.
- Mengubah Base URL mewajibkan key diketik ulang. Key yang dibuat untuk satu alamat tidak dikirim ke alamat lain.
- Mengganti Fallback provider juga mewajibkan key fallback diketik ulang. Key OpenAI tidak pernah dikirim ke Anthropic, dan sebaliknya.
Pemakaian dan biaya
Setiap panggilan tercatat di AI Usage dengan nama model yang benar-benar menjawab. Bila fallback yang menjawab, model fallback yang tercatat. Biaya dihitung untuk model OpenAI dan Claude yang harganya dikenal sistem.
Untuk tim instalasi
Menu ini aktif bila flag fitur dinyalakan pada seluruh service berikut:
| Service | Variabel |
|---|---|
| app (Console) | VITE_FEATURE_FLAG_AI_SETTINGS=true |
| integration-service, bpm-service, company-profile-service | FEATURE_FLAG_AI_SETTINGS=true |
Syarat lain:
TENANT_SETTINGS_ENCRYPTION_KEYharus sama di integration-service, bpm-service, dan company-profile-service. Key di Console dienkripsi oleh integration-service dan dibaca oleh dua service lainnya.- Migrasi integration-service dijalankan berurutan:
20261103100000_integration_create_ai_settings,20261104100000_integration_ai_settings_custom_provider, dan20261104120000_integration_ai_settings_fallback_provider.
Selama flag mati, menu Configuration bertanda Soon dan semua fitur AI memakai pengaturan server seperti biasa.