Kako koristiti AI OpenHands: Praktični vodič za podešavanje, promptove i radne tokove u stvarnom svetu
Ako ste ikada poželeli da sposoban programer može da programira sa vama u paru 24/7, AI OpenHands je iznenađujuće blizu tome. To je open-source "AI inženjer" koji može da čita vaš repo, piše kod, pokreće terminale, pretražuje dokumente i ponavlja – baš kao mlađi programer koji brzo uči i neumorno radi. Ali snaga se aktivira tek kada ga pravilno podesite i naučite kako da ga usmeravate.
Ovaj vodič vas vodi korak po korak kroz korišćenje AI OpenHands—od instalacije do naprednih radnih tokova—tako da možete brže da isporučujete uz pouzdanje.
- Opcije instalacije i brzi početak
- Pokretanje OpenHands lokalno ili sa cloud modelima
- Najbolje prakse za promptove, repoze i zadatke
- Provereni radni tokovi za rad na funkcijama, otklanjanje grešaka, testove i dokumente
- Zaštitne mere, privatnost i saradnja
Vredi napomenuti: OpenHands aktivno razvija All Hands tim i zajednica. Zvanična dokumentacija je vaša zvezda vodilja za trenutna uputstva i savete. Takođe možete pratiti praktične vodiče za instalaciju od praktičara koji su dokumentovali lokalna i VM podešavanja. Za pokretanje sa lokalnim modelima, dokumentacija takođe uključuje specifične smernice.
Šta je AI OpenHands—i zašto ga koristiti?
Zamislite AI OpenHands kao AI saigrača sa tastaturom. Za razliku od asistenata samo za ćaskanje, OpenHands može:
- Otvoriti i čitati datoteke projekta
- Koristiti terminal za pokretanje komandi, testova i lintera
- Uređivati kod u datotekama i direktorijumima
- Pretraživati veb (u zavisnosti od konfiguracije)
- Predložiti i primeniti planove korak po korak
Ovo ga čini idealnim za zadatke kao što su implementacija funkcija, popravljanje grešaka, pisanje testova, kreiranje dokumenata, refaktorisanje i modernizacija baza koda. Umesto žongliranja promptovima i kopiranja/lepljenja, date OpenHands cilj i pustite ga da ponavlja, a vi nadgledate njegove poteze.
Brzi početak: Najbrži način za korišćenje OpenHands
Postoji nekoliko načina da započnete. Vaš izbor zavisi od toga da li želite da koristite cloud LLM ili da pokrenete sve lokalno.
Opcija A: Koristite cloud LLM (najlakše)
- Pratite zvanična dokumenta "Start Building" i "Getting Started" da biste instalirali i pokrenuli aplikaciju. Tipično ćete:
- Instalirati preduslove (Docker, Node, Python, Git u zavisnosti od putanje)
- Obezbediti API ključ za podržani cloud model (npr. OpenAI, Anthropic, ili drugi koje projekat podržava u tom trenutku)
- Pokrenuti OpenHands interfejs i povezati svoj repozitorijum
Ova putanja vas brzo dovodi do produktivnosti uz minimalne računarske troškove.
Opcija B: Pokrenite OpenHands sa lokalnim LLM
- Ako više volite da držite kod i promptove van oblaka ili želite da izbegnete troškove API-ja, koristite vodič za lokalne LLM u zvaničnoj dokumentaciji.
- Podesiti kompatibilni lokalni model (putem Ollama ili drugih pozadina podržanih u tom trenutku)
- Konfigurisati krajnje tačke modela i limite konteksta
- Osigurati da vaša mašina ima adekvatnu VRAM/CPU i prostor na disku
Opcija C: Implementirajte na VM
- Ako vam je potrebno namensko okruženje, praktičari su dokumentovali kako da pokrenete OpenHands na VM-u i napravite aplikaciju za nekoliko minuta. Ovo je korisno za timove koji žele stabilnu, deljenu instancu AI inženjera.
Prvo pokretanje: Podešavanje projekta i uokviravanje zadataka
OpenHands blista kada može da vidi vaš kod. Počnite tako što ćete:
- Otvoriti repozitorijum na kojem želite da radi.
- Pokrenuti ili indeksirati projekat tako da OpenHands može da mapira strukturu.
- Dati mu jasan cilj sa ograničenjima.
Dobar primer uokviravanja zadatka:
- "Dodajte resetovanje lozinke korisnika u
auth servis koristeći email linkove zasnovane na tokenima. Koristite postojeći mailer modul. Dodajte unit testove za generisanje i istek tokena. Ne menjajte šemu podataka korisnika."
Zašto ovo radi:
- Imenuje komponentu, opseg, zavisnosti i granice. Što ste jasniji, to OpenHands bolje planira i izvršava.
Kako napisati efikasne promptove za OpenHands
Mislite o promptovima kao o konciznim tiketima. Najbolji:
- Definišu ishod: "Implementirajte X sa Y ograničenjima"
- Referišu se na datoteke, module ili testove: "Pogledajte
auth/routes.py i tests/test_auth.py"
- Navode ograničenja: "Nema promena šeme DB; zadržite postojeće interfejse"
- Uključuju kriterijume prihvatanja: "Testovi bi trebalo da prođu:
pytest -k password_reset"
Šablon koji možete ponovo da koristite:
Cilj: <Šta želite da bude izgrađeno ili popravljeno>
Kontekst: <Relevantne datoteke, poznata ograničenja, eksterne usluge>
Prihvatanje: <Kako izgleda prolaz: testovi, krajnje tačke, metrike>
Granice: <Šta ne treba menjati ili pristupi koje treba izbegavati>
Alati: <Komande koje može da pokrene, skripte ili izvori podataka>
Osnovni radni tok: Plan → Izvrši → Verifikuj → Poboljšaj
OpenHands obično predlaže plan u više koraka. Evo kako da ga vodite:
- Odobrite ili prilagodite njegov plan rano. Gurnite ga da prvo pokrene testove da biste odredili osnovne neuspehe.
- Zatražite od njega da kreira ili ažurira test da bi definisao uspeh, a zatim implementirajte kod.
- Neka često pokreće test suite i linters.
- Ako zastane, dodajte više konteksta: imena datoteka, stack tragove ili logove.
Pro tip: Ohrabrite male promene veličine PR-a umesto monolitnih izmena. Ovo pomaže u preglednosti i vraćanju.
Primeri radnih tokova koje možete kopirati
1) Implementacija funkcije
- Prompt: "Dodajte CSV izvoz na
orders stranicu. Koristite server-side paginaciju, streamujte rezultate putem text/csv. Dodajte Export dugme u OrdersTable.jsx i endpoint u routes/orders.ts. Uključite testove za paginaciju i headere."
- Skenira repo; nacrti plana
- Dodaje endpoint i klijentsko dugme
- Piše testove i pokreće ih
- Vi nadgledate, odobravate promene i spajate kada je zeleno.
2) Otklanjanje grešaka u neuspelom buildu
- Prompt: "CI ne uspeva na Node 20. Popravite ESM/CJS greške uvoza u
build.mjs. Zadržite postojeće rollup pluginove; ažurirajte konfiguraciju i kod da biste prošli CI."
- Obezbedite logove ili link do CI artefakata.
- Zatražite od OpenHands da replicira lokalno (
npm run build) i predloži minimalne diffove.
3) Pokrivenost testovima i ojačavanje
- Prompt: "Povećajte pokrivenost za
payments/service.py sa 62% na 85%+. Dodajte unit testove za retry_charge, refund, webhook_signature. Ne modifikujte poslovnu logiku osim ako test ne otkrije grešku."
- Neka OpenHands generiše testove, pokrene ih i poboljša.
4) Dokumentacija i iskustvo programera
- Prompt: "Kreirajte
CONTRIBUTING.md i DEVELOPMENT.md za ovaj repo. Uključite podešavanje okruženja, skripte, test komande i PR smernice."
- Neka verifikuje komande tako što će ih stvarno pokrenuti.
Zaštitne mere: Održavajte OpenHands korisnim i bezbednim
- Opseg direktorijuma: Usmjerite ga na određeni repo ili direktorijum da biste izbegli slučajne izmene drugde.
- Zaštita datoteka: Označite konfiguracione datoteke ili kritičnu infrastrukturu kao samo za čitanje gde je to moguće.
- Revizija komandi: Zahtevajte odobrenje za destruktivne komande (npr.
rm -rf, resetovanje baze podataka).
- Higijena tajni: Nikada ne lepite API ključeve u promptove. Koristite promenljive okruženja i maskirane logove.
- Pristup mreži: Ako je pretraživanje omogućeno, izolujte ga i evidentirajte odlazne pozive.
Lokalni vs Cloud modeli: Izbor onoga što je pravo za vas
- Prednosti: Snažno rezonovanje/kodiranje, minimalno podešavanje, brza iteracija
- Nedostaci: Tekući troškovi, razmatranja upravljanja podacima
- Prednosti: Privatnost, kontrola, predvidljivost troškova
- Nedostaci: Zahtevi za hardverom, kvalitet modela varira, potrebno je više podešavanja
Pogledajte zvanična uputstva za lokalne LLM da biste konfigurisali pozadine modela i limite memorije.
Timski rad: Korišćenje OpenHands u toku saradnje
- Radni tok prvi sa granom: Neka OpenHands kreira granu funkcije i gura promene za PR pregled.
- Higijena commita: Zatražite od njega da proizvede atomske commitove sa jasnim porukama i referentnim brojevima izdanja.
- PR šabloni: Generišite i sprovedite PR šablone tako da recenzenti znaju šta se promenilo i zašto.
- Vlasnici koda: Kombinujte sa CODEOWNERS da biste usmerili PR-ove generisane veštačkom inteligencijom pravim recenzentima.
Rešavanje uobičajenih problema
- Zaglavljuje se ili petlja: Smanjite opseg. Zatražite od njega da objasni svoj sledeći korak. Obezbedite neuspešan test.
- Neuredni diffovi: Zatražite manji, postepeni plan—prvo testove, a zatim minimalne promene koda.
- Pogrešne izmene datoteka: Navedite tačne putanje i podsetite ga na granice.
- Prolazi lokalno, ali ne uspeva u CI: Podelite detalje CI okruženja i logove; neka replicira sa kontejnerom.
Saveti za performanse i moćni potezi
- Kontekst toplog starta: Zatražite od njega da prvo pročita ključne datoteke (
README, package.json, glavne datoteke usluge).
- Dajte mu skripte: Obezbedite
make test ili npm run verify tako da može brzo da validira.
- Naučite domen: Ponudite kratak arhitektonski pregled; isplati se u manje logičkih grešaka.
- Sprovesti stil: Usmjerite na
.eslintrc, .prettierrc, black/ruff konfiguracije tako da se pravilno formatira.
- Koristite kontrolne tačke: Nakon svake prekretnice, zatražite rezime i sledeće korake da biste ga održali na pravom putu.
Scenarij iz stvarnog sveta: Od izveštaja o grešci do zakrpe za sat vremena
- Situacija: Greška u produkciji izbacuje neobrađene 500-te na neispravnim JSON payloadovima u
orders API-ju.
- Vaš prompt: "Reprodukujte 500 na neispravnom JSON-u u
orders POST. Dodajte validaciju šeme i vratite 400 sa detaljima o grešci. Ažurirajte testove da pokriju neispravne payloadove."
- Pokreće API lokalno, reprodukuje grešku
- Dodaje sloj validacije i rukovalac greškama
- Ažurira testove i osigurava da CI prođe
- Proizvodi kompaktan PR sa unosom u changelog
Ušteda vremena: Fokusirali ste se na analizu uticaja i uvođenje, dok je OpenHands obradio skelu.
Integracije koje super napajaju OpenHands
- Test runneri: pytest, Jest, Vitest, JUnit
- Alati za izgradnju: Vite, Webpack, Rollup, Babel
- Upravljači paketima: npm, pnpm, yarn, pip/poetry
- Linteri/formateri: ESLint, Prettier, black, ruff
- Kontejneri: Docker Compose za lokalni paritet sa CI
Standardizacijom ovih alata, OpenHands može pouzdanije da razmišlja o vašem steku i automatizuje više razvojne petlje.
Usput: Korišćenje Sider.AI pored OpenHands
Ocena relevantnosti: 8/10. Ako koristite OpenHands kao svog AI inženjera, vredi ga upariti sa istraživačkim i nacrtnim kopilotom za specifikacije, PR opise i dokumentaciju. Uzgred, Sider.AI vam može pomoći da brzo nacrtate tehničke specifikacije, rezimirate RFC-ove ili transformišete OpenHands run logove u čiste changelogove i release notes. Kombinacija smanjuje prebacivanje konteksta: OpenHands upravlja radnjama koda, dok Sider.AI pretvara ishode u čiste dokumente okrenute korisniku.
Lista za proveru bezbednosti, privatnosti i usklađenosti
- Čuvajte tajne u env vars; nikada ne ugrađujte ključeve u promptove
- Pregledajte svaku promenu generisanu veštačkom inteligencijom kao što biste to uradili sa PR-om mlađeg programera
- Evidentirajte komande i radnje radi revizije
- Pričvrstite verzije alata; izbegavajte slučajne nadogradnje u lock datotekama
- Ako koristite cloud LLM-ove, uskladite se sa svojim politikama zadržavanja podataka
Kada ne koristiti OpenHands
- Novi dizajn algoritama bez jake skele za testiranje ili specifikacije
- Visoko regulisane baze koda bez robusnog procesa pregleda
- Jednokratne skripte za bacanje gde je ručno kodiranje brže
Vaših prvih 60 minuta sa OpenHands: Mini Playbook
- Minut 0–10: Instalirajte i pokrenite pomoću zvaničnog Quickstarta
- Minut 10–20: Povežite svoj repo; zatražite od njega da mapira strukturu projekta
- Minut 20–35: Definišite mali cilj koji se može testirati; odobrite njegov plan
- Minut 35–50: Neka implementira i pokreće testove; gurkajte po potrebi
- Minut 50–60: Pregledajte diffove, poboljšajte i spojite u granu funkcije
Ključni linkovi i sledeći koraci
- Zvanična dokumentacija "Start Building" i dokumentacija o korišćenju za OpenHands: saveti, brzi početak i najbolje prakse.
- Vodič za podešavanje lokalnog LLM: konfigurišite i pokrenite OpenHands u potpunosti na svom računaru.
- Instalacioni vodič zasnovan na zajednici na VM-u: koraci instalacije u stvarnom svetu i brzi demo projekat.
Ključne tačke
- Uokvirite zadatke kao tikete sa jasnim kriterijumima prihvatanja.
- Održavajte male iteracije; testirajte rano i često.
- Koristite zaštitne mere i pregledajte promene—tretirajte ga kao mlađeg saigrača.
- Izaberite cloud radi pogodnosti, lokalne modele radi privatnosti.
- Uparite sa alatima za dokumentaciju (npr. Sider.AI) da biste ubrzali specifikacije i release notes.
FAQ
P1:Kako da brzo instaliram i počnem da koristim AI OpenHands?
Koristite zvanični quickstart da biste instalirali preduslove, priključili podržani LLM (cloud ili lokalni) i pokrenuli UI da biste povezali svoj repozitorijum. Dokumenti "Start Building" pružaju uputstva korak po korak sa savetima za podešavanje.
P2:Mogu li da pokrenem OpenHands sa lokalnim LLM umesto cloud modela?
Da. Pratite vodič za lokalne LLM-ove da biste konfigurisali pozadinu lokalnog modela i prilagodili postavke konteksta. Ovo je idealno za projekte osetljive na privatnost ili izbegavanje troškova API-ja.
P3:Koji je najbolji način da se OpenHands podstakne za zadatke kodiranja?
Pišite promptove kao koncizne tikete: definišite cilj, referencirajte određene datoteke, postavite granice i uključite kriterijume prihvatanja. Zatražite od njega da kreira ili pokrene testove da bi potvrdio napredak.
P4:Da li je AI OpenHands bezbedan za korišćenje na produkcionom kodu?
Tretirajte ga kao mlađeg programera: koristite zaštitu grana, pregled koda i CI da biste potvrdili promene. Dodajte zaštitne mere za komande i držite tajne van promptova.
P5:Kako se OpenHands poredi sa tradicionalnim asistentom za kod?
Za razliku od alata samo za ćaskanje, OpenHands može da pokreće komande, uređuje datoteke i ponavlja autonomno unutar vašeg repoa. Izgrađen je za end-to-end zadatke kao što su funkcije, otklanjanje grešaka i testovi.
