Kaip naudoti AI OpenHands: praktinis sąrankos, raginimų ir realaus pasaulio darbo eigos vadovas
Jei kada nors norėjote, kad gabus kūrėjas galėtų programuoti kartu su jumis visą parą, AI OpenHands yra stebėtinai arti to. Tai atvirojo kodo "AI inžinierius", kuris gali skaityti jūsų repo, rašyti kodą, paleisti terminalus, naršyti dokumentus ir kartoti – panašiai kaip jaunesnysis kūrėjas, kuris greitai mokosi ir nenuilstamai dirba. Tačiau galia atsiskleidžia tik tinkamai jį nustatę ir išmokę valdyti.
Šis vadovas žingsnis po žingsnio paaiškina, kaip naudoti AI OpenHands – nuo įdiegimo iki pažangių darbo eigų – kad galėtumėte greičiau ir užtikrinčiau pristatyti produktą.
- Diegimo parinktys ir greita pradžia
- OpenHands paleidimas lokaliai arba su debesų modeliais
- Geriausios raginimų, repo ir užduočių praktikos
- Patikrintos darbo eigos funkcijų kūrimui, klaidų taisymui, testams ir dokumentams
- Apsaugos priemonės, privatumas ir bendradarbiavimas
Verta paminėti: OpenHands aktyviai kuria All Hands komanda ir bendruomenė. Oficialūs dokumentai yra jūsų šiaurės žvaigždė, kurioje rasite naujausių instrukcijų ir patarimų. Taip pat galite sekti praktinius diegimo vadovus iš praktikų, kurie dokumentavo vietines ir VM sąrankas. Vykdant su vietiniais modeliais, dokumentuose taip pat pateikiamos konkrečios rekomendacijos.
Kas yra AI OpenHands ir kodėl jį naudoti?
Įsivaizduokite AI OpenHands kaip AI komandos narį su klaviatūra. Skirtingai nuo tik pokalbių asistentų, OpenHands gali:
- Atidaryti ir skaityti projekto failus
- Naudoti terminalą komandoms, testams ir linteriams paleisti
- Redaguoti kodą failuose ir kataloguose
- Naršyti internete (priklausomai nuo konfigūracijos)
- Siūlyti ir taikyti žingsnis po žingsnio planus
Dėl to jis idealiai tinka tokioms užduotims kaip funkcijų įgyvendinimas, klaidų taisymas, testų rašymas, dokumentų kūrimas, refaktorizavimas ir kodo bazių modernizavimas. Užuot žongliravus raginimais ir kopijavus/įklijavus, jūs duodate OpenHands tikslą ir leidžiate jam kartoti, o jūs prižiūrite jo veiksmus.
Greita pradžia: greičiausias būdas naudoti OpenHands
Yra keletas būdų, kaip pradėti. Jūsų pasirinkimas priklauso nuo to, ar norite naudoti debesies LLM, ar viską paleisti lokaliai.
A variantas: naudokite debesies LLM (lengviausia)
- Vykdykite oficialius „Pradėti kurti“ ir „Darbo pradžia“ dokumentus, kad įdiegtumėte ir paleistumėte programą. Paprastai:
- Įdiekite būtinas sąlygas (Docker, Node, Python, Git, priklausomai nuo kelio)
- Pateikite palaikomo debesies modelio API raktą (pvz., OpenAI, Anthropic arba kiti projekto palaikomi raktai tuo metu)
- Paleiskite OpenHands sąsają ir prijunkite savo saugyklą
Šis kelias leidžia greitai pasiekti produktyvumą su minimaliomis skaičiavimo sąnaudomis.
B variantas: paleiskite OpenHands su vietiniu LLM
- Jei norite, kad kodas ir raginimai nebūtų debesyje arba norite išvengti API išlaidų, naudokite vietinių LLM vadovą oficialiuose dokumentuose.
- Nustatykite suderinamą vietinį modelį (per Ollama ar kitas tuo metu palaikomas sistemas)
- Konfigūruokite modelio galinius taškus ir konteksto apribojimus
- Įsitikinkite, kad jūsų mašina turi pakankamai VRAM/CPU ir vietos diske
C variantas: įdiekite į VM
- Jei jums reikia specialios aplinkos, praktikai dokumentavo, kaip per kelias minutes paleisti OpenHands virtualioje mašinoje ir sukurti programą. Tai naudinga komandoms, kurios nori stabilios, bendrinamos AI inžinieriaus instancijos.
Pirmasis paleidimas: projekto sąranka ir užduoties įrėminimas
OpenHands suspindi, kai mato jūsų kodą. Pradėkite nuo:
- Atidarykite saugyklą, su kuria norite dirbti.
- Paleiskite arba indeksuokite projektą, kad OpenHands galėtų susieti struktūrą.
- Pateikite aiškų tikslą su apribojimais.
Geras užduoties įrėminimo pavyzdys:
- "Pridėkite vartotojo slaptažodžio atstatymą į
auth paslaugą naudodami žetonų pagrindu sukurtas el. pašto nuorodas. Naudokite esamą mailer modulį. Pridėkite vienetinius testus žetonų generavimui ir galiojimo pabaigai. Nekeiskite vartotojo duomenų schemos."
Kodėl tai veikia:
- Jame įvardijamas komponentas, apimtis, priklausomybės ir ribos. Kuo aiškesnis esate, tuo geriau OpenHands planuoja ir vykdo.
Kaip rašyti veiksmingus raginimus OpenHands
Pagalvokite apie raginimus kaip glaustus bilietus. Geriausi:
- Apibrėžkite rezultatą: "Įgyvendinkite X su Y apribojimais"
- Nurodykite failus, modulius arba testus: "Žr.
auth/routes.py ir tests/test_auth.py"
- Nurodykite apribojimus: "Jokių DB schemos pakeitimų; palikite esamas sąsajas"
- Įtraukite priėmimo kriterijus: "Testai turi būti sėkmingi:
pytest -k password_reset"
Šablonas, kurį galite naudoti pakartotinai:
Tikslas: <Ką norite sukurti ar pataisyti>
Kontekstas: <Susiję failai, žinomi apribojimai, išorinės paslaugos>
Priėmimas: <Kaip atrodo sėkmė: testai, galiniai taškai, metrika>
Ribos: <Ko nekeisti ar kokių metodų vengti>
Įrankiai: <Komandos, kurias jis gali paleisti, scenarijai arba duomenų šaltiniai>
Pagrindinė darbo eiga: planas → vykdymas → patvirtinimas → tobulinimas
OpenHands paprastai siūlo daugiapakopį planą. Štai kaip jį valdyti:
- Patvirtinkite arba pakoreguokite jo planą anksti. Paskatinkite jį pirmiausia paleisti testus, kad nustatytumėte nesėkmes.
- Paprašykite jo sukurti arba atnaujinti testą, kad apibrėžtumėte sėkmę, tada įgyvendinkite kodą.
- Leiskite jam dažnai paleisti testų rinkinį ir linterius.
- Jei jis užstringa, pridėkite daugiau konteksto: failų pavadinimus, stekų sekimus arba žurnalus.
Profesionalo patarimas: skatinkite mažus PR dydžio pakeitimus, o ne monolitinius redagavimus. Tai padeda peržiūrėti ir atšaukti.
Darbo eigos pavyzdžiai, kuriuos galite kopijuoti
1) Funkcijos įgyvendinimas
- Raginimas: "Pridėkite CSV eksportą į
orders puslapį. Naudokite serverio pusės puslapiavimą, transliuokite rezultatus per text/csv. Pridėkite Export mygtuką OrdersTable.jsx ir galinį tašką routes/orders.ts. Įtraukite puslapiavimo ir antraščių testus."
- Nuskaito repo; rengia planą
- Prideda galinį tašką ir kliento mygtuką
- Rašo testus ir juos paleidžia
- Kartojasi esant nesėkmėms
- Jūs prižiūrite, patvirtinate pakeitimus ir sujungiate, kai viskas gerai.
2) Nepavykusio kompiliavimo derinimas
- Raginimas: "CI nepavyksta naudojant Node 20. Pataisykite ESM/CJS importo klaidas
build.mjs. Palikite esamus rollup priedus; atnaujinkite konfigūraciją ir kodą, kad CI būtų sėkmingas."
- Pateikite žurnalus arba nuorodą į CI artefaktus.
- Paprašykite OpenHands pakartoti lokaliai (
npm run build) ir pasiūlykite minimalius skirtumus.
3) Testų aprėptis ir stiprinimas
- Raginimas: "Padidinkite
payments/service.py aprėptį nuo 62% iki 85%+. Pridėkite vienetinius testus retry_charge, refund, webhook_signature. Nekeiskite verslo logikos, nebent testas atskleidžia klaidą."
- Leiskite OpenHands generuoti testus, juos paleisti ir patobulinti.
4) Dokumentai ir kūrėjo patirtis
- Raginimas: "Sukurkite
CONTRIBUTING.md ir DEVELOPMENT.md šiai repo. Įtraukite aplinkos sąranką, scenarijus, testų komandas ir PR gaires."
- Leiskite jam patikrinti komandas jas paleidžiant.
Apsaugos priemonės: užtikrinkite, kad OpenHands būtų naudingas ir saugus
- Katalogo apimtis: nukreipkite jį į konkrečią repo arba katalogą, kad išvengtumėte atsitiktinių redagavimų kitur.
- Failų apsauga: pažymėkite konfigūracijos failus arba kritinę infrastruktūrą kaip tik skaitomus, kur įmanoma.
- Komandų auditas: reikalaukite patvirtinimo naikinančioms komandoms (pvz.,
rm -rf, duomenų bazės atstatymams).
- Paslapčių higiena: niekada neįklijuokite API raktų į raginimus. Naudokite aplinkos kintamuosius ir užmaskuotus žurnalus.
- Tinklo prieiga: jei naršymas įgalintas, smėlio dėžėkite jį ir registruokite išeinančius skambučius.
Vietiniai ir debesų modeliai: pasirinkite tai, kas jums tinka
- Argumentai "už": stiprus argumentavimas/kodavimas, minimali sąranka, greita iteracija
- Argumentai "prieš": nuolatinės išlaidos, duomenų valdymo svarstymai
- Argumentai "už": privatumas, valdymas, išlaidų nuspėjamumas
- Argumentai "prieš": reikalavimai aparatinei įrangai, modelio kokybė skiriasi, reikia daugiau derinimo
Žr. oficialias vietinių LLM instrukcijas, kad sukonfigūruotumėte modelio sistemas ir atminties apribojimus.
Komandinis žaidimas: OpenHands naudojimas bendradarbiavimo sraute
- Šakos pirmenybės darbo eiga: leiskite OpenHands sukurti funkcijos šaką ir įkelti pakeitimus PR peržiūrai.
- Įsipareigojimų higiena: paprašykite jo sukurti atominius įsipareigojimus su aiškiais pranešimais ir nurodyti problemų numerius.
- PR šablonai: generuokite ir įgyvendinkite PR šablonus, kad peržiūrėtojai žinotų, kas pasikeitė ir kodėl.
- Kodo savininkai: derinkite su CODEOWNERS, kad AI sukurtus PR nukreiptumėte tinkamiems peržiūrėtojams.
Dažniausiai pasitaikančių problemų trikčių šalinimas
- Jis užstringa arba sukasi ratu: susiaurinkite apimtį. Paprašykite jo paaiškinti kitą žingsnį. Pateikite nepavykusį testą.
- Netvarkingi skirtumai: paprašykite mažesnio, etapinio plano – pirmiausia testai, tada minimalūs kodo pakeitimai.
- Neteisingi failų redagavimai: nurodykite tikslius kelius ir priminkite jam apie ribas.
- Vietoje pavyksta, bet CI nepavyksta: pasidalykite CI aplinkos detalėmis ir žurnalais; leiskite jam pakartoti naudojant konteinerį.
Veiklos patarimai ir galingi veiksmai
- Apšilimo kontekstas: paprašykite jo pirmiausia perskaityti pagrindinius failus (
README, package.json, pagrindinius paslaugų failus).
- Pateikite jam scenarijus: pateikite
make test arba npm run verify, kad jis galėtų greitai patvirtinti.
- Išmokykite domeną: pateikite trumpą architektūrinę apžvalgą; tai atsipirks mažiau logikos klaidų.
- Įgyvendinkite stilių: nurodykite
.eslintrc, .prettierrc, black/ruff konfigūracijas, kad jis teisingai formatuotų.
- Naudokite kontrolinius taškus: po kiekvieno etapo paprašykite santraukos ir kitų veiksmų, kad jis nepasiklystų.
Realaus pasaulio scenarijus: nuo klaidos pranešimo iki pataisos per valandą
- Situacija: gamybos klaida numeta neapdorotus 500-us su netinkamais JSON duomenų paketais
orders API.
- Jūsų raginimas: "Atkurkite 500 su netinkamu JSON
orders POST. Pridėkite schemos patvirtinimą ir grąžinkite 400 su išsamia klaida. Atnaujinkite testus, kad apimtų netinkamus duomenų paketus."
- Paleidžia API lokaliai, atkuria klaidą
- Prideda patvirtinimo sluoksnį ir klaidų tvarkyklę
- Atnaujina testus ir užtikrina, kad CI pavyks
- Sukuria kompaktišką PR su pakeitimų žurnalo įrašu
Sutaupytas laikas: jūs sutelkėte dėmesį į poveikio analizę ir diegimą, o OpenHands pasirūpino pastoliais.
Integracijos, kurios pagerina OpenHands
- Testų paleidikliai: pytest, Jest, Vitest, JUnit
- Kompiliavimo įrankiai: Vite, Webpack, Rollup, Babel
- Paketų tvarkyklės: npm, pnpm, yarn, pip/poetry
- Linteriai/formuotojai: ESLint, Prettier, black, ruff
- Konteineriai: Docker Compose, skirtas vietiniam paritetui su CI
Standartizuodamas šiuos įrankius, OpenHands gali patikimiau samprotauti apie jūsų rinkinį ir automatizuoti daugiau kūrimo ciklo.
Beje: Sider.AI naudojimas kartu su OpenHands
Aktualumo balas: 8/10. Jei naudojate OpenHands kaip savo AI inžinierių, verta jį sujungti su tyrimų ir projektų rengimo pilotu specifikacijoms, PR aprašymams ir dokumentacijai. Beje, Sider.AI gali padėti greitai parengti technines specifikacijas, apibendrinti RFC arba paversti OpenHands vykdymo žurnalus švariais pakeitimų žurnalais ir leidimo pastabomis. Derinys sumažina perjungimą tarp kontekstų: OpenHands tvarko kodo veiksmus, o Sider.AI paverčia rezultatus švariais, į vartotoją orientuotais dokumentais.
Saugos, privatumo ir atitikties kontrolinis sąrašas
- Laikykite paslaptis env kintamuosiuose; niekada neįterpkite raktų į raginimus
- Peržiūrėkite kiekvieną AI sukurtą pakeitimą taip, kaip peržiūrėtumėte jaunesniojo kūrėjo PR
- Registruokite komandas ir veiksmus, kad būtų galima audituoti
- Prisekite įrankių grandinės versijas; venkite atsitiktinių atnaujinimų užrakto failuose
- Jei naudojate debesies LLM, suderinkite su savo duomenų saugojimo politika
Kada nenaudoti OpenHands
- Naujo algoritmo kūrimas be stipraus testo arba specifikacijų pastolių
- Griežtai reguliuojamos kodo bazės be patikimo peržiūros proceso
- Vienkartiniai išmetami scenarijai, kai rankinis kodavimas yra greitesnis
Jūsų pirmosios 60 minučių su OpenHands: mini vadovas
- 0–10 minutės: įdiekite ir paleiskite naudodami oficialų greitosios pradžios vadovą
- 10–20 minutės: prijunkite savo repo; paprašykite jo susieti projekto struktūrą
- 20–35 minutės: apibrėžkite mažą, išbandytiną tikslą; patvirtinkite jo planą
- 35–50 minutės: leiskite jam įgyvendinti ir paleisti testus; pastumkite, jei reikia
- 50–60 minutės: peržiūrėkite skirtumus, patobulinkite ir sujunkite į funkcijos šaką
Pagrindinės nuorodos ir tolesni veiksmai
- Oficialūs OpenHands „Pradėti kurti“ ir naudojimo dokumentai: patarimai, greitoji pradžia ir geriausia praktika.
- Vietinio LLM sąrankos vadovas: sukonfigūruokite ir paleiskite OpenHands tik savo kompiuteryje.
- Bendruomenės sukurtas diegimo vadovas virtualioje mašinoje: realaus pasaulio diegimo žingsniai ir greitas demonstracinis projektas.
Pagrindiniai dalykai
- Įrėminkite užduotis kaip bilietus su aiškiais priėmimo kriterijais.
- Laikykite iteracijas mažas; testuokite anksti ir dažnai.
- Naudokite apsaugos priemones ir peržiūrėkite pakeitimus – elkitės su juo kaip su jaunesniuoju komandos nariu.
- Pasirinkite debesį patogumui, vietinius modelius – privatumui.
- Susiekite su dokumentacijos įrankiais (pvz., Sider.AI), kad pagreitintumėte specifikacijas ir leidimo pastabas.
DUK
Q1: Kaip greitai įdiegti ir pradėti naudoti AI OpenHands?
Naudokite oficialų greitosios pradžios vadovą, kad įdiegtumėte būtinas sąlygas, prijunkite palaikomą LLM (debesies arba vietinį) ir paleiskite vartotojo sąsają, kad prijungtumėte savo saugyklą. „Pradėti kurti“ dokumentuose pateikiamos žingsnis po žingsnio instrukcijos su sąrankos patarimais.
Q2: Ar galiu paleisti OpenHands su vietiniu LLM vietoj debesies modelio?
Taip. Vykdykite vietinių LLM vadovą, kad sukonfigūruotumėte vietinio modelio sistemą ir pakoreguotumėte konteksto nustatymus. Tai idealiai tinka privatumui jautriems projektams arba norint išvengti API išlaidų.
Q3: Koks geriausias būdas raginti OpenHands atlikti kodavimo užduotis?
Rašykite raginimus kaip glaustus bilietus: apibrėžkite tikslą, nurodykite konkrečius failus, nustatykite ribas ir įtraukite priėmimo kriterijus. Paprašykite jo sukurti arba paleisti testus, kad patvirtintumėte pažangą.
Q4: Ar saugu naudoti AI OpenHands gamybos kode?
Elkitės su juo kaip su jaunesniuoju kūrėju: naudokite šakų apsaugas, kodo peržiūrą ir CI, kad patvirtintumėte pakeitimus. Pridėkite apsaugos priemones komandoms ir nepalikite paslapčių raginimuose.
Q5: Kaip OpenHands lyginamas su tradiciniu kodo asistentu?
Skirtingai nuo tik pokalbių įrankių, OpenHands gali paleisti komandas, redaguoti failus ir savarankiškai kartoti jūsų repo. Jis sukurtas galutinėms užduotims, tokioms kaip funkcijos, derinimas ir testai.
