Sistemas web da sua empresa

Nem todo sistema que sua empresa usa tem integração pronta. ERP antigo, portal do contador, painel de fornecedor, sistema do governo — muitos só existem como site, feitos para uma pessoa abrir no navegador e clicar.

O agente também consegue usar esses sistemas: ele abre a página, lê o que está na tela, preenche campos e clica em botões — como faria um funcionário seu.

O ganho real não é ele fazer isso enquanto você assiste. É você mostrar uma vez o que precisa ser feito e depois agendar: toda segunda de manhã, o agente entra no portal, pega o relatório e te manda — sem ninguém por perto.

O caminho completo

Os passos 1 e 2 acontecem uma vez. Do 3 em diante, é automático.

1. Conectar o sistema

Antes de qualquer coisa, o sistema precisa estar na lista de ferramentas conectadas do seu especialista — é essa lista que autoriza o agente a alcançar aquele endereço. Um site fora dela o agente simplesmente não acessa.

Feito isso, a conexão é uma conversa:

Você: abra o portal.fornecedor.com.br

Agente: Abri o portal, mas caí na tela de login. Você quer que eu entre, ou prefere entrar você mesmo?

A partir daqui há dois caminhos, e a escolha é sobre quem digita a senha.

Caminho A — o agente faz o login

Serve quando o acesso é usuário e senha, sem verificação extra. A senha fica guardada no cofre da sua organização, e o agente a usa sem nunca ver o valor:

Você: pode entrar, o usuário é financeiro@minhaempresa.com.br

Agente: Preciso da senha para guardar no cofre. Vou abrir um campo seguro — o que você digitar ali não passa por mim.

(aparece um campo de senha; você digita e envia)

Agente: Guardado. Entrando… pronto, estou dentro do portal.

O que você digita naquele campo vai direto para o cofre. Ele não aparece na conversa, não é lido pelo agente e não fica no histórico.

Caminho B — você faz o login

Serve quando há duplo fator, código por SMS ou CAPTCHA — coisas que existem justamente para exigir uma pessoa:

Você: prefiro entrar eu mesmo

Agente: Claro. Abri a tela ao vivo aqui do lado. Entre normalmente, com o código do seu aplicativo, e me avise quando estiver dentro.

A tela abre num painel ao lado da conversa, que dá para maximizar — você não sai da página nem abre outra aba. Dentro dele você vê o navegador do agente em tempo real e o comanda assim:

• Clicar — clique (ou toque, no celular) direto na imagem, onde você clicaria de verdade.
• Digitar — o texto não é escrito em cima da imagem. Junto dela há uma caixa de texto: escreva ali e toque em Enviar; o que você escreveu é digitado no campo que estiver em foco na página. Clicar num campo da imagem já leva o cursor para essa caixa, então o caminho natural é clicar no campo e começar a escrever.
• Teclas especiais — ao lado da caixa há botões para Enter, Tab, Esc, Apagar, Del e as setas. São as teclas que um formulário de login precisa e que não se escrevem como texto: Tab pula para o próximo campo, Enter confirma, Apagar corrige.

É assim que você digita o código do segundo fator. Terminado o login, avise o agente na conversa — ele segue dali.

A tela dura cerca de 3 minutos

O painel mostra um contador regressivo e avisa quando o tempo acaba. Ela é curta de propósito: existe para o momento do login, não para acompanhar o agente trabalhando. Se encerrar antes de você terminar, peça outra — o navegador continua exatamente onde estava, você não recomeça do zero.

Depois que a tela é aberta, fica um cartão na conversa com um botão Abrir. Ele mostra uma prévia — um quadro da página que o agente estava vendo — e é por ele que você reabre o painel. Quando a tela já encerrou, o cartão diz isso em vez de mostrar a imagem.

Guardar a sessão

Entrando por A ou por B, o passo final é o mesmo — e é ele que faz o agendamento funcionar depois:

Você: conecte essa ferramenta

Agente: Conectado. Guardei a sessão do portal.fornecedor.com.br no cofre da organização. A partir de agora eu entro nesse sistema já autenticado, inclusive em execuções agendadas.

Isso é feito uma vez por sistema. Nas próximas conversas — e nas execuções automáticas — o agente já entra logado.

2. Mostrar o que precisa ser feito

Aqui não existe "gravar uma macro". Você explica, em português, como explicaria a alguém que acabou de entrar na equipe:

Você: no menu lateral tem "Relatórios". Dentro dele, "Notas do mês". Filtra pelo mês passado e baixa o resumo em PDF.

O agente navega, te conta o que está vendo e pergunta quando algo não bate:

Agente: Entrei em Relatórios. Vejo "Notas do mês", "Notas por fornecedor" e "Conciliação". Sigo em "Notas do mês"?

Essa diferença importa: como é instrução e não gravação de cliques, o procedimento continua valendo quando o site muda de layout. Um botão que mudou de lugar quebra uma macro; não quebra uma instrução.

3. Agendar

Com o sistema conectado e o procedimento acertado, é só pedir:

Você: faz isso todo dia 1º às 8h e me manda o resumo

Na hora marcada o agente executa sozinho, já autenticado, e devolve o resultado pelo canal combinado.

O que o agente sabe fazer numa página

Ação	O que significa na prática
Abrir um endereço	Vai até a página, como digitar a URL no navegador
Ler a tela	Enxerga os textos, campos, botões e links — não o código do site
Extrair um trecho	Puxa só o texto que interessa (uma tabela, um total)
Tirar uma foto da tela	Anexa a imagem na conversa, para você conferir
Preencher um campo	Digita em campos de formulário
Clicar	Aciona botões e links
Abrir a tela ao vivo	Passa o controle para você (CAPTCHA, duplo fator)
Conectar / desconectar	Guarda ou apaga a sessão daquele sistema

Listar as ferramentas no especialista não basta — descreva no prompt quando usá-las. Veja configuração do especialista.

Pedir aprovação antes de ações que mudam dados

Ler é seguro. Emitir, cancelar, aprovar e excluir não são. Se o procedimento inclui uma ação dessas, exija aprovação humana com interrupt_on:

interrupt_on:
  code-workspace-mcp-browser.browser_click:
    allowed_decisions:
      - approve
      - reject
    description: "Clique no sistema do cliente — confirme antes de executar."

Assim o agente pausa e mostra o que vai fazer antes de fazer.

Ação agendada não tem quem aprove

Se um procedimento com interrupt_on rodar num horário agendado, não há ninguém para confirmar e a ação não acontece — por segurança. Agende apenas procedimentos de leitura, ou aceite que a parte que muda dados vai esperar por você.

Quando alguma coisa não funciona

O que você vê	O que está acontecendo	O que fazer
"Esse endereço não está entre as ferramentas conectadas"	O site não está na lista do especialista	Adicione o domínio à lista de ferramentas conectadas
O agente cai na tela de login mesmo já tendo conectado	A sessão expirou no sistema do cliente	Refaça o login e conecte de novo
Conectou, mas continua caindo no login	O sistema usa login unificado de terceiros (entrar com Google, Microsoft, Okta)	Hoje esse caso não é coberto — veja os limites
O CAPTCHA vem impossível — figuras que não batem com a pergunta	O site detecta que é um navegador automatizado e endurece o desafio de propósito	Não é ajustável do nosso lado — veja os limites
A tela ao vivo está lenta	Ela transmite imagens do navegador remoto, quadro a quadro	Use um computador em vez do celular; se persistir, avise o suporte
"O navegador foi reiniciado desde o login"	Passou tempo demais entre o login e a conexão	Entre de novo e conecte logo em seguida, sem intervalo

Encerrar o acesso

Quando o agente não deve mais entrar num sistema:

Você: desconecte o portal.fornecedor.com.br

A sessão guardada é apagada do cofre e a próxima tentativa cai na tela de login. Vale para todas as conversas e para os agendamentos.

Trocou a senha? Conecte de novo

Trocar a senha no sistema não derruba a sessão guardada automaticamente — ela vale enquanto o próprio sistema a considerar válida. Se o acesso mudou de dono, desconecte explicitamente.

Para entender o que fica guardado

A página Como o agente navega explica o que a plataforma guarda, o que nunca guarda e por que a senha não passa pelo agente.