Lewati ke isi

Manajemen Pool API Keys (Global Keys)

Berdasarkan arsitektur terbaru (Fase D), sistem tidak lagi hanya mengandalkan "1 kunci tunggal" untuk AI. Saat ini EdigSSO Portal memanfaatkan mekanisme Pool API Keys.

Apa itu Pool API Keys?

Ini adalah sistem di mana Super Admin dapat menaruh lebih dari satu API Key untuk Provider LLM yang sama (misalnya Groq atau Google) ke dalam sebuah pool (wadah utama di level server). Seluruh user dan organisasi (secara default) akan menarik resource dari Pool ini saat menggunakan AI Chatbot.

Keuntungan Sistem Pool

  1. Efisiensi: User tidak perlu memasukkan API Key secara manual setiap kali onboarding instance Odoo.
  2. Failover & Cooldown Otomatis: Jika salah satu kunci mengalami limit pemakaian (exhausted / kode error HTTP 429), sistem akan menandai kunci tersebut dalam masa cooldown dan secara instan beralih (failover) ke kunci lain di dalam Pool. AI Chatbot tetap berjalan tanpa interupsi bagi User.
  3. Observabilitas: Admin bisa melacak kunci mana yang bermasalah (status invalid) dari pesan error tingkat rendah, lalu melakukan perbaikan atau penggantian tanpa membongkar konfigurasi .env server.

Opsi BYOK (Bring Your Own Key)

Meskipun tersedia server Pool, portal mendukung prinsip hierarki fleksibel. Jika sebuah organisasi/perusahaan (Instance level) memiliki kebutuhan AI yang amat besar dan ingin menggunakan tagihan Groq/LLM mereka sendiri, mereka bisa men-setup API Key mereka sendiri.

Urutan Resolusi Kunci AI: 1. Cek API Key di level Instance Odoo (Paling prioritas) 2. Cek API Key di level User (Jika Instance tidak punya) 3. Ambil dari Pool API Keys Server Global (Jika User & Instance tidak punya)