Tinklaraštis

Google Antigravity Remote Control: kaip valdyti agentą telefonu

Markdown

Kaip į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:

  1. Atidarykite Settings skydelį sparčiuoju klavišu Cmd + , (arba Ctrl + , „Linux“ ir „Windows“ sistemose) arba spustelėkite Settings mygtuką kairiojo skydelio apačioje.
  2. Eikite į skiltį App.
  3. Perjunkite Enable Remote Control į On.
  4. (Pasirinktinai) Nustatykite Nickname, pavyzdžiui, workstation-primary arba server-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ą:

  1. 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.
  2. Prisijunkite naudodami tą pačią Google paskyrą, kurią naudojate kompiuteryje.
  3. Įrenginių perjungiklyje pasirinkite norimą kompiuterį.
  4. 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.

Diagrama: įjungus tą patį paskyros naudojimą, nešiojamojo kompiuterio nuotolinio valdymo jungiklis perduoda valdymą telefonui
Kaip veikia nuotolinis valdymas kompiuteryje: įjunkite jungiklį kompiuteryje, tada telefone prisijunkite naudodami tą pačią Google paskyrą.

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:

VeikimasLinuxmacOSWindows
PaleidimasPaleidus sistemą; prisijungti nereikiaPrisijungusPaleidus sistemą (jei įdiegė administratorius); kitu atveju prisijungus
Veikia atsijungusTaipNe; vėl pasileidžia kitą kartą prisijungusTaip, jei sukonfigūruota paleisti sistemai startuojant
Automatiškai atsikuria po gedimoTaipTaipTaip, 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

KriterijusInteraktyvusis (/remote-control / agy --remote-control)Fone veikiantis demonas (agy remote-control start)
AprėptisViena interaktyvi terminalo sesijaVisas kompiuteris (fone veikianti operacinės sistemos paslauga)
Veikimo trukmėAktyvus, kol įjungtas Remote Control ir veikia terminalo sesijaIš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 pavadinimasNaujas kiekvienai sesijai (pavyzdžiui, host-swift-falcon)Vienas nuolatinis kompiuterio pavadinimas (--name arba cliRemoteControlHostname)
LygiagretumasKelios terminalo sesijos vienu metu viename kompiuteryjeViena demono paslauga vienam kompiuteriui
Tiesioginė nuorodaCLI parodo nuorodą į aktyvų pokalbįPasiekiama per įrenginių perjungiklį adresu antigravity.google.com
Geriausiai tinkaAtsitraukti nuo aktyvios terminalo užduoties ir tęsti ją telefonu ar naršykleNuolat 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.

Diagrama: uždarius terminalą, sesijos tunelis dingsta; fone veikiantis demonas veikia be atidaryto terminalo
CLI režimų skirtumas: interaktyvusis tunelis veikia tik tada, kai terminalas atidarytas; veikiantis be terminalo demonas veikia ir neatidarius terminalo (atsižvelgiant į pirmiau lentelėje nurodytas operacinės sistemos sąlygas).

Ką daryti kilus ryšio problemų

Problemos ir sprendimai pagal oficialią dokumentaciją:

Ką matoteKodėlKą daryti
Remote control is not enabled for your accountJūsų paskyroje arba pagal organizacijos politiką Remote Control funkcija neįjungtaSusisiekite 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 offJei norite, kad kompiuteris liktų pasiekiamas neatidarius terminalo, įdiekite demoną naudodami agy remote-control start
Valdymo skydelyje rodomi keli CLI įrašai iš to paties kompiuterioKiekviena interaktyvi CLI sesija turi savo pagrindinio kompiuterio vardą; tai įprasta, kai atidaryti keli terminalaiNieko daryti nereikia; taip ir turi būti
Kompiuteris nerodomas valdymo skydelyje (demonas)Gali būti, kad kilo CLI prisijungimo problemaVykdykite agy remote-control status; jei rodoma prisijungimo problema, paleiskite agy, prisijunkite iš naujo, tada dar kartą paleiskite agy remote-control start
Pervadinimas neįsigaliojoPavadinimas 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žmezgamasGali būti, kad vis dar užregistruotas senas diegimo scenarijumi įdiegtas demonas ir jis konkuruoja su nauju dėl ryšioDar kartą paleiskite agy remote-control start; senoji paslauga bus pašalinta automatiškai
Valdymo skydelyje rodomi du panašūs to paties kompiuterio įrašaiVienas įrašas priklauso rengyklei, kitas — CLI demonui; jie sąmoningai atskirtiPervadinkite 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 paskyrosPatikrinkite 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.

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.

Visi straipsniai