Ingin menggunakan model AI sendiri untuk coding tanpa pengaturan yang rumit? Droid memudahkannya dengan mendukung API eksternal di CLI-nya, sehingga Anda dapat menghubungkan model kustom yang sesuai dengan alur kerja Anda. Panduan ini menunjukkan cara menyiapkan API, mengatasi masalah umum, dan menggunakan Kimi di Droid. Lanjutkan membaca untuk memulai.
Apa itu Droid?
Droid adalah alat coding AI yang membantu pengembang menulis kode, mengatasi error, dan menangani tugas pengembangan dengan lebih efisien. Droid mendukung model AI bawaan dan juga memungkinkan pengguna menghubungkan model kustom melalui CLI-nya agar lebih fleksibel. Ini berguna untuk berbagai alur kerja coding, baik saat Anda membutuhkan bantuan cepat maupun pengaturan yang lebih personal.
Cara menggunakan model AI bawaan di Droid?
Model AI bawaan memudahkan Anda mulai coding dengan Droid karena tidak perlu terlebih dahulu terhubung ke API eksternal. Setelah aplikasi terinstal, Anda dapat memilih model di dalam platform dan mulai menggunakan bantuan AI untuk analisis kode, pengerjaan fitur, perbaikan bug, serta peninjauan. Berikut cara memulai dengan Droid:
Langkah 1: Instal dan buka Droid
Mulailah dengan mengunduh Factory App ke perangkat Anda dan menyelesaikan instalasinya. Setelah itu, buka aplikasi dan masuk ke akun Anda. Dengan begitu, Anda dapat mengakses Droid serta fitur AI bawaannya di dalam aplikasi.
Langkah 2: Hubungkan Droid ke folder proyek Anda
Atur direktori kerja ke codebase yang ingin Anda kerjakan. Ini menghubungkan Droid dengan proyek lokal Anda agar dapat membaca file, memahami struktur kode, dan mendukung tugas pengembangan Anda dengan konteks yang lebih baik.
Langkah 3: Pilih model bawaan dan mulai memberi prompt
Buka pemilih model dan pilih salah satu model AI bawaan yang tersedia di Droid. Setelah model dipilih, Anda dapat mulai memberikan prompt, misalnya memintanya menganalisis codebase, memperbaiki bug, meninjau kode, atau membuat fitur.
Cara menghubungkan Droid ke API eksternal?
Menghubungkan Droid ke API eksternal memberi Anda lebih banyak kebebasan untuk menggunakan model yang diinginkan, alih-alih terbatas pada opsi bawaan. Pengaturan dilakukan di Droid CLI dengan menambahkan model kustom ke file pengaturan. Setelah disimpan, model tersedia dari menu /model. Langkah-langkah berikut menggunakan Kimi sebagai contoh sederhana agar Anda dapat melihat cara kerja pengaturan lengkap, dari kunci API hingga pemilihan model:
Langkah 1: Dapatkan kunci Kimi API dari Moonshot AI
Mulailah dengan membuat atau menyalin kunci Kimi API Anda dari Moonshot AI. Anda memerlukan kunci ini karena Droid menggunakannya untuk terhubung ke Kimi API dan mengirim permintaan melalui akun Anda sendiri. Sebaiknya simpan kunci tersebut sebagai variabel lingkungan seperti MOONSHOT_API_KEY agar dapat digunakan dengan aman di dalam file pengaturan.
Langkah 2: Buka file pengaturan Droid
Selanjutnya, buka file pengaturan tempat model kustom ditambahkan di Droid CLI. Di macOS, jalur filenya adalah ~/.factory/settings.json. Di Windows PowerShell, gunakan %USERPROFILE%\.factory\settings.json. Ini adalah file utama yang digunakan Droid untuk membaca konfigurasi model kustom Anda.
Langkah 3: Tambahkan Kimi sebagai model kustom
Di dalam settings.json, tambahkan Kimi pada array customModels. Ini memberi tahu Droid model yang akan digunakan, endpoint API yang harus dipanggil, format penyedia yang diikuti, serta kunci API yang digunakan untuk autentikasi. Jika file tersebut sudah memiliki pengaturan lain, jangan mengganti semuanya; cukup tambahkan objek model ini ke dalam array customModels yang ada.
Langkah 4: Simpan file dan mulai ulang Droid
Setelah menambahkan konfigurasi, simpan file lalu mulai ulang Droid CLI. Ini memastikan Droid memuat ulang pengaturan yang diperbarui dan mengenali model kustom yang baru ditambahkan dengan benar.
Langkah 5: Pilih model Kimi menggunakan /model di dalam Droid
Buka Droid CLI dan jalankan perintah /model. Pengaturan Kimi Anda kini akan muncul di bagian model kustom. Pilih dari daftar untuk menjadikan Kimi sebagai model aktif untuk sesi coding Anda.
Langkah 6: Jalankan tugas
Setelah Kimi dipilih, Anda dapat mulai menggunakannya untuk pekerjaan nyata di Droid. Coba prompt seperti meninjau kode, memperbaiki bug, atau menjelaskan basis kode. Droid akan mengirim permintaan melalui Kimi API dan menggunakan model tersebut untuk mengerjakan tugas.
Manfaat menggunakan Kimi API
Setelah menghubungkan Kimi ke Droid, Kimi menjadi lebih dari sekadar model eksternal di CLI. Kimi menjadi asisten coding praktis yang menyatu dengan alur kerja pengembangan sehari-hari dan membantu pekerjaan coding kecil maupun tugas engineering yang lebih besar. Berikut beberapa manfaat menggunakan Kimi API:
Tingkatkan efisiensi pengembangan
Kimi dapat membantu Anda menyelesaikan tugas coding sehari-hari lebih cepat dengan menghasilkan kode, menjelaskan logika, dan menyarankan perbaikan saat Anda bekerja. Artinya, Anda tidak perlu berpindah-pindah antaralat untuk dukungan pengembangan sederhana. Dengan Kimi di dalam Droid, pekerjaan pemrograman rutin dapat dikelola lebih cepat.
Tulis kode yang lebih andal
Kimi dapat meninjau kode Anda, menunjukkan potensi masalah, dan membantu memperbaiki strukturnya sebelum kesalahan kecil menjadi masalah yang lebih besar. Umpan balik awal seperti ini berguna saat Anda menginginkan logika yang lebih bersih dan kemudahan pemeliharaan yang lebih baik. Seiring waktu, Kimi dapat membantu Anda membangun kode yang lebih mudah diuji, diperbarui, dan dipahami.
Tangani beragam tugas pengembangan
Kimi tidak terbatas pada penulisan kode dari awal. Kimi juga dapat membantu refactoring, mendokumentasikan kode, memahami proyek yang belum familier, serta mendukung pengembangan fitur untuk berbagai tugas. Ini menjadikannya pilihan fleksibel bagi developer yang ingin satu model AI membantu banyak bagian dalam alur kerja.
Pemecahan masalah umum saat menghubungkan API
Menghubungkan kunci API eksternal di Droid biasanya mudah, tetapi kesalahan kecil saat pengaturan tetap dapat menimbulkan masalah. Sebagian besar masalah berasal dari file pengaturan, nama provider, kunci API, atau konfigurasi server model, bukan dari Droid itu sendiri. Kabar baiknya, kesalahan ini sering kali mudah diperbaiki setelah Anda mengetahui bagian yang perlu diperiksa.
Model tidak muncul di pemilih
Periksa sintaks JSON di
~/.factory/settings.jsonatauconfig.jsonjika Anda menggunakan format lamaPerubahan pengaturan terdeteksi secara otomatis melalui pemantauan file
Pastikan semua kolom yang diperlukan ada dalam konfigurasi model kustom
Error "provider tidak valid"
Pastikan nilai provider tepat berupa
anthropic,openai, ataugeneric-chat-completion-apiPeriksa kesalahan ejaan dan penggunaan huruf besar yang benar pada kolom provider
Error autentikasi
Pastikan kunci API Anda valid dan memiliki kredit yang tersedia
Periksa bahwa kunci API memiliki izin yang tepat untuk provider
Pastikan URL dasar sesuai dengan endpoint API dalam dokumentasi provider
Model lokal tidak dapat terhubung
Pastikan server model lokal Anda berjalan, seperti
ollama servePastikan URL dasar sudah benar dan menyertakan
/v1/jika diwajibkan oleh providerPeriksa bahwa model sudah diunduh atau tersedia secara lokal
Error batas laju atau kuota
Periksa batas laju API dan kuota penggunaan provider Anda
Pantau penggunaan Anda di dashboard provider untuk mengetahui apakah batas telah tercapai
Kesimpulan
Menggunakan API kustom di Droid memberi Anda kontrol lebih besar atas cara membangun, menguji, dan meningkatkan kode dengan AI. Setelah pengaturan selesai, Anda akan lebih mudah menyesuaikan alur kerja coding dengan model yang sesuai kebutuhan. Baik tetap menggunakan opsi bawaan maupun menghubungkan model eksternal, Droid menawarkan cara fleksibel untuk menghadirkan AI ke dalam pengembangan. Jika Anda ingin memulai pengaturan kustom dengan mudah, Kimi layak dicoba di Droid. Kimi dapat menjadi pilihan praktis untuk membuat pekerjaan coding sehari-hari lebih lancar dan cepat.