Przejdź do głównej treści
Local Agent Browser CLI jest teraz częścią Agent Browser CLI. Pakiet npm gologin-local-agent-browser-cli jest przestarzały: zainstaluj gologin-agent-browser-cli i używaj --runtime local. Skrypty, które wywołują gologin-local-agent-browser, nadal działają, zobacz Migracja z Local Agent Browser CLI.
Agent Browser CLI ma dwa środowiska uruchomieniowe z tymi samymi poleceniami. Środowisko cloud uruchamia sesje w Gologin Cloud Browser. Środowisko local uruchamia je w Orbita, przeglądarce Gologin, na Twoim komputerze. Ta strona opisuje środowisko lokalne. Snapshoty, odwołania (refs) i pozostałe polecenia działają tak, jak opisano na stronie Agent Browser CLI.

Kiedy wybrać local, a kiedy cloud


Wymagania

  • Node.js 20 lub nowszy. Środowisko lokalne uruchamia Orbita przez Gologin Node.js SDK, który wymaga Node.js 20.
  • Token API Gologin w zmiennej GOLOGIN_TOKEN. Zobacz Pobieranie tokena.
  • ID profilu dla każdej sesji. W odróżnieniu od środowiska cloud środowisko lokalne nie tworzy profili tymczasowych.
  • Orbita. Jeśli nie jest jeszcze zainstalowana, Gologin SDK pobierze ją do ~/.gologin/browser przy pierwszym uruchomieniu. Jeśli Orbita znajduje się w innym miejscu, ustaw GOLOGIN_EXECUTABLE_PATH.

Instalacja

Pakiet instaluje dwa polecenia:
  • gologin-agent-browser uruchamia sesje przeglądarki w chmurze, chyba że wybierzesz środowisko lokalne.
  • gologin-local-agent-browser to alias zapewniający zgodność, który uruchamia polecenia w środowisku lokalnym.

Wybór środowiska lokalnego

Dodaj --runtime local do polecenia albo ustaw środowisko raz dla całej powłoki:
Działają też --local oraz local na początku polecenia: gologin-agent-browser local open https://example.com --profile your_profile_id.
Polecenia sesji, takie jak snapshot, click i close, trafiają do środowiska cloud, chyba że wybierzesz local. Po otwarciu sesji lokalnej dodawaj --runtime local do każdego kolejnego polecenia albo ustaw GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Polecenia API Gologin, takie jak api, browser i proxy, zawsze wywołują API bezpośrednio, niezależnie od środowiska.

Zmienne środowiskowe

Środowisko lokalne przechowuje konfigurację, listę profili i historię zadań w ~/.gologin-local-agent-browser/, czyli w tym samym folderze, którego używało stare CLI.

Szybki start

--visible (lub --headed) oraz --headless (lub --background) wybierają tryb okna dla jednego polecenia open. open-visible i open-background to ich skróty.

Polecenia przeglądarki

Polecenia sesji są takie same jak w środowisku cloud: snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload i inne. Zobacz opis wszystkich poleceń. back, forward i reload na razie działają tylko w środowisku cloud. find wyszukuje element na aktywnej stronie i wykonuje na nim akcję w jednym kroku. Używaj go, gdy odwołania (refs) tracą ważność na stronach dynamicznych:

Polecenia profili

Te polecenia działają w środowisku lokalnym nawet bez --runtime local: profile-create i profile-update przyjmują szablon dopasowany do zastosowania oraz proxy. --proxy-country us dodaje proxy Gologin, a --proxy-host z --proxy-port ustawia Twoje własne.

Runbooki i zadania wsadowe

Runbook to plik JSON z listą kroków CLI:
Uruchom go na jednym profilu albo na wielu profilach równolegle:
targets.json zawiera listę profili:
Wyniki sprawdzisz poleceniami jobs i job <jobId>. Opcja --status przyjmuje wartości running, ok, partial lub failed:

Migracja z Local Agent Browser CLI

  • Skrypty, które wywołują gologin-local-agent-browser, nadal działają. Polecenie pochodzi teraz z pakietu gologin-agent-browser-cli.
  • Profile, konfiguracja i historia zadań w ~/.gologin-local-agent-browser/ pozostają na swoim miejscu.
  • Dla agentów AI zainstaluj umiejętność Agent Browser. Obejmuje ona oba środowiska, a osobna umiejętność Local Agent Browser jest przestarzała.

Powiązane

Pakiet npm

gologin-agent-browser-cli

Kod źródłowy

GologinLabs/agent-browser