Saltar para o conteúdo principal
A Local Agent Browser CLI agora faz parte da Agent Browser CLI. O pacote npm gologin-local-agent-browser-cli está obsoleto: instale gologin-agent-browser-cli e use --runtime local. Os scripts que chamam gologin-local-agent-browser continuam funcionando; veja Migrar da Local Agent Browser CLI.
A Agent Browser CLI tem dois runtimes com os mesmos comandos. O runtime cloud executa as sessões no Gologin Cloud Browser. O runtime local as executa no Orbita, o navegador do Gologin, na sua própria máquina. Esta página trata do runtime local. Snapshots, refs e os demais comandos funcionam como descrito na página da Agent Browser CLI.

Quando usar local ou cloud


Requisitos

  • Node.js 20 ou superior. O runtime local inicia o Orbita por meio do SDK Node.js do Gologin, que exige o Node.js 20.
  • Um token de API do Gologin em GOLOGIN_TOKEN. Veja Obter um token.
  • Um ID de perfil para cada sessão. Diferentemente do runtime cloud, o runtime local não cria perfis temporários.
  • Orbita. Se ele ainda não estiver instalado, o SDK do Gologin o baixa para ~/.gologin/browser na primeira inicialização. Se o Orbita estiver em outro local, defina GOLOGIN_EXECUTABLE_PATH.

Instalação

O pacote instala dois comandos:
  • gologin-agent-browser executa sessões de navegador na nuvem, a menos que você escolha o runtime local.
  • gologin-local-agent-browser é um alias de compatibilidade que executa comandos no runtime local.

Escolher o runtime local

Passe --runtime local em um comando ou defina o runtime uma única vez para todo o shell:
--local e um local no início do comando também funcionam: gologin-agent-browser local open https://example.com --profile your_profile_id.
Comandos de sessão como snapshot, click e close vão para o runtime cloud, a menos que você escolha o local. Depois de abrir uma sessão local, passe --runtime local em todos os comandos seguintes ou defina GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Comandos da API do Gologin, como api, browser e proxy, sempre chamam a API diretamente, independentemente do runtime.

Variáveis de ambiente

O runtime local mantém sua configuração, a lista de perfis e o histórico de tarefas em ~/.gologin-local-agent-browser/, a mesma pasta usada pela CLI antiga.

Início rápido

--visible (ou --headed) e --headless (ou --background) escolhem o modo de janela para um único open. open-visible e open-background são atalhos para eles.

Comandos de navegador

Os comandos de sessão são os mesmos do runtime cloud: snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload e outros. Veja a referência de comandos. Por enquanto, back, forward e reload funcionam apenas no runtime cloud. find localiza um elemento na página ativa e age sobre ele em uma única etapa. Use-o quando as refs ficarem desatualizadas em páginas dinâmicas:

Comandos de perfil

Estes comandos são executados no runtime local mesmo sem --runtime local: profile-create e profile-update aceitam um modelo por caso de uso e um proxy. --proxy-country us adiciona um proxy do Gologin; --proxy-host com --proxy-port define o seu próprio.

Runbooks e tarefas em lote

Um runbook é um arquivo JSON com uma lista de etapas da CLI:
Execute-o em um perfil ou em vários perfis em paralelo:
targets.json lista os perfis:
Confira os resultados com jobs e job <jobId>. --status aceita running, ok, partial ou failed:

Migrar da Local Agent Browser CLI

  • Os scripts que chamam gologin-local-agent-browser continuam funcionando. O comando agora vem de gologin-agent-browser-cli.
  • Os perfis, a configuração e o histórico de tarefas em ~/.gologin-local-agent-browser/ permanecem onde estão.
  • Para agentes de IA, instale a skill Agent Browser. Ela cobre os dois runtimes, e a skill separada Local Agent Browser está obsoleta.

Relacionado

Pacote npm

gologin-agent-browser-cli

Código-fonte

GologinLabs/agent-browser