Google Antigravity Remote Control: kaip valdyti agentą telefonu
MarkdownKaip įjungti Remote Control „Google Antigravity“ kompiuteryje ir CLI: jungiklis, agy remote-control demonas ir ką daryti kilus ryšio problemų.
Skaityti visą straipsnį
Ailoot dokumentacija — informacinė medžiaga apie paslaugos naudojimą.
Svarbiausi punktai
„Antigravity 2.0“ darbalaukio programoje Remote Control įjungiamas jungikliu skiltyje Settings → App. Prie sesijos galite prisijungti adresu antigravity.google.com naudodami tą pačią Google paskyrą. „Antigravity CLI“ veikia dviem režimais: /remote-control (arba vėliavėlė --remote-control) atidaro tunelį terminalo sesijos laikui, o agy remote-control start paleidžia fone veikiantį demoną, kuriam nereikia atidaryto terminalo. „Linux“ sistemoje demonas veikia ir atsijungus, o paleidus sistemą iš naujo — vėl pasileidžia; „Windows“ sistemoje tam reikia administratoriaus įdiegimo; „macOS“ sistemoje ir naudojant standartinį „Windows“ diegimą jis vėl pasileidžia kitą kartą prisijungus. Kompiuteris turi būti įjungtas ir prijungtas prie interneto. Ši funkcija gali būti nepasiekiama dėl paskyros ar organizacijos politikos arba plano sąlygų.
Jei dar neįdiegėte „Antigravity“, pirmiausia susipažinkite su apžvalga apie tai, kas yra „Google Antigravity“ ir kaip ją įdiegti. Šis vadovas skirtas atvejui, kai agentas jau atlieka ilgai trunkančią užduotį (refaktorizuoja, vykdo testus, perkelia priklausomybes), o jums reikia atsitraukti nuo stalo ir kartu išlaikyti sesijos valdymą.
Kas yra Remote Control ir kam jo reikia
Remote Control — tai „Google Antigravity“ funkcija, leidžianti saugiai prisijungti prie darbalaukio ir CLI sesijų jūsų įrenginiuose ir jas valdyti bet kurioje žiniatinklio naršyklėje. Remiantis oficialiu aprašymu, didelės užduotys, pavyzdžiui, viso posistemio refaktorizavimas, ilgas testų vykdymas ar sudėtingas priklausomybių perkėlimas, gali užtrukti. Remote Control leidžia tvarkyti sesiją būnant ne prie kompiuterio, o visa kūrimo aplinka lieka vietinė.
Ši funkcija veikia ir darbalaukio programoje 2.0, ir CLI — terminalo „Antigravity“ versijoje (agy) — tačiau kiekvienoje jų įjungiama ir veikia skirtingai.
Remote Control įjungimas „Antigravity 2.0“ darbalaukio programoje
Remote Control galite įjungti programos nustatymuose:
- Atidarykite Settings skydelį sparčiuoju klavišu
Cmd + ,(arbaCtrl + ,„Linux“ ir „Windows“ sistemose) arba spustelėkite Settings mygtuką kairiojo skydelio apačioje. - Eikite į skiltį App.
- Perjunkite Enable Remote Control į On.
- (Pasirinktinai) Nustatykite Nickname, pavyzdžiui,
workstation-primaryarbaserver-machine, kad prijungtų įrenginių sąraše galėtumėte lengvai atpažinti šį kompiuterį.
Prisijungimas telefonu arba kita naršykle
Norėdami atidaryti nuotolinę sesiją:
- Atidarykite naršyklę bet kuriame įrenginyje ir eikite į „Antigravity Remote Control“ valdymo skydelį. Telefone taip pat galite įdiegti žiniatinklio programą į pagrindinį ekraną, kad gautumėte tiesioginius pranešimus, kai agentas užbaigia užduotį arba prašo atsakymo.
- Prisijunkite naudodami tą pačią Google paskyrą, kurią naudojate kompiuteryje.
- Įrenginių perjungiklyje pasirinkite norimą kompiuterį.
- Prisijungę galėsite matyti aktyvius pokalbius, pradėti agentui naujas užduotis ir peržiūrėti įgyvendinimo planus bei artefaktus.
Jei kompiuteris nerodomas žiniatinklio sąsajoje, oficialiose instrukcijose nurodoma patikrinti tris dalykus: ar kompiuteryje, kuriame veikia „Antigravity“, įjungtas Enable Remote Control jungiklis; ar tas kompiuteris prijungtas prie interneto ir neužmigo; ar darbalaukio programa ir naršyklė naudoja tą pačią Google paskyrą.
Jei įrenginyje, iš kurio jungiatės, tinklo ryšys laikinai nutrūksta, žiniatinklio sąsaja bandys prisijungti iš naujo automatiškai. Agento foninės užduotys ir iš terminalo paleistos komandos kompiuteryje su „Antigravity“ tęsiamos be pertrūkio, jei tik jis lieka prijungtas prie interneto.
Du Remote Control režimai „Antigravity CLI“
CLI turi du režimus: interaktyvųjį, susietą su konkrečiu terminalo procesu, ir fone veikiantį demoną, kuriam nereikia atidaryto terminalo.
Interaktyvusis režimas: /remote-control
Remote Control galite įjungti dabartinėje interaktyvioje agy sesijoje nepaleisdami CLI iš naujo. Įveskite tai įvesties eilutėje:
/remote-control
Remiantis oficialiu aprašymu, CLI atidaro dabartinės sesijos ryšį — atvirkštinį tunelį — ir parodo pagrindinio kompiuterio vardą bei nuorodą į aktyvų pokalbį, kurią galima atidaryti kitame įrenginyje:
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.
Atidarykite šią nuorodą nešiojamojo kompiuterio, planšetės ar telefono naršyklėje, prisijunkite naudodami tą pačią Google paskyrą kaip CLI ir tęskite darbą su sesija per „Antigravity“ žiniatinklio sąsają.
Norėdami išjungti tunelį neužbaigdami vietinės terminalo sesijos:
/remote-control off
Paleisdami CLI galite iš karto įjungti Remote Control, nurodę vėliavėlę:
agy --remote-control
Interaktyvusis režimas susietas su agy procesu: kai išeinate iš CLI (/exit, Ctrl+C, Ctrl+D) arba uždarote terminalo langą, Remote Control tunelis automatiškai nutrūksta, o sesijos įrašas dingsta iš valdymo skydelio. Kiekvienas interaktyvus CLI procesas turi atskirą sesijos ID ir pagrindinio kompiuterio vardą, todėl vienu metu keliuose terminalo skirtukuose ar darbiniuose kataloguose galite paleisti kelias agy --remote-control kopijas.
Kai prie interaktyvios CLI sesijos prisijungiate per naršyklę, abi pusės sinchronizuojamos realiuoju laiku. Nuotolinio įrenginio užklausos nukreipiamos tiesiai į vietinį terminalą, o agento samprotavimas, įrankių iškvietimai ir kodo pakeitimai matomi nuotolinėje sąsajoje. Jei agentas sustoja ir prašo patvirtinimo (y/n) arba užduoda papildomą klausimą, galite atsakyti telefonu arba vietiniame terminale. Išimtis — nustatymai: jų negalima keisti nuotolinėje žiniatinklio sąsajoje, tik pačiame CLI.
Fone veikiantis demonas: agy remote-control start
Antrasis režimas — nuolat veikiantis fono demonas, užregistruojamas kaip operacinės sistemos paslauga. Jis pasiekiamas, kol kompiuteris įjungtas ir prijungtas prie interneto; veikimas atsijungus ir iš naujo paleidus kompiuterį priklauso nuo platformos.
agy remote-control start
Demonas užregistruojamas kaip operacinės sistemos paslauga („Linux“ naudotojo systemd paslauga, „macOS“ LaunchAgent arba „Windows“ suplanuota užduotis) ir paleidžiamas iš karto, neatidarius terminalo lango.
Komanda agy remote-control status parodo įrašo pavadinimą. Tada pasirinkite šį kompiuterį „Antigravity Remote Control“ valdymo skydelyje ir tęskite darbą per „Antigravity“ žiniatinklio sąsają.
Demoną valdo trys komandos:
agy remote-control start Register and start the daemon
agy remote-control status Show the daemon's status and instance name
agy remote-control stop Stop the daemon and unregister it
Demonas naudoja prisijungimo duomenis, kuriuos naudojote prisijungdami prie CLI. Prisijungimas prie CLI nesusijęs su prisijungimu prie „Antigravity“ darbalaukio rengyklės tame pačiame kompiuteryje; naršyklėje naudokite tą pačią Google paskyrą kaip CLI.
Fone veikiančio demono kompiuterio pavadinimą galite nustatyti paleisdami su vėliavėle --name:
agy remote-control start --name "my-workstation"
Dar kartą paleidus start --name su nauja reikšme, kompiuterio pavadinimas pakeičiamas.
Jei pavadinimo nenustatysite, pirmą kartą paleidęs demonas sugeneruos įsimintiną pavadinimą (pavyzdžiui, my-machine-distant-plume); dabartinį pavadinimą parodys agy remote-control status. Jį taip pat galite pakeisti nustatymų faile: „Linux“ / „macOS“ sistemoje atidarykite ~/.gemini/config/config.json, o „Windows“ sistemoje — %USERPROFILE%\.gemini\config\config.json, pakeiskite cliRemoteControlHostname reikšmę, išsaugokite failą ir vėl paleiskite agy remote-control start, kad demonas būtų paleistas iš naujo. Naujas pavadinimas valdymo skydelyje pasirodys paslaugai pasileidus iš naujo; kol demonas veikia, failo pakeitimai neįsigalioja.
Faile yra du panašūs laukai. cliRemoteControlHostname — čia aptariamas CLI demono pavadinimas. remoteControlHostname — atskiras laukas, skirtas tame pačiame kompiuteryje esančiai „Antigravity“ darbalaukio rengyklei; „Antigravity 2.0“ jį galite pakeisti skiltyje Settings → App.
Kaip demonas veikia atsijungus ir paleidus kompiuterį iš naujo
Veikimas priklauso nuo operacinės sistemos:
| Veikimas | Linux | macOS | Windows |
|---|---|---|---|
| Paleidimas | Paleidus sistemą; prisijungti nereikia | Prisijungus | Paleidus sistemą (jei įdiegė administratorius); kitu atveju prisijungus |
| Veikia atsijungus | Taip | Ne; vėl pasileidžia kitą kartą prisijungus | Taip, jei sukonfigūruota paleisti sistemai startuojant |
| Automatiškai atsikuria po gedimo | Taip | Taip | Taip, iki trijų paleidimo iš naujo bandymų, tada kitą kartą paleidus sistemą arba vėl įvykdžius agy remote-control start |
Konkreti informacija apie „Windows“
Norint užregistruoti demoną automatiniam paleidimui paleidus sistemą, reikia jį paleisti administratoriaus teisėmis. Galite naudoti „PowerShell“ arba įprastą komandų eilutę. Komanda start veiks ir įprastame lange, tačiau atsijungus arba paleidus kompiuterį iš naujo demonas pasileis tik kitą kartą prisijungus, o ne paleidus sistemą. Komandos status ir stop veikia įprastame lange be padidintų teisių.
Kurį režimą pasirinkti
| Kriterijus | Interaktyvusis (/remote-control / agy --remote-control) | Fone veikiantis demonas (agy remote-control start) |
|---|---|---|
| Aprėptis | Viena interaktyvi terminalo sesija | Visas kompiuteris (fone veikianti operacinės sistemos paslauga) |
| Veikimo trukmė | Aktyvus, kol įjungtas Remote Control ir veikia terminalo sesija | Išlieka atsijungus ir paleidus kompiuterį iš naujo „Linux“ sistemoje ir „Windows“ sistemoje, jei jį įdiegė administratorius; „macOS“ sistemoje ir naudojant standartinį „Windows“ diegimą vėl pasileidžia kitą kartą prisijungus |
| Įrašo pavadinimas | Naujas kiekvienai sesijai (pavyzdžiui, host-swift-falcon) | Vienas nuolatinis kompiuterio pavadinimas (--name arba cliRemoteControlHostname) |
| Lygiagretumas | Kelios terminalo sesijos vienu metu viename kompiuteryje | Viena demono paslauga vienam kompiuteriui |
| Tiesioginė nuoroda | CLI parodo nuorodą į aktyvų pokalbį | Pasiekiama per įrenginių perjungiklį adresu antigravity.google.com |
| Geriausiai tinka | Atsitraukti nuo aktyvios terminalo užduoties ir tęsti ją telefonu ar naršykle | Nuolat nuotoliniu būdu pasiekti darbo stotį ar serverį, kol kompiuteris įjungtas ir prijungtas prie interneto, atsižvelgiant į operacinės sistemos sąlygas |
Interaktyviojo režimo pakanka, kad galėtumėte telefonu tvarkyti dabartinę užduotį. Jei nuotolinės prieigos reikia neatidarius terminalo, naudokite fone veikiantį demoną, atsižvelgdami į operacinės sistemos sąlygas.
Ką daryti kilus ryšio problemų
Problemos ir sprendimai pagal oficialią dokumentaciją:
| Ką matote | Kodėl | Ką daryti |
|---|---|---|
Remote control is not enabled for your account | Jūsų paskyroje arba pagal organizacijos politiką Remote Control funkcija neįjungta | Susisiekite su darbo srities administratoriumi arba patikrinkite, ar jūsų planas palaiko Remote Control |
| Įrašas dingsta iš valdymo skydelio (CLI) | /remote-control ir agy --remote-control sukuria tunelius, kurie automatiškai atsijungia užbaigus interaktyvią sesiją (/exit, Ctrl+C) arba įvykdžius /remote-control off | Jei norite, kad kompiuteris liktų pasiekiamas neatidarius terminalo, įdiekite demoną naudodami agy remote-control start |
| Valdymo skydelyje rodomi keli CLI įrašai iš to paties kompiuterio | Kiekviena interaktyvi CLI sesija turi savo pagrindinio kompiuterio vardą; tai įprasta, kai atidaryti keli terminalai | Nieko daryti nereikia; taip ir turi būti |
| Kompiuteris nerodomas valdymo skydelyje (demonas) | Gali būti, kad kilo CLI prisijungimo problema | Vykdykite agy remote-control status; jei rodoma prisijungimo problema, paleiskite agy, prisijunkite iš naujo, tada dar kartą paleiskite agy remote-control start |
| Pervadinimas neįsigaliojo | Pavadinimas nuskaitomas paleidžiant demoną | Paleiskite agy remote-control start dar kartą, kad demonas būtų paleistas iš naujo |
| „Windows“ sistemoje demonas pasileidžia tik prisijungus, o ne paleidus sistemą | Komanda start įvykdyta be administratoriaus teisių | Dar kartą paleiskite agy remote-control start padidintų teisių lange |
| Ryšys vis nutrūksta ir vėl užmezgamas | Gali būti, kad vis dar užregistruotas senas diegimo scenarijumi įdiegtas demonas ir jis konkuruoja su nauju dėl ryšio | Dar kartą paleiskite agy remote-control start; senoji paslauga bus pašalinta automatiškai |
| Valdymo skydelyje rodomi du panašūs to paties kompiuterio įrašai | Vienas įrašas priklauso rengyklei, kitas — CLI demonui; jie sąmoningai atskirti | Pervadinkite tą, kurį reikia atskirti |
| Kompiuteris nerodomas žiniatinklio valdymo skydelyje (darbalaukio programa) | Gali būti išjungtas jungiklis, nebūti interneto ryšio, kompiuteris gali būti užmigęs arba naudojamos skirtingos Google paskyros | Patikrinkite Enable Remote Control jungiklį, kompiuterio interneto ryšį, ar jis neužmigęs, ir ar abiejose pusėse naudojama ta pati paskyra |
Jei reikia išsamesnės diagnostikos, patikrinkite demono žurnalus: „Linux“ sistemoje vykdykite journalctl --user -u antigravity-cli-daemon -n 50; „macOS“ sistemoje peržiūrėkite ~/Library/Logs/antigravity-cli-daemon.log; „Windows“ sistemoje peržiūrėkite naujausią cli-*.log failą kataloge %USERPROFILE%\.gemini\antigravity-cli\log.
Fone veikiantis demonas suteikia prieigą neatidarius terminalo, taip pat ir jums išvykus, atsižvelgiant į kompiuterio ir operacinės sistemos veikimo sąlygas. Jei nuolatinės prieigos nebereikia, sustabdykite demoną komanda agy remote-control stop.
Atskiras straipsnis skirtas nuotoliniam valdymui „Claude Code“. Jei norite valdyti kitą agentą per „Telegram“, žr. „Hermes Agent“ nustatymą „Telegram“.
Kas toliau
Jei dirbate CLI ir norite atsitraukti nuo dabartinės užduoties, pradėkite interaktyviuoju režimu. Palikite terminalą atidarytą: jei jį uždarysite, tunelis atsijungs, o sesijos įrašas dings iš valdymo skydelio. Jei norite pasiekti kompiuterį neatidarę terminalo, naudokite demoną, atsižvelgdami į operacinės sistemos apribojimus.
Šaltiniai
Daugiau medžiagos rasite Ailoot.
Išsamiau
Klausimai ir atsakymai
Kodėl uždarius terminalą dingsta nuotolinė sesija?
Interaktyvus Remote Control priklauso veikiančiam agy procesui, todėl jį užbaigus uždaromas tunelis. Prieigai be atviro terminalo naudokite foninę tarnybą ir patikrinkite jos operacinės sistemos paleidimo sąlygas.
Ką patikrinti, jei skydelyje nėra mano kompiuterio?
Patikrinkite, kad kompiuteris budrus ir prisijungęs, Remote Control įjungtas, o naršyklė naudoja tą pačią Google paskyrą kaip darbalaukis ar CLI. Foninės tarnybos sesijai per agy remote-control status tikrinkite prisijungimo ar paslaugos problemas.