CrewAI

CrewAI mengorkestrasi agen berbasis peran. LLM-nya lewat LiteLLM, jadi pakai prefiks openai/.

Nilai koneksi

Langkah-langkah

1. Pasang paket

   TerminalSalin

   pip install crewai

2. Buat kunci RouterKu

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

3. Definisikan LLM & agen

   Pakai prefiks openai/ pada nama model:

   pythonSalin

   from crewai import Agent, LLM
   
   llm = LLM(
       model="openai/sonnet-5",
       base_url="BASE_URL_DARI_DASBOR",
       api_key="qdr-...",
   )
   
   peneliti = Agent(
       role="Peneliti",
       goal="Menjawab pertanyaan dengan ringkas",
       backstory="Ahli riset",
       llm=llm,
   )

4. Rangkai Crew & jalankan

   Masukkan agen ke Crew bersama Task, lalu panggil crew.kickoff().

Model yang disarankan

Tips

• Beri model kuat openai/opus-5 ke agen manajer/perencana, model hemat ke agen pelaksana.
• Aktifkan verbose=True di Crew untuk memantau panggilan tool saat debug.
• Model ringan openai/haiku-45 cocok untuk agen formatting/ringkasan.

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 CrewAI (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
• 401 padahal kunci sehat (1) — belum restart CrewAI. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang CrewAI.
• 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 CrewAI.
• 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"}]}'