AI Canggih: Pakai Kunci AI Sendiri

Mau AI yang lebih kuat atau batas pemakaian lebih lega? Pasang kunci AI milikmu sendiri di workspace. Cocok untuk tim yang butuh analisis lebih dalam atau usage tinggi tanpa terbatas kuota bawaan.

  1. 1

    Apa ini dan kenapa dipakai

    Secara default, semua fitur AI di SatuTim (Brief Triage, Daily Brief, Smart Estimation, AI Scaffold, dll) sudah jalan langsung pakai AI bawaan yang dioptimalkan untuk Bahasa Indonesia. Buat tim yang butuh lebih, SatuTim juga bisa kamu sambungkan ke kunci AI milikmu sendiri. Kelebihannya: (1) batas pemakaian lebih lega karena kuotanya milikmu sendiri, (2) bisa pilih tingkat "kecerdasan" AI sesuai kebutuhan, dari yang cepat-hemat sampai yang kuat untuk analisis mendalam, (3) tagihan AI terpisah dan transparan. Cocok kalau tim kamu butuh analisis lebih dalam atau pemakaian AI yang tinggi.

    • Default workspace tetap pakai AI bawaan SatuTim (sudah optimal untuk Bahasa Indonesia). Kunci sendiri sifatnya opsional, per workspace.
    • Test koneksi dulu sebelum dipakai penuh, supaya yakin hasilnya pas untuk gaya bahasa tim kamu.
    • Mode analisis mendalam TRADEOFF: jawaban lebih akurat tapi 2-3x lebih lambat. Aktifkan untuk brief triage, matiin untuk chat cepat.
  2. 2

    Aktifkan di workspace: Settings → AI

    Buka https://satutim.id/settings/ai (atau menu Settings → AI di sidebar). Halaman tampilin kartu Provider dengan 2 pilihan: AI bawaan SatuTim (default) dan AI Canggih (pakai kunci sendiri). Klik kartu AI Canggih untuk switch. Pilih tingkat kecerdasan AI yang kamu mau. Klik tombol "Simpan pengaturan" hijau di bottom bar. Mulai sekarang, semua AI feature di workspace ini (Brief Triage, Daily Brief, Smart Estimation, AI Scaffold, dll) bakal pakai pengaturan ini.

    Owner / admin workspace only. Member biasa cuma bisa baca pengaturan, gak bisa ubah.
  3. 3

    Pilih tingkat kecerdasan AI

    Ada 3 tingkat yang bisa kamu pilih sesuai kebutuhan:

    • Cepat + Hemat, ringan dan murah. Cocok untuk: chat, summary, simple tools, generate task description. Default untuk kebanyakan workspace.

    • Kuat + Mendalam, lebih akurat untuk reasoning kompleks. Cocok untuk: brief triage, deep analysis, multi-step planning. Lebih lambat (2-3x).

    • Eksperimental, fokus pada penalaran khusus. Bagus untuk eksplorasi tapi belum stabil. Untuk sekarang: jangan pakai untuk production.

    • Workspace kecil (< 50 task/hari): pakai Cepat + Hemat untuk biaya minimum
    • Agency / tim besar dengan brief kompleks: Kuat + Mendalam + mode analisis ON untuk Brief Triage
    • Mau eksperimen: pilih Eksperimental, catat hasilnya, share feedback
  4. 4

    Kunci sendiri vs kuota bawaan SatuTim

    Dua mode pakai AI Canggih:

    1. Kuota bawaan SatuTim (default kalau gak set kunci sendiri), kita teruskan request kamu lewat kuota SatuTim. Biaya terhitung di plan workspace (akan ditagih bareng billing biasa). Praktis, gak perlu daftar akun penyedia AI sendiri.
    1. Kunci sendiri (Bring Your Own), bawa kunci AI milikmu sendiri. Daftar di penyedia AI pilihanmu → buat kunci → top-up saldo. Paste kunci di Settings → AI → field "Kunci AI". Biaya langsung ke akun penyedia kamu, biasanya lebih hemat dari kuota bawaan. Cocok kalau usage tinggi.
    • Kunci sendiri disimpan terenkripsi dengan aman, gak akan ditampilkan ulang setelah save
    • Rotasi kunci: paste kunci baru → save → kunci lama otomatis di-revoke
    • Hapus kunci: tombol "Hapus kunci" di section yang sama → revert ke kuota bawaan
    Pastikan kunci yang kamu paste memang dari penyedia AI yang kamu pilih, kalau format beda, kemungkinan kunci dari layanan lain.
  5. 5

    Mode analisis mendalam: kapan on/off

    AI Canggih punya mode analisis mendalam. Toggle di Settings → AI saat provider = AI Canggih:

    • Auto (default), serahin ke AI, dia pilih sendiri berdasarkan tingkat kerumitan permintaan. Aman untuk kebanyakan kasus.

    • On (mendalam), paksa AI "mikir" dulu sebelum jawab. Output lebih akurat untuk reasoning kompleks (analisis brief, multi-step planning, hitung-hitungan). Tradeoff: 2-3x lebih lambat + pemakaian naik 30-50%.

    • Off (langsung), paksa AI langsung jawab tanpa berpikir panjang. Lebih cepat. Bagus untuk chat ringan, summary, format conversion.

    Paling pragmatis: pakai Auto. Override ke On kalau punya use case spesifik yang butuh analisis berat (mis. workspace khusus untuk strategic planning).

  6. 6

    Test koneksi: verifikasi setup

    Setelah pilih provider + tingkat kecerdasan + (opsional) mode analisis + (opsional) kunci sendiri, scroll ke bawah ke section "Test koneksi". Klik tombol "Test sekarang". SatuTim kirim permintaan singkat untuk dicoba, balik dengan: (a) contoh hasil (1 kalimat Bahasa Indonesia), (b) kecepatan respons dalam ms, (c) jumlah pemakaian. Kalau gagal, pesan error akan jelas, mis. "AI lagi padat" (terlalu banyak request), "Saldo penyedia AI habis" (top-up), atau "Kunci AI salah".

    • Test koneksi PRE-save, kalau gagal di sini, jangan save dulu, fix masalahnya
    • Kecepatan normal: 500-2000ms mode langsung, 2000-8000ms mode analisis mendalam
    • Kalau test berhasil tapi fitur aktual gagal, mungkin masih ada data lama yang ter-cache, tunggu 60 detik atau reload aplikasi
  7. 7

    Migrasi gradual dari AI bawaan

    Recommended approach saat switch ke AI Canggih: gradual. Step:

    1. Switch provider ke AI Canggih di Settings → AI
    2. Pilih tingkat konservatif (Cepat + Hemat), mode analisis = Auto
    3. Pakai dulu untuk feature ringan: AI Scaffold project, Smart Estimation, Daily Brief, observasi 1 minggu
    4. Cek kualitas hasilnya → kalau ok, advance ke Brief Triage (lebih berat)
    5. Kalau ada concern soal gaya bahasa, balikin ke AI bawaan untuk feature spesifik (gak ada per-feature toggle yet, switch whole workspace)

    Fallback strategy: kalau penyedia AI sedang bermasalah, SatuTim mendeteksinya otomatis. Untuk saat ini belum ada auto-fallback ke AI bawaan, switch manual via Settings. Rencana berikutnya: toggle auto-fallback.

    Feature-level provider override belum tersedia, switch whole workspace at once.
  8. 8

    Monitor biaya dan pemakaian

    Dashboard biaya khusus belum tersedia (rencana fase berikutnya). Untuk sekarang pantau manual:

    • Pakai kunci sendiri: cek dashboard aktivitas di akun penyedia AI kamu, pemakaian per hari dan per permintaan.

    • Pakai kuota bawaan: cek halaman billing workspace (Settings → Billing), kolom "AI usage this month" akan tampilkan konsumsi + perkiraan biaya.

    • Per-permintaan: hasil "Test koneksi" juga menampilkan jumlah pemakaian, jadi kamu bisa estimasi biaya per panggilan.

    Batas anggaran (budget cap): belum tersedia (rencana fase berikutnya, UI menyusul). Workaround: set limit dari akun penyedia AI kamu.

  9. 9

    Fallback + error handling

    Kalau AI Canggih mengalami masalah, SatuTim mengelompokkan error dan menampilkan pesan Bahasa Indonesia yang ramah ke user. Error umum:

    • Terlalu padat: "AI lagi padat, terlalu banyak request", tunggu 1-5 menit
    • Kuota habis: "Saldo penyedia AI habis", top-up di akun penyedia AI kamu ATAU switch ke kuota bawaan
    • Server sibuk: "AI lagi maintenance di sisi penyedia", sementara, dicoba ulang otomatis sampai 3x
    • Timeout: permintaan terlalu kompleks atau AI sedang penuh, coba persingkat input
    • Konfigurasi: "Kunci AI salah atau belum di-set", cek Settings → AI → Kunci sendiri
    • Respons rusak: kemungkinan masalah di sisi penyedia, ganti tingkat kecerdasan sementara

    Setiap jenis error otomatis dipetakan ke pesan yang tepat sehingga tampilan aplikasi sesuai dengan konteksnya.

  10. 10

    BONUS: Akses SatuTim dari asisten AI di terminal

    Selain dipakai di SatuTim web app, kamu juga bisa akses workspace SatuTim dari asisten AI yang jalan di terminal, kayak ngetik tanya "task gw hari ini". Untuk ini, install skill SatuTim ke asisten AI terminal kamu.

    One-liner install (recommended):

    curl -sSL https://satutim.id/skills/install-cli.sh | bash

    Script ngerjain: download skill bundle → extract ke folder skill asisten kamu → cek deps → kasih next steps (buat token + export env). Output bakal kasih tahu kamu apa yang harus dilakuin selanjutnya.

    Alternative MANUAL:

    curl -sSL https://satutim.id/skills/satutim-cli.tar.gz | \
  tar -xz -C ~/.ai-assistant/skills/
chmod +x ~/.ai-assistant/skills/satutim/tools/*.sh

    Direktori akhir:

    ~/.ai-assistant/skills/satutim/
├── SKILL.md          (metadata skill + prompt)
├── README.md
├── LICENSE
└── tools/            (11 bash tools yang sama dengan versi chat)
    ├── _common.sh
    ├── satutim_help.sh
    └── ... (11 tools total)

    Setelah install:

    1. Buat API token: https://satutim.id/settings/api
    2. Export env: export SATUTIM_API_KEY=stm_token
    3. Reload asisten AI kamu
    4. Test: tanya "task gw hari ini apa aja?", asisten akan baca maksudmu, pakai tool satutim_my_tasks_today.sh, return hasil rapi ke terminal.

    Setup ini terpisah dari pengaturan AI di SatuTim web! Web app pakai AI untuk fitur internal, sementara skill ini bikin asisten AI di terminal bisa AKSES workspace SatuTim, dua arah berbeda yang saling melengkapi.

    • Skill SatuTim untuk terminal = sama persis dengan versi chat, beda cuma di metadata
    • Bisa install di banyak asisten sekaligus, satu untuk channel chat, satu untuk terminal. Token bisa sama atau beda.
    • Panduan lengkap install skill ada di https://satutim.id/docs/cli
  11. 11

    Troubleshooting

    Case-by-case:

    "Provider gak bisa di-switch / dropdown disabled"
    → Plan workspace masih Free. AI Canggih butuh Pro+. Upgrade dulu di Settings → Billing.

    "Test koneksi sukses tapi Brief Triage masih pakai AI bawaan"
    → Data lama masih ter-cache. Tunggu 60 detik atau hard refresh halaman. Pastikan juga pilihan provider sudah benar-benar tersimpan (lihat indikator "tersimpan" di bar bawah).

    "AI kasih jawaban Bahasa Inggris padahal permintaan Bahasa Indonesia"
    → Beberapa AI cenderung default ke English. Tambahin instruksi explicit: "Jawab dalam Bahasa Indonesia". Bisa di Settings AI advanced → custom instruction (Phase 2 feature).

    "Cost spike, tagihan penyedia AI naik drastis"
    → Cek apakah workspace tetap pakai tingkat Kuat + Mendalam + mode analisis ON untuk feature yang gak butuh. Downgrade ke Cepat + Hemat + Auto untuk reduce 70-80%.

    "Workspace lain masih default tanpa AI Canggih"
    → Setting per-workspace, bukan account. Owner workspace lain harus switch sendiri.

    "Install skill terminal gagal, folder skill gak ada"
    → Asisten AI kamu belum di-start sekali. Jalankan dulu asistennya, lalu install ulang skill.

    "Bash script error: ./satutim_help.sh: Permission denied"
    → Set executable: chmod +x ~/.ai-assistant/skills/satutim/tools/*.sh. One-liner installer harusnya udah handle ini.

    Kalau masalah persisten, hubungi support via /support/new dengan workspace ID + error message dari test koneksi.

    AI Canggih butuh paket Pro+. Settings UI tampil di semua plan tapi switch disabled untuk Free.