AI-diagnostiikka ja Autopilot

Selvitä, miksi agentti on jumissa, vaihda istuin vara-agenttiin ja anna Autopilotin elvyttää agentti, joka kaatui tai menetti yhteytensä kesken tehtävän.

Agentti voi lakata toimimasta kahdella tavalla. Se voi olla elossa mutta jumissa: ruudulla on kiintiöseinä, kirjautumiskehote tai myyntimodaali, eikä viestisi pääse perille. Tai se voi kuolla: yhteys katkeaa tai CLI sulkeutuu kesken tehtävän. AI-diagnostiikka hoitaa ensimmäisen tapauksen ja Autopilot toisen. Molemmat löytyvät samasta paikasta.

Avaa Orchestration Dashboard yläpalkista tai aja Open Orchestration Dashboard Command Paletessa ja valitse sitten Advanced → AI Diagnosis. Tutorials → How-to → Autopilot vie suoraan sinne.

AI Diagnosis -asetukset, joissa Diagnose & restore stuck agents on kytketty tilaan On, With AI on valittuna ja näkyvillä on järjestetty lista tarkistinagenteista — Claude mallilla claude-opus-5 ja Codex mallilla gpt-5.6-sol — jokaisella oma mallivalitsin

Diagnose & restore stuck agents

Kun viestin toimitus agentin terminaaliin epäonnistuu noin kahden minuutin ajan, asennettu AI-CLI lukee terminaalin ruututekstin ja kertoo, mikä on vialla. Toimitusta yritetään uudelleen 15 sekunnin välein, ja kahdeksas epäonnistuminen käynnistää diagnosoinnin. Jos terminaali istuu kaavion istuimella, jolla on vara-agentteja, istuin vaihtuu itsestään. Kaikki muut terminaalit saavat diagnoosin ilmoituksena, jotta voit toimia. Terveitä terminaaleja ei koskaan tarkisteta.

Diagnose & restore stuck agents on oletuksena päällä ja koskee koko sovellusta — jokaista tiimiä, kaaviota ja linkitettyä terminaalia. Valitse kohdassa How to restore:

  • With AI (recommended): tarkistin-AI lukee ensin jumissa olevan terminaalin ruudun, ja vain vahvistettu kiintiö- tai kirjautumisseinä käynnistää palautuksen. Se ei koskaan häiritse agenttia, joka on vain kiireinen.
  • Manual timer — no AI: pelkkä ajan umpeutuminen palauttaa. Tämä on nopeampaa ja täysin paikallista, mutta se ei erota jumiutunutta agenttia pitkän tehtävän parissa työskentelevästä.

Tarkistinagentit järjestyksessä

Tarkistimia kokeillaan yksi kerrallaan. Jos tarkistinta ei ole asennettu, se osuu omaan rajoitukseensa tai aikakatkaistaan, seuraava ottaa vuoron. Jumissa olevan terminaalin oma palveluntarjoaja ohitetaan aina, jotta agentti ei koskaan arvioi itseään. Claude, Codex, Gemini, OpenCode, Qwen, Kimi, Grok ja Hermes voivat kaikki toimia tarkistimina, enintään neljä kerrallaan. Muokkaa listaa painikkeella + Add checker, järjestä nuolilla ja poista painikkeella Remove. Jos et valitse yhtään, käytetään ensimmäistä asennettua CLI:tä tässä järjestyksessä.

Jokaisella tarkistimella on oma mallinsa (versiosta v1.75.0 lähtien). Avaa agentin vieressä oleva pudotusvalikko valitaksesi mallin, tai jätä valinta Default model käyttääksesi CLI:n oletusta.

Tarkistimet ajetaan headless-tilassa, rajoitetuin oikeuksin ja neutraalissa hakemistossa. Ne luokittelevat ruudun ja vastaavat yhdellä JSON-rivillä, eivätkä koske projektiisi. Ruututeksti lähetetään tarkistimelle vasta sen jälkeen, kun olet antanut kertaluonteisen ruudunlukusuostumuksen.

Autopilot (failed tasks)

Autopilot käynnistää uudelleen agentin, joka kuoli tai menetti yhteytensä kesken tehtävän. Se jatkaa agentin istuntoa tai siirtää tehtävän istuimen vara-agentille. Se ei koskaan vastaa kysymyksiin eikä kirjoita valitsimeen. Se on oletuksena pois päältä. Vaihda Autopilot (failed tasks) -kortti tilaan On. Päälle kytkeminen antaa myös ruudunlukusuostumuksen, jota AI-diagnostiikka käyttää.

Autopilot (failed tasks) -kortti kohdassa Agent Orchestration → AI Diagnosis, kytketty tilaan On ja Watching, Resume the session-, Switch to backup- ja Wait for you -laatoilla sekä niiden alla Recent decisions -lista jatketuista agenteista

Kun se on päällä, kortissa lukee Watching. Acts only when a running task goes quiet, its process exits, or a message to it stalls. Idle tabs are never checked. Paina How it works nähdäksesi animoidun esittelyn.

Milloin se toimii

Autopilot tarkastelee vain terminaaleja, jotka työskentelevät lähettämäsi kehotteen parissa. Kolme asiaa käynnistää sen:

KäynnistinMikä lasketaan
Prosessi sulkeutuuCLI sulkeutuu virheeseen, kun kehote on vielä keskeneräinen. Tahallinen poistuminen komennolla /exit tai Ctrl-D on siisti sulkeutuminen ja jätetään rauhaan.
Tehtävä hiljeneeKäynnissä oleva tehtävä lakkaa tuottamasta tulostetta, ja tarkistin lukee ruudun varmistaakseen, että se on todella jumissa.
Viesti jäätyyToimitus epäonnistuu toistuvasti ja AI-diagnostiikka raportoi katkenneen yhteyden.

Mitä se tekee

  • Resume the session. Autopilot käynnistää agentin uudelleen samassa terminaalissa kyseisen CLI:n omalla jatkokomennolla, joten sama istunto ja transkriptio palaavat. Tämä toimii seuraaville: Claude Code, Codex, Gemini, Cursor, OpenCode, Grok, Kimi, Qwen, Amp, Cline, Hermes, Antigravity ja Qoder.
  • Pyydä jatkamaan. Kun After a resume, ask the agent to continue on päällä (oletus), jatkettu agentti saa yhden ohjeen: jatka siitä, mihin jäit, älä tee uudelleen jo valmiita vaiheita, ja tarkista keskeytyneen vaiheen tulos ennen sen toistamista.
  • Switch to backup. Jos välilehti ei voi jatkua — vakavan virheen vuoksi tai koska jatkettavaa istuntoa ei ole — kaavion istuin, jolla on vara-agentti, luovuttaa tehtävän kuvauksineen. Vanha välilehti jää auki.
  • Wait for you. Jos ruudulla on kysymys, valitsin, puoliksi kirjoitettu luonnos tai kirjautumisseinä — tai jokin muu on epäselvää — mitään ei kirjoiteta. Kysymykset, valitsimet ja luonnokset jätetään yksinkertaisesti rauhaan. Kirjautumisseinät ja epäselvät ruudut lähettävät sinulle ilmoituksen.

Uudelleenyritysrajat

Autopilot odottaa 5 sekuntia ennen ensimmäistä uudelleenkäynnistystä. Jos sama kehote epäonnistuu uudelleen, se odottaa 20 sekuntia ennen toista ja 60 sekuntia ennen kolmatta uudelleenkäynnistystä. Sen jälkeen se lopettaa ja hälyttää sinut Activity-kortilla, jossa lukee Stopped retrying "…" after 3 resumes; waiting on you. Uusi kehote sinulta nollaa laskurin. Yhtään terminaalia ei koskaan käynnistetä uudelleen yli 6 kertaa tunnissa.

Recent decisions

Recent decisions listaa tämän koneen 5 viimeisintä toimenpidettä. Jokainen rivi näyttää ajan, kehotteen, projektin ja syyn sekä merkin: Resumed, Switched to backup, Couldn't resume, Continued, Stopped retrying tai Waiting on you. Activity-korteissa on Autopilot-merkki. Koko kirjanpito on pelkästään lisättävä ja kirjoitetaan tiedostoon ~/.1devtool/orchestration/autopilot-ledger.jsonl.

Pause ja Off

  • Pause estää Autopilotia jatkamasta tai vaihtamasta mitään, kunnes perut tauon. Diagnose & restore stuck agents -toiminnon vara-agenttivaihdot jatkuvat silti.
  • Off pysäyttää Autopilotin ja poistaa mahdollisen tauon.

Jos haluat kytkeä Autopilotin pois yhdeltä käynnistyskerralta muuttamatta asetusta, käynnistä 1DevTool ympäristömuuttujalla ONEDEVTOOL_AUTOPILOT=off. Kortissa lukee silloin Off for this launch.

Aiheeseen liittyvää