Ferramenta de Navegador

Automação Chrome com sessões de login persistentes. Faça login uma vez e o agente pode navegar em sites autenticados em seu nome.

Binários Pré-compilados

Se você instalou via script de uma linha ou Homebrew, a ferramenta de navegador já está incluída. Basta habilitá-la no config.toml abaixo. A feature flag só é necessária ao compilar a partir do código-fonte.

Início Rápido

Dois passos para o agente começar a navegar com suas sessões de login:

1. Faça login nos seus serviços

bash

aidaemon browser login

O Chrome abre com um perfil dedicado. Faça login nos serviços que você quer que o agente acesse (Gmail, GitHub, AWS Console, Jira, etc.), depois feche o Chrome. Suas sessões são salvas em ~/.aidaemon/chrome-profile/ e persistem entre reinicializações.

2. Habilite a ferramenta de navegador

config.toml

[browser]
enabled = true

Pronto. O agente agora pode navegar em sites autenticados usando suas sessões salvas.

Experimente

Envie ao agente uma mensagem como "Acesse https://mail.google.com e tire uma captura de tela" — ele deve mostrar sua caixa de entrada, já conectado.

Configuração

Key	Type	Default	Description
`enabled`	bool	`false`	Habilitar a ferramenta de navegador
`headless`	bool	`true`	Executar Chrome sem janela visível
`screenshot_width`	int	`1280`	Largura do viewport do navegador em pixels
`screenshot_height`	int	`720`	Altura do viewport do navegador em pixels
`user_data_dir`	string	`~/.aidaemon/chrome-profile`	Diretório do perfil Chrome para sessões persistentes
`profile`	string	`Default`	Nome do perfil Chrome dentro do user_data_dir
`remote_debugging_port`	int	`null`	Conectar a uma instância Chrome existente nesta porta (avançado)

Configuração mínima

config.toml

[browser]
enabled = true

Todo o resto possui padrões sensatos. As sessões são automaticamente salvas em ~/.aidaemon/chrome-profile/.

Ações

Ação	Parâmetros	Descrição
`navigate`	`url`	Navegar para URL, aguardar 2s para carregamento da página
`screenshot`	`selector?`	Captura de tela PNG da página inteira ou elemento específico
`click`	`selector`	Clicar em um elemento por seletor CSS
`fill`	`selector, value`	Digitar texto em um campo de formulário
`get_text`	`selector?`	Extrair conteúdo de texto de um elemento ou da página inteira
`execute_js`	`script`	Executar JavaScript arbitrário e retornar o resultado
`wait`	`selector, timeout_secs?`	Aguardar um elemento aparecer (timeout padrão 10s)
`close`	—	Fechar a sessão do navegador

Persistência de Sessão

A ferramenta de navegador usa um perfil Chrome dedicado em ~/.aidaemon/chrome-profile/ que armazena cookies, local storage e sessões de login. Isso significa:

Faça login uma vez via aidaemon browser login, as sessões persistem indefinidamente
O agente inicia o Chrome headless com este perfil — já autenticado
As sessões sobrevivem a reinicializações do aidaemon e do sistema
Execute aidaemon browser login novamente a qualquer momento para adicionar novos serviços ou renovar sessões expiradas

Isolado do Chrome Pessoal

O agente usa seu próprio perfil Chrome, completamente separado do seu navegador pessoal. Seus favoritos, extensões e sessões pessoais nunca são tocados.

Modos de Implantação

Instância isolada (recomendado)

Ao executar o aidaemon em um servidor ou VM dedicado, nenhum outro Chrome está em execução. O agente inicia e controla o Chrome diretamente.

bash

# SSH into your instance
ssh user@my-server

# One-time: log into services
aidaemon browser login

# Config
# [browser]
# enabled = true

# Done — agent handles Chrome automatically from here

Para servidores headless, use SSH com encaminhamento X (ssh -X) ou VNC para o login inicial.

Computador pessoal

Ao executar o aidaemon junto com seu Chrome pessoal, o agente inicia uma instância Chrome separada com seu próprio perfil. Ambos funcionam lado a lado sem conflito.

bash

# Same setup — separate Chrome instance, no conflict
aidaemon browser login

# Your personal Chrome (47 tabs, extensions, bookmarks) → untouched
# Aidaemon's Chrome (~/.aidaemon/chrome-profile/) → isolated

Avançado: Conectar a um Chrome existente

Para usuários avançados que desejam conectar a uma instância Chrome já em execução com uma porta de depuração remota:

config.toml

[browser]
enabled = true
remote_debugging_port = 9222

Inicie o Chrome com --remote-debugging-port=9222 e o agente se conecta diretamente. Isso compartilha as sessões da instância Chrome, mas requer que o Chrome seja iniciado com a flag de depuração.

Capturas de Tela

As capturas de tela são capturadas como PNG e enviadas ao usuário pelo canal ativo (foto no Telegram, upload de arquivo no Slack, etc.) com legendas descrevendo a URL da página.

Casos de Uso

Monitoramento — Verificar dashboards (Grafana, Vercel, AWS Console), capturar status de implantação
Extração de dados — Coletar dados de páginas renderizadas com JS, extrair relatórios de painéis administrativos
Automação de fluxos de trabalho — Preencher formulários, navegar fluxos de múltiplas etapas em ferramentas internas
Testes — Navegar pelo seu aplicativo implantado, verificar UI, checar layouts responsivos
Navegação autenticada — Interagir com qualquer serviço no qual você fez login, sem necessidade de chaves de API

Compilando a Partir do Código-Fonte

A ferramenta de navegador requer a feature flag browser:

bash

cargo build --release --features browser

Requer um navegador baseado em Chromium instalado (Chrome, Chromium, Brave ou Edge).

AnteriorFerramenta de Gerenciamento de Configuração PróximoCriação de Sub-Agentes