AI OpenHandsin käyttö: Käytännön opas asennukseen, kehotteisiin ja todellisiin työnkulkuihin
Oletko koskaan toivonut, että pätevä kehittäjä voisi pariohjelmoida kanssasi 24/7? AI OpenHands pääsee siihen yllättävän lähelle. Se on avoimen lähdekoodin "AI-insinööri", joka voi lukea reposi, kirjoittaa koodia, ajaa terminaaleja, selata dokumentteja ja iteroida – aivan kuten nuorempi kehittäjä, joka oppii nopeasti ja työskentelee väsymättömästi. Mutta sen teho avautuu vasta, kun asennat sen oikein ja opit ohjaamaan sitä.
Tämä opas käy läpi AI OpenHandsin käytön vaihe vaiheelta – asennuksesta edistyneisiin työnkulkuihin – jotta voit toimittaa tuotteita nopeammin ja luottavaisin mielin.
- Asennusvaihtoehdot ja nopea alku
- OpenHandsin ajaminen paikallisesti tai pilvimallien kanssa
- Parhaat käytännöt kehotteille, repoille ja tehtäville
- Todistetut työnkulut ominaisuustöille, virheenkorjaukselle, testeille ja dokumenteille
- Suojakaiteet, tietosuoja ja yhteistyö
Huomionarvoista: All Hands -tiimi ja yhteisö kehittävät aktiivisesti OpenHandsia. Viralliset dokumentit ovat pohjantähtesi ajankohtaisille ohjeille ja vinkeille. Voit myös seurata käytännönläheisiä asennusoppaita käyttäjiltä, jotka ovat dokumentoineet paikalliset ja VM-asennukset. Paikallisten mallien kanssa ajamiseen dokumentit sisältävät myös erityisohjeita.
Mikä on AI OpenHands – ja miksi sitä kannattaa käyttää?
Ajattele AI OpenHandsia tekoälypohjaisena tiimikaverina, jolla on näppäimistö. Toisin kuin vain chattipohjaiset avustajat, OpenHands voi:
- Avata ja lukea projektitiedostoja
- Käyttää terminaalia komentojen, testien ja lintterien suorittamiseen
- Muokata koodia tiedostojen ja hakemistojen välillä
- Selata verkkoa (kokoonpanosta riippuen)
- Ehdottaa ja soveltaa vaiheittaisia suunnitelmia
Tämä tekee siitä ihanteellisen tehtäviin, kuten ominaisuuksien toteuttamiseen, virheiden korjaamiseen, testien kirjoittamiseen, dokumenttien luomiseen, refaktorointiin ja koodipohjien modernisointiin. Sen sijaan, että jonglöörait kehotteiden ja kopioinnin/liittämisen kanssa, annat OpenHandsille tavoitteen ja annat sen iteroida, samalla kun valvot sen liikkeitä.
Pikakäynnistys: Nopein tapa käyttää OpenHandsia
Aloittamiseen on useita tapoja. Valintasi riippuu siitä, haluatko käyttää pilvi-LLM:ää vai ajaa kaiken paikallisesti.
Vaihtoehto A: Käytä pilvi-LLM:ää (helpoin)
- Asenna ja suorita sovellus noudattamalla virallisia "Start Building"- ja "Getting Started" -dokumentteja. Tyypillisesti sinun täytyy:
- Asentaa edellytykset (Docker, Node, Python, Git riippuen polusta)
- Antaa API-avaimen tuetulle pilvimallille (esim. OpenAI, Anthropic tai muut projektin tuetut mallit sillä hetkellä)
- Käynnistää OpenHands-käyttöliittymän ja yhdistää repositoriosi
Tämä polku tekee sinusta tuottavan nopeasti ja mahdollisimman pienellä laskentakuormalla.
Vaihtoehto B: Aja OpenHandsia paikallisella LLM:llä
- Jos haluat pitää koodin ja kehotteet poissa pilvestä tai välttää API-kustannuksia, käytä virallisten dokumenttien Local LLMs -opasta.
- Asentaa yhteensopiva paikallinen malli (Ollaman tai muiden sillä hetkellä tuettujen taustajärjestelmien kautta)
- Määrittää mallin päätepisteet ja kontekstirajat
- Varmistaa, että koneellasi on riittävästi VRAM/CPU:ta ja levytilaa
Vaihtoehto C: Ota käyttöön VM:ssä
- Jos tarvitset erillisen ympäristön, käyttäjät ovat dokumentoineet, miten OpenHands käynnistetään VM:ssä ja miten sovellus rakennetaan minuuteissa. Tämä on hyödyllistä tiimeille, jotka haluavat vakaan, jaetun tekoälyinsinööri-instanssin.
Ensimmäinen ajo: Projektin asennus ja tehtävän rajaaminen
OpenHands loistaa, kun se näkee koodisi. Aloita:
- Avaamalla repositorion, jonka parissa haluat sen työskentelevän.
- Ajamaan tai indeksoimaan projektin, jotta OpenHands voi kartoittaa rakenteen.
- Antamalla sille selkeän tavoitteen rajoituksineen.
Hyvä esimerkki tehtävän rajaamisesta:
- "Lisää käyttäjän salasanan nollaus
auth-palveluun käyttämällä token-pohjaisia sähköpostilinkkejä. Käytä olemassa olevaa mailer-moduulia. Lisää yksikkötestejä tokenin luomiseen ja vanhenemiseen. Älä muuta käyttäjätietojen skeemaa."
Miksi tämä toimii:
- Se nimeää komponentin, laajuuden, riippuvuudet ja rajat. Mitä selkeämpi olet, sitä paremmin OpenHands suunnittelee ja toteuttaa.
Miten kirjoittaa tehokkaita kehotteita OpenHandsille
Ajattele kehotteita ytimekkäinä tiketteinä. Parhaat:
- Määrittelevät lopputuloksen: "Toteuta X Y-rajoituksilla"
- Viittaavat tiedostoihin, moduuleihin tai testeihin: "Katso
auth/routes.py ja tests/test_auth.py"
- Ilmoittavat rajoitukset: "Ei DB-skeeman muutoksia; säilytä olemassa olevat rajapinnat"
- Sisältävät hyväksymiskriteerit: "Testien pitäisi läpäistä:
pytest -k password_reset"
Uudelleenkäytettävä malli:
Tavoite: <Mitä haluat rakennettavan tai korjattavan>
Konteksti: <Asiaankuuluvat tiedostot, tunnetut rajoitukset, ulkoiset palvelut>
Hyväksyminen: <Miltä läpäisy näyttää: testit, päätepisteet, mittarit>
Rajat: <Mitä ei saa muuttaa tai mitä lähestymistapoja on vältettävä>
Työkalut: <Komennot, joita se voi suorittaa, skriptit tai tietolähteet>
Ydinworkflow: Suunnittele → Toteuta → Vahvista → Hienosäädä
OpenHands ehdottaa yleensä monivaiheista suunnitelmaa. Näin voit ohjata sitä:
- Hyväksy tai säädä sen suunnitelmaa aikaisin. Kannusta sitä ajamaan testit ensin, jotta epäonnistumiset saadaan määriteltyä.
- Pyydä sitä luomaan tai päivittämään testi onnistumisen määrittämiseksi ja toteuttamaan sitten koodi.
- Pyydä sitä ajamaan testipaketti ja lintterit usein.
- Jos se pysähtyy, lisää kontekstia: tiedostonimiä, pinojälkiä tai lokeja.
Ammattilaisvinkki: Kannusta pieniä PR-kokoisia muutoksia monoliittisten muokkausten sijaan. Tämä auttaa arvioitavuudessa ja palautuksessa.
Esimerkkityönkulkuja, jotka voit kopioida
1) Ominaisuuden toteutus
- Kehote: "Lisää CSV-vienti
orders-sivulle. Käytä palvelinpuolen sivutusta, suoratoista tulokset text/csv-muodossa. Lisää Vie-painike OrdersTable.jsx:ssä ja päätepiste routes/orders.ts:ssä. Sisällytä testit sivutukselle ja otsikoille."
- Skannaa repo; laatii suunnitelman
- Lisää päätepisteen ja asiakaspainikkeen
- Kirjoittaa testejä ja ajaa ne
- Valvot, hyväksyt muutokset ja yhdistät, kun kaikki on vihreää.
2) Virheenkorjaus epäonnistuneessa buildissa
- Kehote: "CI epäonnistuu Node 20:ssä. Korjaa ESM/CJS-tuontivirheet
build.mjs:ssä. Säilytä olemassa olevat rollup-lisäosat; päivitä määritykset ja koodi CI:n läpäisemiseksi."
- Anna lokeja tai linkki CI-artefakteihin.
- Pyydä OpenHandsia replikoimaan paikallisesti (
npm run build) ja ehdottamaan mahdollisimman pieniä differeitä.
3) Testikattavuus ja koventaminen
- Kehote: "Lisää
payments/service.py:n kattavuutta 62 %:sta 85 %:iin+. Lisää yksikkötestejä retry_charge:lle, refund:lle ja webhook_signature:lle. Älä muokkaa liiketoimintalogiikkaa, ellei testi paljasta virhettä."
- Anna OpenHandsin luoda testejä, ajaa ne ja hienosäätää niitä.
4) Dokumentit ja kehittäjäkokemus
- Kehote: "Luo
CONTRIBUTING.md ja DEVELOPMENT.md tälle repolle. Sisällytä ympäristön asennus, skriptit, testikomennot ja PR-ohjeet."
- Pyydä sitä vahvistamaan komennot suorittamalla ne itse.
Suojakaiteet: Pidä OpenHands avuliaana ja turvallisena
- Hakemiston laajuus: Osoita se tiettyyn repoon tai hakemistoon, jotta vältät vahingossa tapahtuvat muokkaukset muualla.
- Tiedostosuojaus: Merkitse määritystiedostot tai kriittinen infrastruktuuri mahdollisuuksien mukaan vain luku -tilaksi.
- Komentojen auditointi: Vaadi hyväksyntä tuhoaville komennoille (esim.
rm -rf, tietokannan nollaukset).
- Salaisuuksien hygienia: Älä koskaan liitä API-avaimia kehotteisiin. Käytä ympäristömuuttujia ja peitettyjä lokeja.
- Verkkoyhteys: Jos selaus on käytössä, eristä se erilliseen ympäristöön ja kirjaa lähtevät puhelut.
Paikalliset vs. pilvimallit: Oikean valitseminen
- Hyvät puolet: Vahva päättely/koodaus, minimaalinen asennus, nopea iterointi
- Huonot puolet: Jatkuvat kustannukset, tietohallintoon liittyvät näkökohdat
- Hyvät puolet: Tietosuoja, hallinta, kustannusten ennustettavuus
- Huonot puolet: Laitteistovaatimukset, mallin laatu vaihtelee, enemmän viritystä tarvitaan
Katso viralliset Local LLMs -ohjeet mallin taustajärjestelmien ja muistirajoitusten määrittämiseksi.
Tiimipeli: OpenHandsin käyttö yhteistyövirrassa
- Haarapohjainen työnkulku: Pyydä OpenHandsia luomaan ominaisuushaarato ja lähettämään muutokset PR-tarkistusta varten.
- Commit-hygienia: Pyydä sitä tuottamaan atomisia committeja selkeillä viesteillä ja viitenumeroilla.
- PR-mallit: Luo ja valvo PR-malleja, jotta tarkastajat tietävät, mikä on muuttunut ja miksi.
- Koodin omistajat: Yhdistä CODEOWNERSin kanssa reitittääksesi tekoälyn luomat PR:t oikeille tarkastajille.
Yleisten ongelmien vianmääritys
- Se juuttuu tai silmukoi: Rajoita laajuutta. Pyydä sitä selittämään seuraava vaihe. Anna epäonnistunut testi.
- Sotkuiset differit: Pyydä pienempää, vaiheittaista suunnitelmaa – testit ensin, sitten minimaaliset koodimuutokset.
- Väärät tiedostomuokkaukset: Määritä tarkat polut ja muistuta sitä rajoista.
- Läpäisee paikallisesti, mutta epäonnistuu CI:ssä: Jaa CI-ympäristön tiedot ja lokit; pyydä sitä replikoimaan säilön avulla.
Suorituskykyvinkkejä ja tehokkaita siirtoja
- Lämmin alkukonteksti: Pyydä sitä lukemaan ensin avaintiedostot (
README, package.json, pääpalvelutiedostot).
- Anna sille skriptejä: Anna
make test tai npm run verify, jotta se voi validoida nopeasti.
- Opeta verkkotunnus: Tarjoa lyhyt arkkitehtoninen yleiskatsaus; se maksaa itsensä takaisin vähemmillä logiikkavirheillä.
- Valvo tyyliä: Osoita
.eslintrc-, .prettierrc-, black/ruff-määrityksiin, jotta se muotoilee oikein.
- Käytä tarkistuspisteitä: Pyydä jokaisen virstanpylvään jälkeen yhteenvetoa ja seuraavia vaiheita, jotta se pysyy raiteilla.
Todellinen skenaario: Virheraportista korjaustiedostoon tunnissa
- Tilanne: Tuotantovirhe pudottaa käsittelemättömiä 500-virheitä virheellisesti muotoilluista JSON-kuormista
orders-rajapinnassa.
- Kehotteesi: "Toista 500-virhe virheellisessä JSON:ssä
orders POSTissa. Lisää skeeman validointi ja palauta 400 virhetiedoilla. Päivitä testit kattamaan virheelliset kuormat."
- Ajaa rajapintaa paikallisesti, toistaa virheen
- Lisää validointikerroksen ja virheenkäsittelijän
- Päivittää testit ja varmistaa, että CI läpäisee
- Tuottaa tiiviin PR:n, jossa on muutoshistoriakirjaus
Säästetty aika: Keskityit vaikutusanalyysiin ja käyttöönottoon, kun OpenHands hoiti rakenteen.
Integraatiot, jotka lataavat OpenHandsia
- Testiajureita: pytest, Jest, Vitest, JUnit
- Rakennustyökaluja: Vite, Webpack, Rollup, Babel
- Pakettienhallintaohjelmia: npm, pnpm, yarn, pip/poetry
- Lintereitä/muotoilijoita: ESLint, Prettier, black, ruff
- Säilöjä: Docker Compose paikalliseen pariteettiin CI:n kanssa
Standardoimalla nämä työkalut OpenHands voi päätellä pinoasi luotettavammin ja automatisoida enemmän kehityssilmukasta.
Muuten: Sider.AI:n käyttö OpenHandsin rinnalla
Merkityspisteet: 8/10. Jos käytät OpenHandsia tekoälyinsinöörinäsi, se kannattaa yhdistää tutkimus- ja luonnosapuriin eritelmiä, PR-kuvauksia ja dokumentaatiota varten. Muuten, Sider.AI voi auttaa sinua luonnostelemaan nopeasti teknisiä eritelmiä, tiivistämään RFC:itä tai muuntamaan OpenHandsin suorituslokeja puhtaiksi muutoshistoriaksi ja julkaisutiedoiksi. Yhdistelmä vähentää kontekstin vaihtamista: OpenHands hoitaa kooditoiminnot, kun taas Sider.AI muuntaa tulokset puhtaiksi, käyttäjille suunnatuiksi dokumenteiksi.
Turvallisuus-, tietosuoja- ja vaatimustenmukaisuusluettelo
- Pidä salaisuudet ympäristömuuttujissa; älä koskaan upota avaimia kehotteisiin
- Tarkista jokainen tekoälyn luoma muutos kuin tarkistaisit nuoremman kehittäjän PR:n
- Kirjaa komennot ja toiminnot auditoitavuuden vuoksi
- Kiinnitä työkaluketjun versiot; vältä vahingossa tapahtuvia päivityksiä lukitustiedostoissa
- Jos käytät pilvi-LLM:iä, mukauta tietojen säilytyskäytäntöjesi mukaan
Milloin OpenHandsia ei kannata käyttää
- Uuden algoritmin suunnittelu ilman vahvaa testi- tai eritelmärakennetta
- Tiukasti säännellyt koodipohjat ilman vankkaa tarkistusprosessia
- Kertakäyttöiset heittoskriptit, joissa manuaalinen koodaus on nopeampaa
Ensimmäiset 60 minuuttia OpenHandsin kanssa: Minikäsikirja
- Minuutti 0–10: Asenna ja käynnistä virallisen pikakäynnistyksen avulla
- Minuutti 10–20: Yhdistä reposi; pyydä sitä kartoittamaan projektin rakenne
- Minuutti 20–35: Määritä pieni, testattava tavoite; hyväksy sen suunnitelma
- Minuutti 35–50: Anna sen toteuttaa ja ajaa testit; tuuppaa tarvittaessa
- Minuutti 50–60: Tarkista differit, hienosäädä ja yhdistä ominaisuushaaraan
Tärkeimmät linkit ja seuraavat vaiheet
- Viralliset "Start Building"- ja käyttödokumentit OpenHandsille: vinkkejä, pikakäynnistys ja parhaat käytännöt.
- Paikallinen LLM-asennusopas: määritä ja aja OpenHands kokonaan koneellasi.
- Yhteisölähtöinen asennusohje VM:ssä: todelliset asennusvaiheet ja nopea demoprojekti.
Pääkohdat
- Rajaa tehtävät kuten tikettejä selkeillä hyväksymiskriteereillä.
- Pidä iteraatiot pieninä; testaa varhain ja usein.
- Käytä suojakaiteita ja tarkista muutokset – kohtele sitä kuin nuorempaa tiimikaveria.
- Valitse pilvi mukavuuden vuoksi, paikalliset mallit tietosuojan vuoksi.
- Yhdistä dokumentointityökaluihin (esim. Sider.AI) nopeuttaaksesi eritelmiä ja julkaisutietoja.
FAQ
K1: Miten asennan ja aloitan AI OpenHandsin käytön nopeasti?
Käytä virallista pikakäynnistystä asentaaksesi edellytykset, liitä tuettu LLM (pilvi tai paikallinen) ja käynnistä käyttöliittymä yhdistääksesi repositoriosi. "Start Building" -dokumentit tarjoavat vaiheittaiset ohjeet asennusvinkeillä.
K2: Voinko ajaa OpenHandsia paikallisella LLM:llä pilvimallin sijaan?
Kyllä. Määritä paikallinen mallitaustajärjestelmä ja säädä kontekstiasetuksia Local LLMs -oppaan avulla. Tämä on ihanteellinen tietosuojaa vaativiin projekteihin tai API-kustannusten välttämiseen.
K3: Mikä on paras tapa kehottaa OpenHandsia koodaustehtäviin?
Kirjoita kehotteita kuin ytimekkäitä tikettejä: määrittele tavoite, viittaa tiettyihin tiedostoihin, aseta rajat ja sisällytä hyväksymiskriteerit. Pyydä sitä luomaan tai suorittamaan testejä edistymisen validoimiseksi.
K4: Onko AI OpenHandsia turvallista käyttää tuotantokoodissa?
Kohtele sitä kuin nuorempaa kehittäjää: käytä haarasuojauksia, koodin tarkistusta ja CI:tä muutosten validoimiseksi. Lisää suojakaiteita komennoille ja pidä salaisuudet poissa kehotteista.
K5: Miten OpenHands vertautuu perinteiseen koodiavustajaan?
Toisin kuin vain chattipohjaiset työkalut, OpenHands voi suorittaa komentoja, muokata tiedostoja ja iteroida itsenäisesti repositoriosi sisällä. Se on rakennettu päästä päähän -tehtäviin, kuten ominaisuuksiin, virheenkorjaukseen ja testeihin.
