Jak používat AI OpenHands: Praktický průvodce nastavením, prompty a pracovními postupy v reálném světě
Pokud jste si někdy přáli, aby s vámi schopný vývojář mohl programovat v páru 24 hodin denně, 7 dní v týdnu, AI OpenHands se tomu nápadně blíží. Je to open-source "AI inženýr", který umí číst vaše repo, psát kód, spouštět terminály, procházet dokumenty a iterovat – podobně jako junior vývojář, který se rychle učí a neúnavně pracuje. Ale tento potenciál se projeví, až když jej správně nastavíte a naučíte se ho řídit.
Tento průvodce vás krok za krokem provede používáním AI OpenHands – od instalace po pokročilé pracovní postupy – abyste mohli s jistotou dodávat rychleji.
- Možnosti instalace a rychlý start
- Spouštění OpenHands lokálně nebo s cloudovými modely
- Osvědčené postupy pro prompty, repozitáře a úkoly
- Osvědčené pracovní postupy pro práci na funkcích, ladění, testy a dokumentaci
- Ochranné mechanismy, soukromí a spolupráce
Stojí za zmínku: OpenHands je aktivně vyvíjen týmem All Hands a komunitou. Oficiální dokumentace je vaším hlavním zdrojem aktuálních instrukcí a tipů. Můžete také sledovat praktické průvodce instalací od odborníků, kteří zdokumentovali lokální nastavení a nastavení virtuálních počítačů. Pro spouštění s lokálními modely dokumentace obsahuje také specifické pokyny.
Co je AI OpenHands – a proč ji používat?
Představte si AI OpenHands jako AI spoluhráče s klávesnicí. Na rozdíl od asistentů pouze pro chat, OpenHands umí:
- Otevírat a číst soubory projektu
- Používat terminál ke spouštění příkazů, testů a linterů
- Upravovat kód napříč soubory a adresáři
- Procházet web (v závislosti na konfiguraci)
- Navrhovat a aplikovat postupné plány
Díky tomu je ideální pro úkoly, jako je implementace funkcí, oprava chyb, psaní testů, vytváření dokumentace, refaktorování a modernizace codebase. Namísto žonglování s prompty a kopírováním/vkládáním dáte OpenHands cíl a necháte ji iterovat, přičemž dohlížíte na její kroky.
Rychlý start: Nejrychlejší způsob, jak používat OpenHands
Existuje několik způsobů, jak začít. Vaše volba závisí na tom, zda chcete používat cloudový LLM nebo spouštět vše lokálně.
Možnost A: Použití cloudového LLM (nejjednodušší)
- Postupujte podle oficiální dokumentace "Start Building" a "Getting Started" pro instalaci a spuštění aplikace. Typicky budete:
- Instalovat předpoklady (Docker, Node, Python, Git v závislosti na cestě)
- Poskytovat API klíč pro podporovaný cloudový model (např. OpenAI, Anthropic nebo jiné, které projekt v danou chvíli podporuje)
- Spustit rozhraní OpenHands a připojit svůj repozitář
Tato cesta vám umožní rychle dosáhnout produktivity s minimálními výpočetními náklady.
Možnost B: Spouštění OpenHands s lokálním LLM
- Pokud dáváte přednost tomu, aby kód a prompty zůstaly mimo cloud, nebo se chcete vyhnout nákladům na API, použijte průvodce Local LLMs v oficiální dokumentaci.
- Nastavíte kompatibilní lokální model (prostřednictvím Ollama nebo jiných backendů podporovaných v danou chvíli)
- Konfigurujete koncové body modelu a limity kontextu
- Zajistíte, aby váš stroj měl dostatečnou VRAM/CPU a diskový prostor
Možnost C: Nasazení do VM
- Pokud potřebujete vyhrazené prostředí, odborníci zdokumentovali, jak spustit OpenHands na VM a vytvořit aplikaci během několika minut. To je užitečné pro týmy, které chtějí stabilní, sdílenou instanci AI inženýra.
První spuštění: Nastavení projektu a rámování úkolů
OpenHands vyniká, když vidí váš kód. Začněte tím, že:
- Otevřete repozitář, na kterém chcete pracovat.
- Spustíte nebo indexujete projekt, aby OpenHands mohl zmapovat strukturu.
- Dáte mu jasný cíl s omezeními.
Příklad dobrého rámování úkolu:
- "Přidejte reset hesla uživatele do služby
auth pomocí tokenových e-mailových odkazů. Použijte existující modul mailer. Přidejte unit testy pro generování a expiraci tokenu. Neměňte schéma dat uživatele."
Proč to funguje:
- Pojmenovává komponentu, rozsah, závislosti a hranice. Čím jasnější budete, tím lépe OpenHands plánuje a provádí.
Jak psát efektivní prompty pro OpenHands
Představte si prompty jako stručné tickety. Ty nejlepší:
- Definují výsledek: "Implementujte X s omezeními Y"
- Odkazují na soubory, moduly nebo testy: "Viz
auth/routes.py a tests/test_auth.py"
- Uvádějí omezení: "Žádné změny DB schématu; zachovejte stávající rozhraní"
- Zahrnují akceptační kritéria: "Testy by měly projít:
pytest -k password_reset"
Šablona, kterou můžete znovu použít:
Cíl: <Co chcete vytvořit nebo opravit>
Kontext: <Relevantní soubory, známá omezení, externí služby>
Akceptace: <Jak vypadá úspěch: testy, koncové body, metriky>
Hranice: <Co neměnit nebo jakým přístupům se vyhnout>
Nástroje: <Příkazy, které může spouštět, skripty nebo zdroje dat>
Základní pracovní postup: Plán → Provedení → Ověření → Vylepšení
OpenHands obvykle navrhuje více krokový plán. Zde je návod, jak ho vést:
- Schvalte nebo upravte jeho plán včas. Přimějte ho, aby nejprve spustil testy a určil základní selhání.
- Požádejte ho, aby vytvořil nebo aktualizoval test pro definování úspěchu, a poté implementoval kód.
- Nechte ho často spouštět testovací sadu a lintery.
- Pokud se zablokuje, přidejte další kontext: názvy souborů, stack trace nebo protokoly.
Profesionální tip: Podporujte malé změny velikosti PR namísto monolitických úprav. To pomáhá s kontrolovatelností a rollbackem.
Příklady pracovních postupů, které můžete kopírovat
1) Implementace funkce
- Prompt: "Přidejte export CSV na stránku
orders. Použijte stránkování na straně serveru, streamujte výsledky přes text/csv. Přidejte tlačítko Export v OrdersTable.jsx a koncový bod v routes/orders.ts. Zahrňte testy pro stránkování a hlavičky."
- Skenuje repo; navrhuje plán
- Přidá koncový bod a klientské tlačítko
- Dohlížíte, schvalujete změny a slučujete, jakmile je vše v pořádku.
2) Ladění neúspěšného buildu
- Prompt: "CI selhává na Node 20. Opravte chyby importu ESM/CJS v
build.mjs. Zachovejte existující rollup pluginy; aktualizujte konfiguraci a kód, aby CI prošel."
- Poskytněte protokoly nebo odkaz na artefakty CI.
- Požádejte OpenHands, aby replikovala lokálně (
npm run build) a navrhla minimální rozdíly.
3) Pokrytí testy a posílení
- Prompt: "Zvyšte pokrytí pro
payments/service.py ze 62 % na 85 %+. Přidejte unit testy pro retry_charge, refund, webhook_signature. Neměňte obchodní logiku, pokud test neodhalí chybu."
- Nechte OpenHands generovat testy, spouštět je a vylepšovat.
4) Dokumentace a vývojářská zkušenost
- Prompt: "Vytvořte
CONTRIBUTING.md a DEVELOPMENT.md pro toto repo. Zahrňte nastavení prostředí, skripty, testovací příkazy a pokyny pro PR."
- Nechte ji ověřit příkazy jejich skutečným spuštěním.
Ochranné mechanismy: Udržujte OpenHands užitečnou a bezpečnou
- Rozsah adresáře: Nasměrujte ji na konkrétní repo nebo adresář, abyste se vyhnuli náhodným úpravám jinde.
- Ochrana souborů: Označte konfigurační soubory nebo kritickou infrastrukturu jako jen pro čtení, kde je to možné.
- Auditování příkazů: Vyžadujte schválení pro destruktivní příkazy (např.
rm -rf, resetování databáze).
- Hygiena tajemství: Nikdy nevkládejte API klíče do promptů. Používejte proměnné prostředí a maskované protokoly.
- Přístup k síti: Pokud je povoleno procházení, použijte sandbox a protokolujte odchozí hovory.
Lokální vs Cloudové modely: Výběr toho, co je pro vás správné
- Výhody: Silné uvažování/kódování, minimální nastavení, rychlá iterace
- Nevýhody: Průběžné náklady, úvahy o správě dat
- Výhody: Soukromí, kontrola, předvídatelnost nákladů
- Nevýhody: Nároky na hardware, kvalita modelu se liší, je potřeba více ladění
Viz oficiální instrukce Local LLMs pro konfiguraci modelových backendů a limitů paměti.
Týmová hra: Používání OpenHands v prostředí pro spolupráci
- Pracovní postup založený na větvích: Nechte OpenHands vytvořit větev funkcí a odeslat změny pro kontrolu PR.
- Hygiena commitů: Požádejte ji, aby vytvářela atomické commity s jasnými zprávami a odkazovala na čísla problémů.
- Šablony PR: Generujte a vynucujte šablony PR, aby recenzenti věděli, co se změnilo a proč.
- Vlastníci kódu: Kombinujte s CODEOWNERS pro směrování PR generovaných AI správným recenzentům.
Řešení běžných problémů
- Zasekne se nebo opakuje: Zúžte rozsah. Požádejte ji, aby vysvětlila svůj další krok. Poskytněte neúspěšný test.
- Nepořádné diffy: Vyžádejte si menší, postupný plán – nejprve testy, poté minimální změny kódu.
- Špatné úpravy souborů: Zadejte přesné cesty a připomeňte jí hranice.
- Místně prochází, ale selhává v CI: Sdílejte podrobnosti o prostředí CI a protokoly; nechte ji replikovat s kontejnerem.
Tipy pro výkon a silné pohyby
- Kontext warm-start: Požádejte ji, aby si nejprve přečetla klíčové soubory (
README, package.json, hlavní servisní soubory).
- Dejte jí skripty: Poskytněte
make test nebo npm run verify, aby mohla rychle ověřit.
- Naučte doménu: Nabídněte stručný architektonický přehled; vyplatí se to v menším počtu logických chyb.
- Vynucujte styl: Odkazujte na konfigurace
.eslintrc, .prettierrc, black/ruff, aby formátovala správně.
- Používejte kontrolní body: Po každém milníku požádejte o shrnutí a další kroky, aby se udržela na správné cestě.
Scénář z reálného světa: Od hlášení chyby k opravě za hodinu
- Situace: Produkční chyba způsobuje neobsluhované 500 na nesprávně vytvořené JSON payloady v
orders API.
- Váš prompt: "Reprodukujte 500 na nesprávně vytvořené JSON v
orders POST. Přidejte validaci schématu a vraťte 400 s podrobnostmi o chybě. Aktualizujte testy, aby pokryly nesprávně vytvořené payloady."
- Spustí API lokálně, reprodukuje chybu
- Přidá vrstvu validace a obsluhu chyb
- Aktualizuje testy a zajišťuje, že CI projde
- Vytvoří kompaktní PR se záznamem protokolu změn
Ušetřený čas: Zaměřili jste se na analýzu dopadu a zavedení, zatímco OpenHands se postarala o lešení.
Integrace, které posilují OpenHands
- Test runners: pytest, Jest, Vitest, JUnit
- Build tools: Vite, Webpack, Rollup, Babel
- Package managers: npm, pnpm, yarn, pip/poetry
- Linters/formatters: ESLint, Prettier, black, ruff
- Containers: Docker Compose pro lokální paritu s CI
Standardizací těchto nástrojů může OpenHands spolehlivěji uvažovat o vašem stacku a automatizovat více vývojářské smyčky.
Mimochodem: Používání Sider.AI vedle OpenHands
Skóre relevance: 8/10. Pokud používáte OpenHands jako svého AI inženýra, stojí za to spárovat ho s kopilotem pro výzkum a návrhy pro specifikace, popisy PR a dokumentaci. Mimochodem, Sider.AI vám může pomoci rychle navrhnout technické specifikace, shrnout RFC nebo transformovat protokoly spuštění OpenHands do čistých protokolů změn a poznámek k vydání. Kombinace snižuje přepínání kontextu: OpenHands se stará o akce s kódem, zatímco Sider.AI transformuje výsledky do čisté dokumentace pro uživatele.
Kontrolní seznam zabezpečení, ochrany soukromí a dodržování předpisů
- Uchovávejte tajemství v proměnných prostředí; nikdy nevkládejte klíče do promptů
- Zkontrolujte každou změnu generovanou AI, jako byste kontrolovali PR juniorního vývojáře
- Protokolujte příkazy a akce pro auditovatelnost
- Připněte verze toolchainu; vyhněte se náhodným upgradům v lockfilech
- Pokud používáte cloudové LLM, slaďte se svými zásadami uchovávání dat
Kdy nepoužívat OpenHands
- Nový návrh algoritmu bez silného testovacího nebo specifikačního lešení
- Vysoce regulované codebase bez robustního procesu kontroly
- Jednorázové skripty, kde je ruční kódování rychlejší
Vašich prvních 60 minut s OpenHands: Mini Playbook
- Minuta 0–10: Nainstalujte a spusťte pomocí oficiálního Rychlého startu
- Minuta 10–20: Připojte své repo; požádejte ji o zmapování struktury projektu
- Minuta 20–35: Definujte malý, testovatelný cíl; schvalte její plán
- Minuta 35–50: Nechte ji implementovat a spouštět testy; šťouchněte podle potřeby
- Minuta 50–60: Zkontrolujte diffy, vylepšete a slučte do větve funkcí
Klíčové odkazy a další kroky
- Oficiální dokumentace "Start Building" a dokumentace k použití pro OpenHands: tipy, rychlý start a osvědčené postupy.
- Průvodce nastavením lokálního LLM: nakonfigurujte a spouštějte OpenHands zcela na svém stroji.
- Návod k instalaci řízený komunitou na VM: kroky instalace v reálném světě a rychlý demo projekt.
Závěry
- Rámujte úkoly jako tickety s jasnými akceptačními kritérii.
- Udržujte iterace malé; testujte brzy a často.
- Používejte ochranné mechanismy a kontrolujte změny – chovejte se k ní jako k juniornímu spoluhráči.
- Vyberte cloud pro pohodlí, lokální modely pro soukromí.
- Spárujte s nástroji pro dokumentaci (např. Sider.AI) pro urychlení specifikací a poznámek k vydání.
FAQ
Q1:Jak mohu rychle nainstalovat a začít používat AI OpenHands?
Použijte oficiální rychlý start k instalaci předpokladů, připojte podporovaný LLM (cloudový nebo lokální) a spusťte uživatelské rozhraní pro připojení svého repozitáře. Dokumentace "Start Building" poskytuje podrobné pokyny s tipy pro nastavení.
Q2:Mohu spouštět OpenHands s lokálním LLM namísto cloudového modelu?
Ano. Postupujte podle průvodce Local LLMs pro konfiguraci backendu lokálního modelu a úpravu nastavení kontextu. To je ideální pro projekty citlivé na soukromí nebo pro vyhnutí se nákladům na API.
Q3:Jaký je nejlepší způsob, jak OpenHands navádět pro úkoly kódování?
Pište prompty jako stručné tickety: definujte cíl, odkazujte na konkrétní soubory, nastavte hranice a zahrňte akceptační kritéria. Požádejte ji, aby vytvořila nebo spustila testy pro ověření postupu.
Q4:Je AI OpenHands bezpečná pro použití na produkčním kódu?
Chovejte se k ní jako k juniornímu vývojáři: používejte ochrany větví, kontrolu kódu a CI k ověření změn. Přidejte ochranné mechanismy pro příkazy a udržujte tajemství mimo prompty.
Q5:Jak se OpenHands srovnává s tradičním asistentem pro kód?
Na rozdíl od nástrojů pouze pro chat může OpenHands spouštět příkazy, upravovat soubory a iterovat autonomně ve vašem repozitáři. Je postavena pro end-to-end úkoly, jako jsou funkce, ladění a testy.
