Goose

Goose (Block) adalah agen dev untuk CLI/desktop. Pakai provider OpenAI dengan host RouterKu.

Nilai koneksi

Langkah-langkah

1. Buat kunci RouterKu

   Menu Kunci API → buat kunci (qdr-...).

2. Konfigurasi provider

   Jalankan goose configure → Configure Providers → pilih OpenAI, masukkan API key = kunci RouterKu saat diminta.

3. Set host & model

   Set host lewat env atau berkas config, lalu pilih model sonnet-5:

   ~/.config/goose/config.yamlSalin

   GOOSE_PROVIDER: openai
   GOOSE_MODEL: sonnet-5
   OPENAI_HOST: HOST_DARI_DASBOR
   OPENAI_BASE_PATH: v1/chat/completions

Model yang disarankan

Tips

• Untuk sesi agen panjang dengan banyak tool, pakai opus-5.
• Extensions (MCP) Goose menambah panggilan tool — model kuat menjaga akurasi.
• Set GOOSE_MODEL ke haiku-45 untuk perintah cepat yang hemat.

Kalau bermasalah

• 401 / authentication failed / invalid_api_key — cek dulu apakah kuncinya memang mati, atau cuma tidak sampai ke permintaan. Jalankan uji mandiri di bawah: kalau balasannya 200, kunci kamu SEHAT dan masalahnya ada di konfigurasi Goose (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
• 401 padahal kunci sehat (1) — belum restart Goose. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang Goose.
• 401 padahal kunci sehat (2) — penulisan kunci kotor. Di file .env tulis polos tanpa kutip/spasi: ROUTERKU_API_KEY=qdr-... (bukan = "qdr-..."). Pastikan tidak ada spasi di ujung dan kunci tersalin utuh (tanpa terpotong).
• 401 padahal kunci sehat (3) — nama variabel salah. Rujukan seperti ${ROUTERKU_API_KEY} umumnya hanya dikenali bila namanya HURUF BESAR dan variabelnya benar-benar ada; kalau tidak, teks ${...} terkirim mentah sebagai kunci → 401. Saat ragu, isi kunci qdr-... langsung untuk memastikan.
• 402 / insufficient_balance — saldo habis. Isi lewat menu Isi Saldo.
• 404 / model_not_found — ID model salah. Pakai persis, mis. sonnet-5 (daftar di GET /v1/models).
• Tidak konek / timeout — pastikan Base URL berakhiran /v1 dan bisa diakses dari mesin Goose.
• 429 / rate_limited — melewati 240 permintaan/menit atau 24 paralel. Beri jeda atau kurangi konkurensi.

Uji mandiri kunci — jalankan di terminal mesin yang sama. Ganti qdr-... dengan kuncimu:

curl -s -o /dev/null -w "%{http_code}\n" BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"haiku-45","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'