Blog

Google Antigravity Remote Control: így irányíthatja az ügynököt a telefonjáról

Markdown

A Remote Control bekapcsolása a Google Antigravity asztali alkalmazásában és CLI-jében: a kapcsoló, az agy remote-control daemon és a teendők kapcsolódási problémák esetén.

A teljes cikk elolvasása

Ailoot dokumentációja — referenciaanyagok a szolgáltatás használatához.

Lényeg

Az Antigravity 2.0 asztali alkalmazásában a Remote Control a Settings → App menüpontban található kapcsolóval engedélyezhető. A munkamenethez az antigravity.google.com címen csatlakozhat ugyanazzal a Google-fiókkal. Az Antigravity CLI-nek két módja van: a /remote-control (vagy a --remote-control kapcsoló) alagutat nyit a terminál-munkamenet idejére, míg az agy remote-control start háttérdémont indít nyitott terminál nélkül. Linuxon a démon kijelentkezés után is fut, és újraindítás után is elindul; Windowson ehhez rendszergazdai telepítés szükséges; macOS-en és normál Windows-telepítés esetén a következő bejelentkezéskor indul újra. A számítógépnek bekapcsolva kell lennie, és csatlakoznia kell az internethez. A funkció fiók- vagy szervezeti házirend, illetve csomagfeltételek miatt nem feltétlenül érhető el.

Ha még nem telepítette az Antigravityt, először olvassa el az áttekintést arról, mi a Google Antigravity, és hogyan telepíthető. Ez az útmutató arra az esetre szól, amikor egy ügynök már egy hosszú feladaton dolgozik (refaktorálás, tesztek futtatása, függőségek migrálása), Önnek pedig el kell távolodnia az asztalától, miközben továbbra is irányítani szeretné a munkamenetet.

Mi a Remote Control, és miért van rá szüksége?

A Remote Control a Google Antigravity olyan funkciója, amellyel biztonságosan csatlakozhat a gépein futó asztali és CLI-munkamenetekhez, és bármely webböngészőből vezérelheti őket. A hivatalos leírás szerint a nagy feladatok — például egy teljes alrendszer refaktorálása, egy hosszú tesztfuttatás vagy egy összetett függőségmigráció — sokáig tarthatnak. A Remote Control lehetővé teszi a munkamenet kezelését a számítógépétől távol is, miközben a teljes fejlesztői környezet helyben marad.

A funkció az asztali alkalmazás 2.0-s verziójában és a CLI-ben, vagyis az Antigravity terminálos változatában (agy) is működik, de a bekapcsolása és működése eltérő.

A Remote Control bekapcsolása az Antigravity 2.0 asztali alkalmazásában

A Remote Controlt az alkalmazás beállításaiban engedélyezheti:

  1. Nyissa meg a Settings panelt a Cmd + , billentyűkombinációval (Linuxon és Windowson: Ctrl + ,), vagy kattintson a bal oldali panel alján található Settings gombra.
  2. Lépjen az App szakaszba.
  3. Állítsa az Enable Remote Control kapcsolót On állásba.
  4. (Nem kötelező) Adjon meg egy Nickname nevet, például workstation-primary vagy server-machine értéket, hogy könnyen felismerje ezt a gépet a csatlakoztatott eszközök listájában.

Csatlakozás telefonról vagy másik böngészőből

Távoli munkamenet megnyitásához:

  1. Nyisson meg egy böngészőt bármely eszközön, és lépjen az Antigravity Remote Control irányítópultra. Telefonon a webalkalmazást a kezdőképernyőre is telepítheti, így push értesítéseket kaphat, amikor az ügynök befejez egy feladatot, vagy választ kér Öntől.
  2. Jelentkezzen be ugyanazzal a Google-fiókkal, amelyet az asztali alkalmazásban használ.
  3. Válassza ki a kívánt gépet az eszközváltóban.
  4. Csatlakozás után megtekintheti az aktív beszélgetéseket; új feladatokat indíthat az ügynöknek, és megtekintheti a megvalósítási terveket és az eredményeket.

Ha a gép nem jelenik meg a webes felületen, a hivatalos útmutató szerint három dolgot ellenőrizzen: az Antigravityt futtató számítógépen be van kapcsolva az Enable Remote Control kapcsoló; a számítógép csatlakozik az internethez, és nem lépett alvó állapotba; valamint az asztali alkalmazásban és a böngészőben ugyanazt a Google-fiókot használja.

Ha átmenetileg megszakad a hálózati kapcsolat azon az eszközön, amelyről csatlakozni próbál, a webes felület megkísérli az automatikus újracsatlakozást. Az Antigravityt futtató számítógépen a háttérfeladatok és a terminálból indított parancsok megszakítás nélkül futnak tovább, amíg a gép csatlakozik az internethez.

Ábra: a laptopon bekapcsolt Remote Control kapcsoló átadja az irányítást a telefonnak, ha ugyanazzal a fiókkal jelentkezik be
Így működik az asztali Remote Control: kapcsolja be a kapcsolót a számítógépen, majd jelentkezzen be a telefonon ugyanazzal a Google-fiókkal.

Az Antigravity CLI Remote Control-módjai

A CLI-nek két módja van: egy adott terminálfolyamathoz kötött interaktív mód, valamint egy háttérben futó, headless démon, amely nyitott terminál nélkül is működik.

Interaktív mód: /remote-control

Az aktuális interaktív agy-munkamenetben a CLI újraindítása nélkül is bekapcsolhatja a Remote Controlt. Futtassa ezt a bemeneti sorban:

/remote-control

A hivatalos leírás szerint a CLI kapcsolatot — egy fordított alagutat — nyit az aktuális munkamenethez, majd kiírja a gépnevet és az aktív beszélgetés hivatkozását egy másik eszközön való folytatáshoz:

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.

Nyissa meg ezt a hivatkozást egy laptop, táblagép vagy telefon böngészőjében, jelentkezzen be ugyanazzal a Google-fiókkal, amelyet a CLI-ben használ, majd folytassa a munkát a munkamenetben az Antigravity webes felületén.

Az alagút kikapcsolásához a helyi terminál-munkamenet lezárása nélkül:

/remote-control off

A CLI indításakor már bekapcsolt Remote Control mellett is elindíthatja a programot egy kapcsolóval:

agy --remote-control

Az interaktív mód az agy folyamathoz kötődik: amikor kilép a CLI-ből (/exit, Ctrl+C, Ctrl+D), vagy bezárja a terminálablakot, a Remote Control-alagút automatikusan megszakad, és a munkamenet bejegyzése eltűnik az irányítópultról. Minden interaktív CLI-folyamatnak saját munkamenet-azonosítója és gépneve van, ezért egyszerre több terminálfülön vagy munkakönyvtárban is futtathatja az agy --remote-control parancsot.

Amikor böngészőből csatlakozik egy interaktív CLI-munkamenethez, a két oldal valós időben szinkronizál. A távoli eszközről érkező kérések egyenesen a helyi terminálhoz jutnak, miközben az ügynök gondolatmenete, eszközhívásai és kódmódosításai láthatók a távoli felületen. Ha az ügynök megerősítést kér (y/n), vagy további kérdést tesz fel, telefonjáról vagy a helyi terminálról is válaszolhat. A beállítások kivételt jelentenek: ezeket nem módosíthatja a távoli webes felületen, csak magában a CLI-ben.

Headless démon: agy remote-control start

A második mód egy állandó háttérdémon, amely operációsrendszer-szolgáltatásként regisztrálja magát. Amíg a gép be van kapcsolva és csatlakozik az internethez, elérhető; a kijelentkezés és újraindítás utáni működése platformfüggő.

agy remote-control start

A démon operációsrendszer-szolgáltatásként regisztrál (Linuxon systemd user service-ként, macOS-en LaunchAgentként, Windowson pedig Scheduled Taskként), és azonnal elindul, nyitott terminálablak nélkül.

Az agy remote-control status paranccsal megnézheti a bejegyzés nevét. Ezután válassza ki ezt a gépet az Antigravity Remote Control irányítópulton, és folytassa a munkát az Antigravity webes felületén.

A démont három paranccsal vezérelheti:

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

A démon a CLI-be való bejelentkezéshez használt hitelesítő adatokat használja. A CLI-be való bejelentkezés külön művelet attól, hogy ugyanazon a gépen bejelentkezik az Antigravity asztali szerkesztőjébe; a böngészőben a CLI-ben használttal azonos Google-fiókkal jelentkezzen be.

A headless démon gépnevét indításkor a --name kapcsolóval állíthatja be:

agy remote-control start --name "my-workstation"

Ha új értékkel ismét futtatja a start --name parancsot, átnevezi a gépet.

Ha nem ad meg nevet, a démon az első indításkor egy könnyen megjegyezhető nevet generál (például my-machine-distant-plume); az aktuális nevet az agy remote-control status jeleníti meg. A beállításfájlban is átnevezheti: nyissa meg Linuxon/macOS-en a ~/.gemini/config/config.json, Windowson pedig a %USERPROFILE%\.gemini\config\config.json fájlt, módosítsa a cliRemoteControlHostname értékét, mentse a fájlt, majd futtassa újra az agy remote-control start parancsot a démon újraindításához. Az új név a szolgáltatás újraindulása után jelenik meg az irányítópulton; a fájl módosításai futó démon esetén nem lépnek életbe.

A fájlban két hasonló mező található. A cliRemoteControlHostname az itt tárgyalt CLI-démon neve. A remoteControlHostname külön mező az ugyanazon a gépen futó Antigravity asztali szerkesztőhöz; az Antigravity 2.0-ban a Settings → App menüpontban módosíthatja.

A démon működése kijelentkezés és újraindítás után

A működés az operációs rendszertől függ:

MűködésLinuxmacOSWindows
IndulásRendszerindításkor; bejelentkezés nem szükségesBejelentkezéskorRendszerindításkor (ha rendszergazda telepítette); egyébként bejelentkezéskor
Kijelentkezés után futIgenNem; a következő bejelentkezéskor indul újraIgen, ha rendszerindításkori indulásra van beállítva
Hiba után automatikusan helyreállIgenIgenIgen, legfeljebb három újraindítási kísérletig, majd a következő rendszerindításkor vagy az agy remote-control start újbóli futtatásakor

Windows-specifikus részletek

A démon rendszerindításkori automatikus elindulásához rendszergazdaként kell regisztrálni. Használhat PowerShellt vagy a szokásos parancssort. A start parancs normál ablakból is működik, de kijelentkezés vagy újraindítás után a démon csak a következő bejelentkezéskor, nem pedig rendszerindításkor indul újra. A status és stop parancs normál ablakból, emelt jogosultság nélkül is működik.

Melyik módot válassza?

SzempontInteraktív (/remote-control / agy --remote-control)Headless démon (agy remote-control start)
HatókörEgy interaktív terminál-munkamenetAz egész gép (háttérben futó operációsrendszer-szolgáltatás)
ÉletciklusAmíg a Remote Control engedélyezve van és fut a terminál-munkamenetKijelentkezést és újraindítást túléli Linuxon, valamint Windowson rendszergazdai telepítés esetén; macOS-en és normál Windows-telepítés esetén a következő bejelentkezéskor indul újra
Bejegyzés neveMunkamenetenként új (például host-swift-falcon)Egy állandó gépnév (--name vagy cliRemoteControlHostname)
PárhuzamosságEgyszerre több terminál-munkamenet egy gépenGépenként egy démon-szolgáltatás
Közvetlen hivatkozásA CLI kiír egy hivatkozást az aktív beszélgetéshezHozzáférés az antigravity.google címen található eszközváltón keresztül
Mikor célszerűHa eltávolodna egy aktív terminálfeladattól, és telefonról vagy böngészőből folytatnáTartós távoli hozzáférés munkaállomáshoz vagy szerverhez, amíg a gép be van kapcsolva és csatlakozik az internethez, az operációs rendszer feltételeitől függően

Az interaktív mód elegendő ahhoz, hogy telefonjáról kezelje az aktuális feladatot. Ha nyitott terminál nélkül van szüksége távoli hozzáférésre, az operációs rendszer feltételeitől függően használja a headless démont.

Ábra: a munkamenet-alagút eltűnik, amikor bezárják a terminált; a háttérben futó démon nyitott terminál nélkül működik
A CLI-módok közötti különbség: az interaktív alagút csak addig fut, amíg nyitva van a terminál; a headless démon nyitott terminál nélkül fut (a fenti táblázatban szereplő operációsrendszer-feltételek mellett).

Teendők kapcsolódási problémák esetén

A hivatalos dokumentációban szereplő problémák és megoldások:

Mit látMiértTeendő
Remote control is not enabled for your accountA fiók vagy a szervezeti házirend nem engedélyezte a Remote Control funkciótLépjen kapcsolatba a munkaterület rendszergazdájával, vagy ellenőrizze, hogy a csomagja támogatja-e a Remote Controlt
Eltűnik a bejegyzés az irányítópultról (CLI)A /remote-control és az agy --remote-control olyan alagutakat hoz létre, amelyek automatikusan megszakadnak, amikor kilép az interaktív munkamenetből (/exit, Ctrl+C), vagy futtatja a /remote-control off parancsotHa azt szeretné, hogy a gép nyitott terminál nélkül is elérhető legyen, telepítse a headless démont az agy remote-control start paranccsal
Több CLI-bejegyzés jelenik meg ugyanarról a gépről az irányítópultonMinden interaktív CLI-munkamenetnek saját gépneve van; több nyitott terminál esetén ez normálisNincs teendő; ez a várt működés
A gép nem jelenik meg az irányítópulton (démon)Probléma lehet a CLI-be való bejelentkezésselFuttassa az agy remote-control status parancsot; ha bejelentkezési problémát jelez, futtassa az agy parancsot, jelentkezzen be újra, majd futtassa ismét az agy remote-control start parancsot
Az átnevezés nem lépett érvénybeA démon induláskor olvassa be a nevetIndítsa újra a démont az agy remote-control start ismételt futtatásával
Windowson a démon csak bejelentkezéskor indul el, rendszerindításkor nemA start parancsot rendszergazdai jogosultság nélkül futtattákFuttassa újra az agy remote-control start parancsot egy emelt jogosultságú ablakból
A kapcsolat folyamatosan megszakad, majd újracsatlakozikElőfordulhat, hogy egy telepítőszkripttel telepített régi démon még regisztrálva van, és verseng az újjal a kapcsolatértFuttassa újra az agy remote-control start parancsot; a régi szolgáltatás automatikusan eltávolításra kerül
Két hasonló bejegyzés jelenik meg ugyanahhoz a géphez az irányítópultonAz egyik a szerkesztőé, a másik a CLI-démoné; szándékosan különállókNevezze át azt, amelyiket meg szeretné különböztetni
A gép nem jelenik meg a webes irányítópulton (asztali alkalmazás)Lehet, hogy ki van kapcsolva a kapcsoló, nincs internetkapcsolat, a számítógép alvó állapotban van, vagy különböző Google-fiókokat használEllenőrizze az Enable Remote Control kapcsolót, a számítógép internetkapcsolatát, hogy nincs-e alvó állapotban, valamint hogy mindkét oldalon ugyanazt a fiókot használja-e

Részletesebb hibakereséshez ellenőrizze a démon naplóit: Linuxon futtassa a journalctl --user -u antigravity-cli-daemon -n 50 parancsot; macOS-en nézze meg a ~/Library/Logs/antigravity-cli-daemon.log fájlt; Windowson pedig a %USERPROFILE%\.gemini\antigravity-cli\log mappában keresse meg a legújabb cli-*.log fájlt.

A headless démon nyitott terminál nélkül is hozzáférést biztosít, többek között akkor is, amikor távol van, a számítógép és az operációs rendszer működési feltételeitől függően. Ha már nincs szüksége állandó hozzáférésre, állítsa le a démont az agy remote-control stop paranccsal.

Külön cikk szól a Claude Code távoli vezérléséről. Ha egy másik ügynököt Telegramon keresztül szeretne irányítani, olvassa el a Hermes Agent beállítását Telegramban.

Mi következik?

Ha a CLI-ben dolgozik, és szeretne eltávolodni az aktuális feladattól, kezdje az interaktív móddal. Hagyja nyitva a terminált: ha bezárja, az alagút megszakad, és a munkamenet bejegyzése eltűnik az irányítópultról. Ha nyitott terminál nélkül szeretné elérni a gépet, használja a démont az operációs rendszer korlátozásainak figyelembevételével.

További anyagokat az Ailoot oldalán talál.

További részletek

Kérdések és válaszok: Google Antigravity Remote Control: így irányíthatja az ügynököt a telefonjáról

Miért tűnik el a távoli munkamenet a terminál bezárásakor?

Az interaktív Remote Control a futó agy folyamathoz tartozik, ezért a kilépés lezárja az alagutat. Nyitott terminál nélküli hozzáféréshez a headless daemont használja, és ellenőrizze az operációs rendszer indulási feltételeit.

Mit nézzek meg, ha a gép hiányzik a dashboardról?

A gép legyen ébren és online, a Remote Control engedélyezett, a böngésző pedig ugyanazt a Google-fiókot használja, mint az asztali alkalmazás vagy CLI. Daemonnál az agy remote-control status alatt vizsgálja a belépési vagy szolgáltatáshibát.

Összes cikk