Cara Menggunakan AI OpenHands: Panduan Praktis untuk Pengaturan, Prompt, dan Alur Kerja Dunia Nyata
Jika Anda pernah berharap seorang developer yang mumpuni dapat melakukan dengan Anda 24/7, AI OpenHands sangat mendekati hal tersebut. Ini adalah "" sumber terbuka yang dapat membaca Anda, menulis kode, menjalankan terminal, menjelajahi dokumen, dan melakukan iterasi—seperti seorang yang belajar dengan cepat dan bekerja tanpa lelah. Tetapi kekuatannya baru terasa setelah Anda mengaturnya dengan benar dan belajar cara mengarahkannya.
Panduan ini memandu Anda langkah demi langkah tentang cara menggunakan AI OpenHands—mulai dari instalasi hingga alur kerja tingkat lanjut—sehingga Anda dapat mengirimkan () lebih cepat dengan percaya diri.
- Apa yang akan kita bahas:
- Opsi instalasi dan mulai cepat
- Menjalankan OpenHands secara lokal atau dengan model
- Praktik terbaik untuk , , dan tugas
- Alur kerja yang terbukti untuk pekerjaan fitur, , pengujian, dan dokumentasi
- , privasi, dan kolaborasi
Perlu diperhatikan: OpenHands secara aktif dikembangkan oleh tim All Hands dan komunitas. Dokumentasi resmi adalah panduan utama Anda untuk instruksi dan tips terkini. Anda juga dapat mengikuti panduan instalasi langsung dari praktisi yang telah mendokumentasikan pengaturan lokal dan VM. Untuk menjalankan dengan model lokal, dokumentasi juga menyertakan panduan khusus.
Apa Itu AI OpenHands—dan Mengapa Menggunakannya?
Anggap AI OpenHands sebagai rekan tim AI dengan . Tidak seperti asisten berbasis obrolan saja, OpenHands dapat:
- Membuka dan membaca proyek
- Menggunakan terminal untuk menjalankan perintah, pengujian, dan
- Mengedit kode di seluruh dan direktori
- Menjelajahi web (tergantung konfigurasi)
- Mengusulkan dan menerapkan rencana langkah demi langkah
Ini membuatnya ideal untuk tugas-tugas seperti mengimplementasikan fitur, memperbaiki , menulis pengujian, membuat dokumentasi, melakukan , dan memodernisasi . Alih-alih melakukan dengan dan , Anda memberi OpenHands tujuan dan membiarkannya melakukan iterasi, dengan Anda mengawasi gerakannya.
Mulai Cepat: Cara Tercepat untuk Menggunakan OpenHands
Ada beberapa cara untuk memulai. Pilihan Anda tergantung pada apakah Anda ingin menggunakan LLM atau menjalankan semuanya secara lokal.
Opsi A: Gunakan LLM (termudah)
- Ikuti dokumentasi resmi "Start Building" dan "Getting Started" untuk menginstal dan menjalankan aplikasi. Anda biasanya akan:
- Menginstal prasyarat (Docker, Node, Python, Git tergantung pada jalur)
- Memberikan kunci API untuk model yang didukung (misalnya, OpenAI, Anthropic, atau yang lainnya yang didukung proyek pada saat itu)
- Meluncurkan antarmuka OpenHands dan menghubungkan repositori Anda
Jalur ini membuat Anda produktif dengan cepat dengan minimal.
Opsi B: Jalankan OpenHands dengan LLM Lokal
- Jika Anda lebih suka menyimpan kode dan di luar atau ingin menghindari biaya API, gunakan panduan LLM Lokal di dokumentasi resmi.
- Menyiapkan model lokal yang kompatibel (melalui Ollama atau lain yang didukung pada saat itu)
- Mengonfigurasi model dan batas konteks
- Memastikan mesin Anda memiliki VRAM/CPU dan ruang disk yang memadai
Opsi C: Deploy ke VM
- Jika Anda memerlukan lingkungan khusus, praktisi telah mendokumentasikan cara memutar OpenHands di VM dan membuat aplikasi dalam hitungan menit. Ini berguna untuk tim yang menginginkan instans yang stabil dan bersama.
Jalankan Pertama Kali: Pengaturan Proyek dan Pembingkaian Tugas
OpenHands bersinar ketika dapat melihat kode Anda. Mulailah dengan:
- Membuka repositori yang ingin dikerjakan.
- Menjalankan atau mengindeks proyek sehingga OpenHands dapat memetakan strukturnya.
- Memberinya tujuan yang jelas dengan batasan.
Contoh pembingkaian tugas yang baik:
- "Tambahkan fitur pengaturan ulang kata sandi pengguna ke layanan
auth menggunakan tautan email berbasis token. Gunakan modul mailer yang ada. Tambahkan pengujian unit untuk pembuatan dan kedaluwarsa token. Jangan mengubah skema data pengguna."
Mengapa ini berhasil:
- Ini menyebutkan komponen, ruang lingkup, dependensi, dan batasan. Semakin jelas Anda, semakin baik OpenHands merencanakan dan mengeksekusi.
Cara Menulis Prompt yang Efektif untuk OpenHands
Anggap sebagai tiket ringkas. Yang terbaik:
- Mendefinisikan hasil: "Implementasikan X dengan batasan Y"
- Mereferensikan , modul, atau pengujian: "Lihat
auth/routes.py dan tests/test_auth.py"
- Menyatakan batasan: "Tidak ada perubahan skema DB; pertahankan antarmuka yang ada"
- Menyertakan kriteria penerimaan: "Pengujian harus lulus:
pytest -k password_reset"
Templat yang dapat Anda gunakan kembali:
Tujuan: <Apa yang ingin dibangun atau diperbaiki>
Konteks: <File yang relevan, batasan yang diketahui, layanan eksternal>
Penerimaan: <Seperti apa kelulusan: pengujian, , metrik>
Batasan: <Apa yang tidak boleh diubah atau pendekatan yang harus dihindari>
Alat: <Perintah yang dapat dijalankan, skrip, atau sumber data>
Alur Kerja Inti: Rencanakan → Eksekusi → Verifikasi → Perbaiki
OpenHands biasanya mengusulkan rencana multi-langkah. Inilah cara memandunya:
- Setujui atau sesuaikan rencananya sejak awal. Dorong untuk menjalankan pengujian terlebih dahulu untuk menentukan kegagalan dasar.
- Minta untuk membuat atau memperbarui pengujian untuk menentukan keberhasilan, lalu implementasikan kode.
- Minta untuk menjalankan rangkaian pengujian dan secara berkala.
- Jika macet, tambahkan lebih banyak konteks: nama , , atau .
Tip pro: Dorong perubahan kecil seukuran PR alih-alih pengeditan monolitik. Ini membantu dengan kemampuan peninjauan dan pengembalian.
Contoh Alur Kerja yang Dapat Anda Salin
1) Implementasi Fitur
- : "Tambahkan ekspor CSV ke halaman
orders. Gunakan , hasil melalui text/csv. Tambahkan tombol Export di OrdersTable.jsx dan di routes/orders.ts. Sertakan pengujian untuk dan ."
- Langkah-langkah OpenHands:
- Memindai ; menyusun rencana
- Menambahkan dan tombol klien
- Menulis pengujian dan menjalankannya
- Melakukan iterasi pada kegagalan
- Anda mengawasi, menyetujui perubahan, dan menggabungkan setelah hijau.
2) Mendebug Build yang Gagal
- : "CI gagal pada Node 20. Perbaiki kesalahan impor ESM/CJS di
build.mjs. Pertahankan yang ada; perbarui konfigurasi dan kode untuk lulus CI."
- Berikan atau tautan ke artefak CI.
- Minta OpenHands untuk mereplikasi secara lokal (
npm run build) dan mengusulkan minimal.
3) Cakupan Pengujian dan Pengerasan
- : "Tingkatkan cakupan untuk
payments/service.py dari 62% menjadi 85%+. Tambahkan pengujian unit untuk retry_charge, refund, webhook_signature. Jangan memodifikasi logika bisnis kecuali pengujian mengungkap ."
- Biarkan OpenHands menghasilkan pengujian, menjalankannya, dan memperbaikinya.
4) Dokumen dan Pengalaman Developer
- : "Buat
CONTRIBUTING.md dan DEVELOPMENT.md untuk ini. Sertakan pengaturan lingkungan, skrip, perintah pengujian, dan panduan PR."
- Minta untuk memverifikasi perintah dengan benar-benar menjalankannya.
: Jaga agar OpenHands Tetap Bermanfaat dan Aman
- Ruang lingkup direktori: Arahkan ke atau direktori tertentu untuk menghindari pengeditan yang tidak disengaja di tempat lain.
- Perlindungan : Tandai konfigurasi atau infrastruktur penting sebagai hanya baca jika memungkinkan.
- Audit perintah: Memerlukan persetujuan untuk perintah destruktif (misalnya,
rm -rf, pengaturan ulang ).
- Kebersihan rahasia: Jangan pernah menempelkan kunci API ke dalam . Gunakan variabel lingkungan dan yang ditutupi.
- Akses jaringan: Jika penjelajahan diaktifkan, lakukan dan catat panggilan keluar.
Model Lokal vs : Memilih yang Tepat untuk Anda
- Pro: Penalaran/ yang kuat, pengaturan minimal, iterasi cepat
- Kontra: Biaya berkelanjutan, pertimbangan tata kelola data
- Pro: Privasi, kontrol, prediktabilitas biaya
- Kontra: Tuntutan perangkat keras, kualitas model bervariasi, lebih banyak diperlukan
Lihat instruksi LLM Lokal resmi untuk mengonfigurasi model dan batas memori.
Bermain Tim: Menggunakan OpenHands dalam Alur Kolaboratif
- Alur kerja berbasis cabang: Minta OpenHands membuat cabang fitur dan mendorong perubahan untuk peninjauan PR.
- Kebersihan : Minta untuk menghasilkan atomik dengan pesan yang jelas dan nomor masalah referensi.
- Templat PR: Hasilkan dan terapkan templat PR sehingga peninjau tahu apa yang berubah dan mengapa.
- Pemilik kode: Gabungkan dengan CODEOWNERS untuk mengarahkan PR yang dibuat oleh AI ke peninjau yang tepat.
Memecahkan Masalah Umum
- Macet atau : Sempitkan ruang lingkup. Minta untuk menjelaskan langkah berikutnya. Berikan pengujian yang gagal.
- berantakan: Minta rencana yang lebih kecil dan bertahap—pengujian terlebih dahulu, lalu perubahan kode minimal.
- Pengeditan yang salah: Tentukan jalur yang tepat dan ingatkan tentang batasan.
- Lulus secara lokal tetapi gagal di CI: Bagikan detail lingkungan CI dan ; minta untuk mereplikasi dengan .
Tips Kinerja dan Langkah Kuat
- Konteks : Minta untuk membaca kunci terlebih dahulu (
README, package.json, layanan utama).
- Berikan skrip: Berikan
make test atau npm run verify sehingga dapat memvalidasi dengan cepat.
- Ajarkan domain: Tawarkan ikhtisar arsitektur singkat; itu terbayar dalam lebih sedikit kesalahan logika.
- Terapkan gaya: Arahkan ke konfigurasi
.eslintrc, .prettierrc, black/ruff sehingga format dengan benar.
- Gunakan : Setelah setiap pencapaian, minta ringkasan dan langkah selanjutnya agar tetap di jalur yang benar.
Skenario Dunia Nyata: Dari Laporan Bug hingga Patch dalam Satu Jam
- Situasi: produksi menjatuhkan 500 yang tidak tertangani pada JSON yang salah format di API
orders.
- Anda: "Reproduksi 500 pada JSON yang salah format di POST
orders. Tambahkan validasi skema dan kembalikan 400 dengan detail kesalahan. Perbarui pengujian untuk mencakup yang salah format."
- Menjalankan API secara lokal, mereproduksi kesalahan
- Menambahkan lapisan validasi dan penangan kesalahan
- Memperbarui pengujian dan memastikan CI lulus
- Menghasilkan PR ringkas dengan entri
Waktu yang dihemat: Anda fokus pada analisis dampak dan peluncuran, sementara OpenHands menangani .
Integrasi Yang Meningkatkan Kekuatan OpenHands
- Pelari pengujian: pytest, Jest, Vitest, JUnit
- Alat : Vite, Webpack, Rollup, Babel
- Pengelola paket: npm, pnpm, yarn, pip/poetry
- /pemformat: ESLint, Prettier, black, ruff
- : Docker Compose untuk paritas lokal dengan CI
Dengan membakukan alat-alat ini, OpenHands dapat bernalar tentang tumpukan Anda dengan lebih andal dan mengotomatiskan lebih banyak .
Omong-omong: Menggunakan Sider.AI Bersama OpenHands
Skor relevansi: 8/10. Jika Anda menggunakan OpenHands sebagai Anda, ada baiknya memasangkannya dengan penelitian dan penyusunan untuk spesifikasi, deskripsi PR, dan dokumentasi. Omong-omong, Sider.AI dapat membantu Anda dengan cepat menyusun spesifikasi teknis, meringkas RFC, atau mengubah jalankan OpenHands menjadi dan catatan rilis yang bersih. Kombinasi ini mengurangi peralihan konteks: OpenHands menangani tindakan kode sementara Sider.AI mengubah hasil menjadi dokumen yang bersih dan berorientasi pada pengguna.
Daftar Periksa Keamanan, Privasi, dan Kepatuhan
- Simpan rahasia dalam variabel lingkungan; jangan pernah menyematkan kunci dalam
- Tinjau setiap perubahan yang dihasilkan AI seperti Anda meninjau PR seorang
- Catat perintah dan tindakan untuk auditabilitas
- Sematkan versi ; hindari peningkatan yang tidak disengaja dalam
- Jika menggunakan LLM , sesuaikan dengan kebijakan penyimpanan data Anda
Kapan Tidak Menggunakan OpenHands
- Desain algoritma baru tanpa pengujian yang kuat atau spesifikasi
- yang sangat diatur tanpa proses peninjauan yang kuat
- Skrip sekali pakai di mana manual lebih cepat
60 Menit Pertama Anda dengan OpenHands: Buku Pedoman Mini
- Menit 0–10: Instal dan luncurkan menggunakan Mulai Cepat resmi
- Menit 10–20: Hubungkan Anda; minta untuk memetakan struktur proyek
- Menit 20–35: Tentukan tujuan kecil yang dapat diuji; setujui rencananya
- Menit 35–50: Biarkan mengimplementasikan dan menjalankan pengujian; dorong seperlunya
- Menit 50–60: Tinjau , perbaiki, dan gabungkan ke dalam cabang fitur
Tautan Utama dan Langkah Selanjutnya
- Dokumentasi resmi "Start Building" dan penggunaan untuk OpenHands: tips, mulai cepat, dan praktik terbaik.
- Panduan pengaturan LLM Lokal: konfigurasikan dan jalankan OpenHands sepenuhnya di mesin Anda.
- Panduan instalasi berbasis komunitas di VM: langkah-langkah instalasi dunia nyata dan proyek demo cepat.
Kesimpulan
- Bingkai tugas seperti tiket dengan kriteria penerimaan yang jelas.
- Jaga agar iterasi tetap kecil; uji lebih awal dan sering.
- Gunakan dan tinjau perubahan—perlakukan seperti rekan tim .
- Pilih untuk kenyamanan, model lokal untuk privasi.
- Pasangkan dengan alat dokumentasi (misalnya, Sider.AI) untuk mempercepat spesifikasi dan catatan rilis.
FAQ
Q1:Bagaimana cara menginstal dan mulai menggunakan AI OpenHands dengan cepat?
Gunakan mulai cepat resmi untuk menginstal prasyarat, pasang LLM yang didukung ( atau lokal), dan luncurkan UI untuk menghubungkan repositori Anda. Dokumen "Start Building" memberikan instruksi langkah demi langkah dengan tips pengaturan.
Q2:Bisakah saya menjalankan OpenHands dengan LLM lokal alih-alih model ?
Ya. Ikuti panduan LLM Lokal untuk mengonfigurasi model lokal dan menyesuaikan pengaturan konteks. Ini ideal untuk proyek yang sensitif terhadap privasi atau menghindari biaya API.
Q3:Apa cara terbaik untuk meminta OpenHands untuk tugas ?
Tulis seperti tiket ringkas: definisikan tujuan, referensikan tertentu, tetapkan batasan, dan sertakan kriteria penerimaan. Minta untuk membuat atau menjalankan pengujian untuk memvalidasi kemajuan.
Q4:Apakah AI OpenHands aman digunakan pada kode produksi?
Perlakukan seperti : gunakan perlindungan cabang, peninjauan kode, dan CI untuk memvalidasi perubahan. Tambahkan untuk perintah dan jauhkan rahasia dari .
Q5:Bagaimana OpenHands dibandingkan dengan asisten kode tradisional?
Tidak seperti alat berbasis obrolan saja, OpenHands dapat menjalankan perintah, mengedit , dan melakukan iterasi secara otonom di dalam Anda. Ini dibuat untuk tugas seperti fitur, , dan pengujian.
