Az AI OpenHands használata: Gyakorlati útmutató a beállításhoz, promptokhoz és valós munkafolyamatokhoz
Ha valaha is kívántad, hogy egy hozzáértő fejlesztő 24/7-ben páros programozást végezhessen veled, az AI OpenHands ehhez meglepően közel áll. Ez egy nyílt forráskódú "AI mérnök", amely képes olvasni a repódat, kódot írni, terminálokat futtatni, dokumentumokat böngészni és iterálni – hasonlóan egy junior fejlesztőhöz, aki gyorsan tanul és fáradhatatlanul dolgozik. De ez az erő csak akkor érvényesül, ha helyesen állítod be és megtanulod irányítani.
Ez az útmutató lépésről lépésre végigvezet az AI OpenHands használatán – a telepítéstől a haladó munkafolyamatokig –, így magabiztosabban és gyorsabban szállíthatsz.
- Telepítési lehetőségek és gyorsindítás
- Az OpenHands futtatása helyben vagy felhőmodellekkel
- Bevált gyakorlatok a promptokhoz, repókhoz és feladatokhoz
- Bizonyított munkafolyamatok funkciókhoz, hibakereséshez, tesztekhez és dokumentációhoz
- Korlátok, adatvédelem és együttműködés
Érdemes megjegyezni: Az OpenHands-et aktívan fejleszti az All Hands csapat és a közösség. A hivatalos dokumentáció a te iránytűd a jelenlegi utasításokhoz és tippekhez. Követheted a gyakorlati telepítési útmutatókat is olyan szakemberektől, akik dokumentálták a helyi és virtuálisgép-beállításokat. A helyi modellekkel való futtatáshoz a dokumentáció konkrét útmutatást is tartalmaz.
Mi az AI OpenHands – és miért érdemes használni?
Tekints az AI OpenHands-re úgy, mint egy AI csapattársra billentyűzettel. A csak csevegőasszisztensekkel ellentétben az OpenHands képes:
- Projektfájlok megnyitására és olvasására
- Terminál használatára parancsok, tesztek és linterek futtatásához
- Kód szerkesztésére fájlokban és könyvtárakban
- Webböngészésre (konfigurációtól függően)
- Lépésről lépésre tervek javasolására és alkalmazására
Ez ideálissá teszi olyan feladatokhoz, mint a funkciók megvalósítása, hibák javítása, tesztek írása, dokumentáció készítése, refaktorálás és a kódbázisok modernizálása. Ahelyett, hogy promptokkal zsonglőrködnél és másolnál/beillesztenél, megadsz az OpenHands-nek egy célt, és hagyod, hogy iteráljon, miközben felügyeled a lépéseit.
Gyorsindítás: A leggyorsabb módja az OpenHands használatának
Számos módja van az indulásnak. A választás attól függ, hogy felhőalapú LLM-et szeretnél használni, vagy mindent helyben futtatni.
A lehetőség: Felhőalapú LLM használata (legegyszerűbb)
- Kövesd a hivatalos "Start Building" és "Getting Started" dokumentációt az alkalmazás telepítéséhez és futtatásához. Általában:
- Telepíted az előfeltételeket (Dockert, Node-ot, Pythont, Git-et az útvonaltól függően)
- Megadsz egy API-kulcsot egy támogatott felhőmodellhez (pl. OpenAI, Anthropic vagy más, a projekt által az adott időpontban támogatott modellhez)
- Elindítod az OpenHands felületet és csatlakoztatod a tárolódat
Ez az út minimális számítási ráfordítással gyorsan termelékennyé tesz.
B lehetőség: OpenHands futtatása helyi LLM-mel
- Ha jobban szereted a kódot és a promptokat a felhőn kívül tartani, vagy elkerülni az API-költségeket, használd a helyi LLM-ek útmutatóját a hivatalos dokumentációban.
- Beállítasz egy kompatibilis helyi modellt (Ollama-n vagy más, az adott időpontban támogatott háttérrendszeren keresztül)
- Konfigurálod a modell végpontjait és a kontextuskorlátokat
- Biztosítod, hogy a géped rendelkezzen megfelelő VRAM-mal/CPU-val és lemezterülettel
C lehetőség: Telepítés virtuális gépre
- Ha dedikált környezetre van szükséged, a szakemberek dokumentálták, hogyan lehet az OpenHands-et percek alatt virtuális gépen elindítani és alkalmazást építeni. Ez hasznos azoknak a csapatoknak, akik egy stabil, megosztott AI mérnök példányt szeretnének.
Első futtatás: Projektbeállítás és feladatkeretezés
Az OpenHands akkor ragyog, ha látja a kódodat. Kezdd azzal, hogy:
- Megnyitod azt a tárolót, amelyen dolgozni szeretnél.
- Futtatod vagy indexeled a projektet, hogy az OpenHands feltérképezhesse a struktúrát.
- Egyértelmű célt adsz meg neki korlátokkal.
Jó feladatkeretezési példa:
- "Adj hozzá felhasználói jelszó-visszaállítást az
auth szolgáltatáshoz token-alapú e-mail linkek használatával. Használd a meglévő mailer modult. Adj hozzá egységteszteket a token generálásához és lejáratához. Ne változtasd meg a felhasználói adatok sémáját."
Miért működik ez:
- Megnevezi az összetevőt, a hatókört, a függőségeket és a határokat. Minél egyértelműbb vagy, annál jobban tervez és hajt végre az OpenHands.
Hogyan írjunk hatékony promptokat az OpenHands-hez
Gondolj a promptokra úgy, mint tömör jegyekre. A legjobbak:
- Meghatározzák az eredményt: "Valósítsd meg X-et Y korlátokkal"
- Hivatkoznak fájlokra, modulokra vagy tesztekre: "Lásd:
auth/routes.py és tests/test_auth.py"
- Megadják a korlátokat: "Nincs DB séma változás; tartsd meg a meglévő felületeket"
- Tartalmaznak elfogadási kritériumokat: "A teszteknek át kell menniük:
pytest -k password_reset"
Újrafelhasználható sablon:
Cél: <Amit meg szeretnél építeni vagy javítani>
Kontextus: <Releváns fájlok, ismert korlátok, külső szolgáltatások>
Elfogadás: <Hogyan néz ki az átmenés: tesztek, végpontok, mérőszámok>
Határok: <Mit ne változtass meg vagy milyen megközelítéseket kerülj el>
Eszközök: <Futtatható parancsok, szkriptek vagy adatforrások>
Alapvető munkafolyamat: Tervezés → Végrehajtás → Ellenőrzés → Finomítás
Az OpenHands általában egy többlépcsős tervet javasol. Íme, hogyan irányítsd:
- Hagyd jóvá vagy igazítsd ki a tervét korán. Kényszerítsd, hogy először futtasson teszteket az alaphibákhoz.
- Kérd meg, hogy hozzon létre vagy frissítsen egy tesztet a siker meghatározásához, majd valósítsa meg a kódot.
- Futtassa gyakran a tesztcsomagot és a lintereket.
- Ha leáll, adj hozzá több kontextust: fájlneveket, stack trace-eket vagy naplókat.
Pro tipp: Ösztönözd a kis PR-méretű változtatásokat a monolitikus szerkesztések helyett. Ez segíti a felülvizsgálhatóságot és a visszaállítást.
Példa munkafolyamatok, amelyeket lemásolhatsz
1) Funkció megvalósítása
- Prompt: "Adj hozzá CSV exportot a
orders oldalhoz. Használj szerveroldali lapozást, streameld az eredményeket text/csv formátumban. Adj hozzá Export gombot az OrdersTable.jsx-ben és végpontot a routes/orders.ts-ben. Tartalmazz teszteket a lapozáshoz és a fejlécekhez."
- Beolvassa a repót; tervet vázol fel
- Hozzáad végpontot és kliensgombot
- Tesztet ír és futtatja azokat
- Te felügyeled, jóváhagyod a változtatásokat, és egyesíted, ha minden rendben van.
2) Sikertelen build hibakeresése
- Prompt: "A CI sikertelen a Node 20-on. Javítsd ki az ESM/CJS importálási hibákat a
build.mjs-ben. Tartsd meg a meglévő rollup plugineket; frissítsd a konfigurációt és a kódot a CI átadásához."
- Adj meg naplókat vagy linket a CI artefaktumokhoz.
- Kérd meg az OpenHands-et, hogy helyben replikálja (
npm run build) és javasoljon minimális eltéréseket.
3) Tesztlefedettség és megerősítés
- Prompt: "Növeld a
payments/service.py lefedettségét 62%-ról 85% fölé. Adj hozzá egységteszteket a retry_charge, refund, webhook_signature függvényekhez. Ne módosítsd az üzleti logikát, hacsak a teszt nem tár fel egy hibát."
- Hagyd, hogy az OpenHands teszteket generáljon, futtassa azokat és finomítsa.
4) Dokumentáció és fejlesztői élmény
- Prompt: "Hozzon létre egy
CONTRIBUTING.md és egy DEVELOPMENT.md fájlt ehhez a repóhoz. Tartalmazd a környezet beállítását, a szkripteket, a tesztparancsokat és a PR irányelveket."
- Ellenőriztesd vele a parancsokat azok tényleges futtatásával.
Korlátok: Tartsd az OpenHands-et segítőkészen és biztonságosan
- Könyvtár hatóköre: Irányítsd egy adott repóra vagy könyvtárra, hogy elkerüld a véletlen szerkesztéseket máshol.
- Fájlvédelem: Jelöld meg a konfigurációs fájlokat vagy a kritikus infrastruktúrát csak olvashatóként, ahol lehetséges.
- Parancs auditálás: Követelj meg jóváhagyást a destruktív parancsokhoz (pl.
rm -rf, adatbázis visszaállítások).
- Titkok higiéniája: Soha ne illessz API kulcsokat a promptokba. Használj környezeti változókat és maszkolt naplókat.
- Hálózati hozzáférés: Ha a böngészés engedélyezve van, helyezd azt homokozóba és naplózd a kimenő hívásokat.
Helyi vs Felhőmodellek: A számodra megfelelő választása
- Előnyök: Erős érvelés/kódolás, minimális beállítás, gyors iteráció
- Hátrányok: Folyamatos költség, adatkezelési szempontok
- Előnyök: Adatvédelem, irányítás, költség előre jelezhetősége
- Hátrányok: Hardverigények, a modell minősége változó, több hangolásra van szükség
A modell háttérrendszereinek és memóriakorlátainak konfigurálásához lásd a hivatalos helyi LLM-ek utasításait.
Csapatmunka: Az OpenHands használata együttműködési folyamatban
- Ág-első munkafolyamat: Kérd meg az OpenHands-et, hogy hozzon létre egy funkcióágat, és küldje el a változtatásokat PR felülvizsgálatra.
- Commit higiénia: Kérd meg, hogy hozzon létre atomi commitokat egyértelmű üzenetekkel és hivatkozási számokkal.
- PR sablonok: Generálj és érvényesíts PR sablonokat, hogy a felülvizsgálók tudják, mi változott és miért.
- Kódtulajdonosok: Kombináld a CODEOWNERS-szel, hogy az AI által generált PR-eket a megfelelő felülvizsgálókhoz irányítsd.
Gyakori problémák hibaelhárítása
- Elakad vagy hurkokba kerül: Szűkítsd a hatókört. Kérd meg, hogy magyarázza el a következő lépését. Adj meg egy sikertelen tesztet.
- Rendetlen eltérések: Kérj kisebb, szakaszos tervet – először teszteket, majd minimális kódváltoztatásokat.
- Rossz fájlszerkesztések: Add meg a pontos útvonalakat, és emlékeztesd a határokra.
- Helyben átmegy, de a CI-ben sikertelen: Oszd meg a CI környezeti részleteit és naplóit; futtasd a replikálást egy konténerrel.
Teljesítménytippek és erőteljes lépések
- Bemelegítő kontextus: Kérd meg, hogy először olvassa el a kulcsfájlokat (
README, package.json, fő szolgáltatásfájlok).
- Adj neki szkripteket: Adj meg egy
make test vagy npm run verify parancsot, hogy gyorsan ellenőrizni tudja.
- Tanítsd meg a domaint: Kínálj egy rövid építészeti áttekintést; kevesebb logikai hibával térül meg.
- Érvényesítsd a stílust: Mutass rá a
.eslintrc, .prettierrc, black/ruff konfigurációkra, hogy helyesen formázza.
- Használj ellenőrzőpontokat: Minden mérföldkő után kérj egy összefoglalót és a következő lépéseket, hogy nyomon követhesd.
Valós helyzet: Hibajelentéstől a javításig egy óra alatt
- Helyzet: Egy éles hiba kezeletlen 500-as hibákat dob a rosszul formázott JSON payloadokra a
orders API-ban.
- A te promptod: "Reprodukáld az 500-as hibát a rosszul formázott JSON-on a
orders POST-ban. Adj hozzá sémaérvényesítést és adj vissza 400-as hibát a hiba részleteivel. Frissítsd a teszteket a rosszul formázott payloadok lefedésére."
- Helyben futtatja az API-t, reprodukálja a hibát
- Hozzáad egy érvényesítési réteget és egy hibakezelőt
- Frissíti a teszteket és biztosítja a CI átmenetét
- Készít egy kompakt PR-t egy változásnapló bejegyzéssel
Megtakarított idő: Az impakt elemzésre és a bevezetésre összpontosítottál, miközben az OpenHands kezelte az állványzatot.
Integrációk, amelyek felturbózzák az OpenHands-et
- Tesztfuttatók: pytest, Jest, Vitest, JUnit
- Építőeszközök: Vite, Webpack, Rollup, Babel
- Csomagkezelők: npm, pnpm, yarn, pip/poetry
- Linterek/formázók: ESLint, Prettier, black, ruff
- Konténerek: Docker Compose a helyi paritáshoz a CI-vel
Ezeknek az eszközöknek a szabványosításával az OpenHands megbízhatóbban tud következtetni a stack-edről és automatizálni a fejlesztési ciklus több részét.
Egyébként: A Sider.AI használata az OpenHands mellett
Relevancia pontszám: 8/10. Ha az OpenHands-et használod AI mérnökként, érdemes párosítani egy kutatási és tervezési másodpilótával a specifikációkhoz, PR leírásokhoz és dokumentációhoz. Egyébként a Sider.AI segíthet gyorsan technikai specifikációkat tervezni, RFC-ket összefoglalni vagy az OpenHands futtatási naplóit tiszta változásnaplókká és kiadási megjegyzésekké alakítani. A kombináció csökkenti a kontextusváltást: az OpenHands kezeli a kódműveleteket, míg a Sider.AI a kimeneteket tiszta, felhasználóbarát dokumentumokká alakítja.
Biztonsági, adatvédelmi és megfelelőségi ellenőrzőlista
- Tartsd a titkokat a környezeti változókban; soha ne ágyazz kulcsokat a promptokba
- Vizsgálj felül minden AI által generált változtatást, mint egy junior fejlesztő PR-jét
- Naplózd a parancsokat és műveleteket az auditálhatóság érdekében
- Rögzítsd az eszközkészlet verzióit; kerüld el a véletlen frissítéseket a lockfile-okban
- Ha felhőalapú LLM-eket használsz, igazodj az adatok megőrzési szabályzataihoz
Mikor ne használd az OpenHands-et
- Új algoritmus tervezés erős teszt vagy specifikációs állványzat nélkül
- Szigorúan szabályozott kódbázisok robusztus felülvizsgálati folyamat nélkül
- Egyszeri eldobható szkriptek, ahol a kézi kódolás gyorsabb
Az első 60 perced az OpenHands-szel: Egy mini játszótér
- 0–10. perc: Telepítsd és indítsd el a hivatalos Gyorsindítóval
- 10–20. perc: Csatlakoztasd a repódat; kérd meg, hogy térképezze fel a projekt struktúráját
- 20–35. perc: Határozz meg egy kis, tesztelhető célt; hagyd jóvá a tervét
- 35–50. perc: Hagyd, hogy megvalósítsa és futtassa a teszteket; lökd meg, ha szükséges
- 50–60. perc: Vizsgáld felül az eltéréseket, finomítsd és egyesítsd egy funkcióágba
Kulcsfontosságú linkek és következő lépések
- Hivatalos "Start Building" és használati dokumentáció az OpenHands-hez: tippek, gyorsindító és bevált gyakorlatok.
- Helyi LLM beállítási útmutató: konfiguráld és futtasd az OpenHands-et teljes egészében a gépeden.
- Közösség által vezérelt telepítési útmutató egy virtuális gépen: valós telepítési lépések és egy gyors demóprojekt.
Tanulságok
- Keretezd a feladatokat jegyekként egyértelmű elfogadási kritériumokkal.
- Tartsd kicsinek az iterációkat; tesztelj korán és gyakran.
- Használj korlátokat és vizsgáld felül a változtatásokat – kezeld úgy, mint egy junior csapattársat.
- Válaszd a felhőt a kényelemért, a helyi modelleket az adatvédelemért.
- Párosítsd dokumentációs eszközökkel (pl. Sider.AI) a specifikációk és a kiadási megjegyzések felgyorsításához.
GYIK
Q1:Hogyan telepíthetem és kezdhetem el gyorsan az AI OpenHands használatát?
Használd a hivatalos gyorsindítót az előfeltételek telepítéséhez, csatlakoztass egy támogatott LLM-et (felhőalapú vagy helyi), és indítsd el a felhasználói felületet a tárolód csatlakoztatásához. A "Start Building" dokumentáció lépésről lépésre tartalmazza a beállítási tippeket.
Q2:Futtathatom az OpenHands-et helyi LLM-mel a felhőmodell helyett?
Igen. Kövesd a helyi LLM-ek útmutatóját a helyi modell háttérrendszerének konfigurálásához és a kontextus beállításainak módosításához. Ez ideális az adatvédelem szempontjából érzékeny projektekhez vagy az API költségek elkerüléséhez.
Q3:Mi a legjobb módja az OpenHands kódolási feladatokra való ösztönzésének?
Írj promptokat tömör jegyekként: határozd meg a célt, hivatkozz konkrét fájlokra, állíts be határokat, és adj meg elfogadási kritériumokat. Kérd meg, hogy hozzon létre vagy futtasson teszteket a fejlődés ellenőrzéséhez.
Q4:Biztonságos az AI OpenHands használata éles kódon?
Kezeld úgy, mint egy junior fejlesztőt: használj ágvédelmet, kódellenőrzést és CI-t a változtatások ellenőrzéséhez. Adj hozzá korlátokat a parancsokhoz, és tartsd távol a titkokat a promptoktól.
Q5:Hogyan viszonyul az OpenHands egy hagyományos kódasszisztenshez?
A csak csevegőeszközökkel ellentétben az OpenHands parancsokat futtathat, fájlokat szerkeszthet és autonóm módon iterálhat a tárolódon belül. Olyan végponttól végpontig tartó feladatokra készült, mint a funkciók, a hibakeresés és a tesztek.
