AI Canggih: Pakai Kunci AI Sendiri

Mau AI yang lebih kuat atau batas pemakaian lebih lega? Di halaman "Pengaturan AI" kamu bisa memilih model AI bawaan SatuTim untuk workspace. Pilihan "Hermes 4 (NousResearch via OpenRouter)" dan kolom "OpenRouter API key (opsional)" memang ada di halaman itu, tapi saat ini belum dipakai fitur AI SatuTim. Semua fitur AI tetap memakai AI bawaan SatuTim dan tetap mengurangi kuota AI workspace.

  1. 1

    Apa ini dan kenapa dipakai

    Secara default, fitur AI SatuTim (Brief Triage, Daily Brief, AI Scaffold, AI Ask, dll) jalan pakai AI bawaan SatuTim yang dioptimalkan untuk Bahasa Indonesia. (Smart Estimation bukan fitur AI: perkiraannya dihitung dari riwayat tugas workspace, dan butuh paket Business.) Buat tim yang butuh lebih, SatuTim juga bisa kamu sambungkan ke kunci AI milikmu sendiri. Saat ini memasang key OpenRouter belum menambah kuota dan belum membuat tagihan AI terpisah. Yang sudah berfungsi: memilih Model AI bawaan untuk workspace (mis. SatuTim AI — Akurat) di halaman Pengaturan AI.

    • 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.
    • Reasoning mode (Hermes) hanya berlaku untuk pilihan Hermes 4, dan saat ini belum dipakai fitur seperti Brief Triage atau chat AI. Brief Triage selalu jalan pakai AI bawaan SatuTim.
  2. 2

    Aktifkan di workspace: Pengaturan AI

    Buka https://satutim.id/settings/ai (link ini otomatis diarahkan ke https://app.satutim.id/settings/ai). Halaman Pengaturan AI belum ada di menu mana pun, jadi buka langsung lewat alamat itu. Di bagian Provider ada 2 kartu: AI bawaan SatuTim (default) dan Hermes 4 (NousResearch via OpenRouter). Pilih tingkat kecerdasan AI yang kamu mau. Klik tombol "Simpan pengaturan" hijau di bottom bar. Yang dipakai fitur AI (Brief Triage, AI Scaffold, AI Ask, dll) saat ini hanya pilihan Model di kartu AI bawaan SatuTim (default). Kalau kamu memilih Hermes 4 (NousResearch via OpenRouter), fitur AI tetap jalan pakai AI bawaan SatuTim dengan model default SatuTim AI — Cepat. Daily Brief selalu memakai model bawaannya sendiri.

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

    Pilih tingkat kecerdasan AI

    Di bagian Model: kalau kartu AI bawaan SatuTim (default) aktif, pilihannya SatuTim AI — Cepat (default), SatuTim AI — Akurat, SatuTim AI — Lite (ringan) dan SatuTim AI — Legacy (deprecated). Pilihan inilah yang dipakai fitur AI. Kalau kartu Hermes aktif, pilihannya Hermes 4 70B, Hermes 4 405B dan DeepHermes 3 (Mistral 24B Preview), tapi model Hermes saat ini belum dipakai fitur AI SatuTim.

    • Untuk Brief Triage yang kompleks, tetap di kartu "AI bawaan SatuTim (default)", pilih model "SatuTim AI — Akurat", lalu klik "Simpan pengaturan". Pilihan Hermes dan "Reasoning mode (Hermes)" belum berpengaruh ke Brief Triage.
  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. Pemakaian AI tidak ditagih terpisah. Setiap pemakaian AI mengurangi kuota AI bulanan workspace sesuai paketmu. Kalau kuota habis, upgrade paket atau tunggu kuota di-reset tiap tanggal 1. Praktis, gak perlu daftar akun penyedia AI sendiri.
    1. Kunci sendiri (Bring Your Own), bawa kunci AI milikmu sendiri. Kunci yang diterima hanya API key OpenRouter (format sk-or-v1-..., buat di openrouter.ai/keys). Pilih kartu Hermes 4 (NousResearch via OpenRouter), tempel key di kolom OpenRouter API key (opsional), lalu klik Simpan pengaturan. Catatan: saat ini key ini belum dipakai fitur AI SatuTim. Saat ini belum ada pemakaian yang ditagihkan ke akun OpenRouter kamu, karena fitur AI SatuTim belum memakai key tersebut.
    • Kunci sendiri disimpan terenkripsi dengan aman, gak akan ditampilkan ulang setelah save
    • Ganti key: tempel key baru di kolom "OpenRouter API key (opsional)" lalu klik "Simpan pengaturan". Key lama hanya diganti di SatuTim, tidak dimatikan di OpenRouter. Kalau mau mematikannya, hapus juga di dashboard OpenRouter.
    • Hapus key: pilih kartu Hermes, lalu di kotak "Key terpasang" klik "Hapus key".
    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. Di bagian Reasoning mode (Hermes) (muncul kalau kartu Hermes dipilih) ada tombol Auto, On (deliberate) dan Off (direct). Saat ini pengaturan ini hanya berpengaruh ke hasil Test koneksi, belum ke fitur AI SatuTim.

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

    • On (deliberate), 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 (direct), 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, 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, muncul Gagal: diikuti jenis error dan pesannya, mis. "Hermes lagi padat — terlalu banyak request…", "Credit OpenRouter habis…" atau "OpenRouter API key salah atau belum di-set…".

    • Test koneksi mengetes provider, model dan reasoning yang sedang kamu pilih (boleh sebelum disimpan). Test ini tidak mengetes OpenRouter API key milikmu, karena selalu memakai koneksi bawaan SatuTim.
    • Kecepatan normal: 500-2000ms mode langsung, 2000-8000ms mode analisis mendalam
    • Hasil Test koneksi hanya mencerminkan pilihan di layar. Fitur AI selalu memakai AI bawaan SatuTim dengan Model yang tersimpan di kartu "AI bawaan SatuTim (default)". Tidak ada jeda cache 60 detik.
  7. 7

    Migrasi gradual dari AI bawaan

    Saat ini pindah ke Hermes belum berdampak ke fitur SatuTim: AI Scaffold, Daily Brief dan Brief Triage tetap memakai AI bawaan. Kalau mau mencoba model lain, ganti Model di kartu AI bawaan SatuTim (default) (mis. SatuTim AI — Akurat), klik Simpan pengaturan, lalu bandingkan hasilnya.

    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: karena key OpenRouter belum dipakai fitur SatuTim, dashboard OpenRouter kamu tidak akan menunjukkan pemakaian dari SatuTim.

    • Pakai kuota bawaan: buka Pengaturan → Billing & Paket. Kartu Pemakaian AI (30 hari terakhir) menampilkan Token terpakai, Total panggilan, Error rate, pemakaian per fitur dan pengguna teratas. Kartu ini muncul setelah ada pemakaian AI. Belum ada perkiraan biaya, dan batas paket dihitung dari jumlah request AI, bukan token.

    • 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 (pesan Hermes ini saat ini hanya muncul di Test koneksi):

    • Terlalu padat: "Hermes lagi padat — terlalu banyak request…", tunggu 1-5 menit
    • Kuota habis: "Credit OpenRouter habis…", top-up di akun penyedia AI kamu ATAU switch ke kuota bawaan
    • Server sibuk: "Hermes lagi maintenance di sisi OpenRouter…", sementara, dicoba ulang otomatis sampai 3x
    • Timeout: permintaan terlalu kompleks atau AI sedang penuh, coba persingkat input
    • Konfigurasi: "OpenRouter API key salah atau belum di-set…"
    • 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. Skill terminal ini dibuat khusus untuk Hermes Agent (perintahnya hermes-cli "..."), jadi tidak bisa dipasang di sembarang asisten AI terminal. Untuk ini, install skill SatuTim ke asisten AI terminal kamu.

    One-liner install (recommended):

    curl -sSL https://app.satutim.id/skills/install-hermes-agent.sh | SATUTIM_SKILL_URL=https://app.satutim.id/skills/satutim-hermes-agent.tar.gz bash

    Script ini mengecek curl/tar/jq, mem-backup install lama, men-download, meng-extract ke ~/.hermes/skills/satutim, lalu menampilkan langkah selanjutnya.

    Alternative MANUAL:

    mkdir -p ~/.hermes/skills
curl -sSL https://app.satutim.id/skills/satutim-hermes-agent.tar.gz | \
  tar -xz -C ~/.hermes/skills/
chmod +x ~/.hermes/skills/satutim/tools/*.sh

    Direktori akhir:

    ~/.hermes/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: jalankan bash ~/.hermes/skills/satutim/tools/satutim_list_projects.sh. Kalau token benar, daftar proyekmu akan tampil. (Tool satutim_my_tasks_today.sh saat ini belum jalan: API membalas "workspaceId atau projectId diperlukan".)

    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
    • Kamu bisa memakai token yang sama di beberapa asisten. Dari halaman "API & Integrations" saat ini kamu hanya bisa punya 1 token aktif. "Regenerate" membuat token baru sekaligus mematikan yang lama.
    • Belum ada halaman panduan khusus instalasi skill; panduannya ada di tutorial ini.
  11. 11

    Troubleshooting

    Case-by-case:

    "Provider gak bisa di-switch / dropdown disabled"
    → Pilihan provider tidak dikunci per paket; semua paket bisa memilih kartu. Kalau Simpan pengaturan gagal dengan pesan "Hanya owner / admin workspace yang bisa ubah pengaturan AI.", minta owner/admin workspace yang mengubahnya. (Fitur AI-nya sendiri tetap butuh paket Pro atau Business.)

    "Test koneksi sukses tapi Brief Triage masih pakai AI bawaan"
    → Itu memang perilaku saat ini: Brief Triage selalu memakai AI bawaan SatuTim (dengan Model dari kartu AI bawaan SatuTim (default)), apa pun provider yang kamu pilih. Refresh tidak mengubahnya. 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". Belum ada pengaturan instruksi khusus AI untuk workspace, jadi tulis saja instruksinya di permintaanmu.

    "Cost spike, tagihan penyedia AI naik drastis"
    → Fitur AI SatuTim saat ini tidak memakai key OpenRouter kamu, jadi lonjakan tagihan OpenRouter bukan berasal dari SatuTim. Pemakaian AI di SatuTim hanya mengurangi kuota AI workspace (cek di Pengaturan → Billing & Paket).

    "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"
    → Installer membuat folder skill sendiri. Kalau gagal saat download atau extract, pakai perintah install dengan link app.satutim.id di atas. Untuk install manual, buat dulu foldernya dengan mkdir -p ~/.hermes/skills.

    "Bash script error: ./satutim_help.sh: Permission denied"
    → Set executable: chmod +x ~/.hermes/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.

    Fitur AI SatuTim sendiri butuh paket Pro atau Business. Pilihan provider tidak dikunci per paket; semua paket bisa memilih kartu.