Trabalhador digital

Pequenos negócios têm muita rotina web em sistemas que não têm e nunca terão API: confirmar reservas no painel da plataforma, transferir os mesmos dados para formulários de fornecedores, marcar sempre a mesma coisa no painel do parceiro. Não dá para construir uma integração ali — mas dá para colocar um trabalhador ali.

Trabalhador digital é um executor de IA que faz essa rotina no seu próprio navegador, sob a sua própria conta. O modelo é simples: a extensão no navegador são as mãos, a nuvem é a cabeça. O trabalhador dá um passo de cada vez, e quem decide o que fazer em seguida é o servidor.

Abrir: Painel de administração → Trabalhador digital (admin.cenaly.com/digital-worker). A seção vem desativada por padrão — ative o cartão "Trabalhador digital" na loja de extensões.

O que é isso#

A seção é conduzida pelo proprietário e pelo gerente. Os fusíveis — botão de parada e lista de domínios proibidos — são só do proprietário; o gerente vê no lugar deles uma explicação e o botão "Pedir ao proprietário".

O que é preciso para começar#

Passo 1. Consentimento: o que exatamente vai acontecer#

A primeira tela da seção não é uma lista de trabalhadores, mas um consentimento: "Antes de começar: o que exatamente acontece". Enquanto ele não for aceito, a lista de personas não aparece de jeito nenhum, e também não dá para conectar o navegador. O que ele diz:

• no seu navegador, sob a sua conta, vai atuar a nossa extensão — tudo o que ela abre e faz é executado em seu nome;
• o trabalhador vive sobre a sessão que já está aberta: ele não descobre logins e senhas dos sistemas de destino, e nós não os armazenamos nem os transmitimos;
• o trabalho é visível e pode ser interrompido a qualquer momento — tanto pela seção quanto pela própria máquina;
• o trabalhador nunca contorna captcha, autenticação de dois fatores e proteção contra bots; habilidades que precisassem disso nós não lançamos.

Se o texto do consentimento for atualizado, será pedido que você o confirme de novo — isso não é uma falha.

Etapa 2. O trabalhador e o navegador dele#

1. «Criar trabalhador» — o nome é livre («Notebook da Masha», «Assistente de reservas»); o nome é editado no próprio lugar ✎ e não influencia nada além da legenda.
2. «Conectar dispositivo» → «Computador» — a janela modal começa na etapa 0: escolha o navegador no qual você está instalando a extensão (já vem selecionado aquele em que o painel administrativo está aberto) e siga as etapas dele — baixar o arquivo, abrir a página de extensões, ativar o «Modo de desenvolvedor» e clicar em «Carregar sem compactação». As etapas e o endereço são próprios de cada navegador — veja a tabela abaixo. Ao lado está a política de privacidade da extensão.
3. Na janela modal aparecem o código do par e a string de conexão (nela estão tanto o código quanto o endereço do seu ambiente) mais o mesmo QR — fotografe com o celular para transferir para outro computador. Cole a string na extensão.
4. A janela modal detecta a conexão sozinha e troca o código pelo texto verde «Conectado: …». O código é de uso único e de curta duração — depois disso ele já foi consumido.

No que os navegadores diferem na etapa 0. Não dá para abrir a página interna do navegador por link, por isso o endereço na janela modal vem com o botão «Copiar» — cole-o na barra de endereços. Descompacte o arquivo em uma pasta que você não vai excluir: o navegador carrega a extensão diretamente dela.

No cartão do trabalhador dá para ver: navegadores pareados (cada um pode ser revogado), o status «Conectado / Desconectado», o status ao vivo — livre, trabalhando, precisa de você, em pausa — e o contador «tarefas em andamento: N». Em vermelho fica destacado exatamente um estado: «precisa de você». O mesmo número fica vermelho no item da seção no menu.

Para cada navegador é indicada a versão da extensão. Se ela estiver desatualizada, ao lado está escrito «atualize» — e logo ali estão os links para a nova versão e para as instruções (como atualizar a extensão).

O painel do trabalhador pode ficar fixado como aba ou como painel lateral do Chrome — botões na janela da extensão; a escolha é memorizada, e o painel abrirá do mesmo jeito após a notificação e ao iniciar o navegador. Se o painel foi fechado, o status mostra «Painel do trabalhador fechado — abra a extensão» — isso não é uma pausa do proprietário, basta abrir o painel de novo.

O trabalhador pode ser colocado em pausa ou revogado — a revogação é irreversível e desliga instantaneamente todos os navegadores dele. Os revogados não se acumulam na lista: eles ficam em um bloco recolhido «Revogados (N)», e cada um pode ser removido com o botão «Ocultar» (as execuções e a correspondência permanecem).

Como atualizar a extensão#

Se para o navegador estiver escrito «atualize» (na aba «Dispositivos» e no cartão do dispositivo), ao lado há dois links: «Baixar versão …» — o pacote da nova versão para o navegador deste dispositivo — e «Como atualizar» — esta seção. A extensão antiga não quebra o trabalho em silêncio: a habilidade que precisa da nova versão simplesmente não é entregue a ela, o painel mostra «Atualize a extensão», e a tarefa para com a mensagem «a extensão no navegador está velha demais para esta habilidade».

Chrome, Edge, Yandex Browser, Opera, Brave, Vivaldi — a extensão do arquivo não se atualiza sozinha:

1. Baixe o arquivo pelo link «Baixar versão …» (o mesmo arquivo está na janela modal «Conectar dispositivo»).
2. Descompacte-o na mesma pasta da qual o navegador carrega a extensão, substituindo os arquivos.
3. Abra a página de extensões (chrome://extensions, edge://extensions, browser://extensions etc. — endereços na tabela acima) e clique em ↻ no cartão da extensão «Trabalhador digital» (ou em «Atualizar» no topo da página no modo de desenvolvedor). A extensão será reiniciada com a nova versão, a conexão e as senhas salvas dos painéis administrativos permanecerão.

Firefox — baixe o novo pacote .xpi e carregue-o do mesmo jeito que na primeira vez: about:debugging → «Este Firefox» → «Carregar add-on temporário…». Se a extensão pedir o código — conecte-a de novo.

Se no cartão do dispositivo estiver dito que a extensão foi instalada pela sua organização ou que ela é mantida pela ponte, quem a atualiza é quem a instalou: esse dispositivo não tem link para o arquivo.

Etapa 3. De onde vêm as habilidades#

Habilidade pronta da loja. No cartão da categoria "Trabalhador digital" na loja de extensões, abre-se um assistente de instalação: para qual dos trabalhadores estamos instalando, com quais parâmetros (eles irão para o formulário do sistema de terceiros) e o consentimento explícito com a classe de risco. Habilidades prontas da plataforma ainda são poucas — esta é uma seção jovem, e o caminho principal hoje é o segundo.

Aprendizado por demonstração. Você mostra a rotina uma vez com suas próprias mãos, e o sistema monta um cenário a partir disso:

1. Dê um consentimento separado para a gravação ("Permitir aprendizado"): a gravação ocorre apenas enquanto o REC estiver aceso; senhas e campos ocultos não são gravados por construção; o áudio das suas explicações vai para o servidor apenas para transcrição.
2. Clique em gravar no painel do trabalhador no navegador e execute a operação, podendo comentar em voz alta.
3. Na seção, aparece uma sessão de aprendizado com as etapas "exportação → transcrição → análise", e dela surge um rascunho de habilidade.
4. Abra o rascunho: parâmetros (parte deles "da voz"), regras, passos em palavras humanas, avisos do linter e perguntas da análise — o que ficou incompreensível. A resposta remonta o rascunho; as mesmas perguntas o trabalhador pode fazer no chat.
5. Teste pela escada de confiança — não se pode pular degrau: "Execução em sombra" (não altera nada, informa "eu clicaria aqui") → "A dois" (o trabalhador destaca o alvo, você clica, ele confere) → "Sob supervisão" (faz sozinho, mas pergunta a cada ação).
6. "Em produção" — abre-se a janela de aceite de responsabilidade: você confirma com marcações separadas que tem o direito de agir nessas contas, que respeita as regras das plataformas, que não contorna proteções, que é responsável pelos dados inseridos, que o percurso é seu e que a plataforma pode interromper a habilidade por reclamação fundamentada. Depois disso, o rascunho se torna uma habilidade pessoal da sua conta — para outros ela não é visível.

O percurso quebrou no site ao vivo — o trabalhador mesmo pedirá para mostrar a rotina de novo; no assistente há "Precisa de nova gravação" para isso.

Quando o site mudou. Se o botão ou campo necessário não estiver no lugar, o trabalhador não desiste de imediato: ele observa quais elementos semelhantes existem na página e escolhe uma substituição — primeiro pelo nome do elemento registrado durante o aprendizado, depois com ajuda do modelo (ele escolhe entre o que foi encontrado, não inventa). A substituição para verificação ("aguardar o elemento") ele aplica sozinho e confere na hora. A substituição para ação — entrada ou clique — ele primeiro acorda: no canal do trabalhador chega a pergunta "sim / não", e no cartão da execução, os botões "Aceitar substituição" e "Este não é o elemento"; na fila de tarefas aparece a linha "elemento mudou de lugar — aprove a substituição". A substituição aceita é memorizada, e as execuções seguintes seguem por ela sem perguntas e sem consultar o modelo. Da mesma forma, o trabalhador memoriza suas decisões por passos: situação igual — mesma resposta sem nova chamada ao modelo. Tudo isso é desligado pelo interruptor do proprietário "Aprendizado em exceções" nos fusíveis (o que foi aprendido não é apagado; para apagar — "Esquecer o aprendido" no cartão da habilidade).

No cartão do trabalhador, as habilidades instaladas ficam no bloco "Habilidades": nome, versão, classe de risco, chip de saúde do mapa (aparece quando, na última semana, houve falhas nos elementos da página). Os botões da linha — "Executar agora", "Execução de teste", "Alterar parâmetros", o interruptor "ativado", "Excluir" e "Agendamento".

Etapa 4. Delegar uma tarefa e ver o trabalho#

As tarefas são delegadas por texto no chat de trabalho: no canal do trabalhador ("delegar ao trabalhador") você escreve o que precisa ser feito — e recebe a réplica "aceitei: …", que se torna a raiz da ramificação com o status da tarefa. Os relatórios por passos se acumulam sob ela em um acordeão recolhido, para que o agendamento a cada 15 minutos não transforme o canal em um feed de cem réplicas.

O que acontece é visível na aba "Tarefas" (?tab=runs):

• Status em palavra humana: na fila · trabalhando · aguardando sua resposta · aguardando você · concluído · falha · cancelado · resultado desconhecido.
• Quem delegou, de onde veio a tarefa (do chat, por agendamento, do admin, execução de teste) e o prazo "geralmente ~N minutos" — a mediana das execuções concluídas dessa mesma habilidade (com uma ou duas execuções, o prazo não é prometido).
• O filtro "Requerem atenção" fica em primeiro e mostra exatamente as tarefas em que o trabalhador está parado esperando uma pessoa.
• Ações da linha: "Abrir execução", "Abrir no chat" e "Cancelar" (nas não concluídas, com confirmação — o passo iniciado será abandonado).

O cartão da execução responde à pergunta "o que ele está fazendo agora e por que parou": a posição "passo 3 de 7", a linha do tempo do percorrido, o passo atual, "O que o trabalhador coletou" (campos semelhantes a senhas e códigos são removidos pelo servidor antes do envio) e o motivo da parada em palavras — "o mapa do site está desatualizado, mostre o percurso de novo", "o captcha atrapalha", "a sessão caiu", "cliquei, mas não vi a confirmação — verifique manualmente". Ali também estão os botões "Pronto, continue" (depois que você resolveu o captcha ou entrou no site) e "Repetir tarefa" — uma nova tarefa com os mesmos parâmetros.

Se o trabalhador esbarra em uma pessoa, ele não fica em silêncio: o navegador mostra uma notificação do sistema operacional com o botão "Abrir painel" e lembra a cada cinco minutos, e a linha "o trabalhador aguarda você" aparece na fila geral de tarefas — no mesmo lugar onde ficam os pedidos e as reservas.

Etapa 5. Confirmação do irreversível#

Onde a ação não pode ser desfeita, o trabalhador para e pergunta. A pergunta chega como um cartão no chat: um resumo dos fatos, o prazo de resposta e os botões "Sim" / "Não". Se for uma lista de linhas, as linhas vêm com caixas de seleção e um botão "Confirmar selecionadas". A resposta vai para o canal como uma réplica comum em seu nome — a decisão antes de uma ação irreversível precisa ficar na conversa, com autor e horário.

O próprio "sim" não é uma palavra, mas um conjunto de quatro verificações:

Quem pode o quê depende da classe de risco, não do botão:

A última célula é a regra dos quatro olhos: quem já decidiu "precisa ser feito" relê o próprio pedido na diagonal.

Etapa 6. Agendamento e proteções#

O agendamento é definido por três formatos em vez de uma expressão cron: "a cada N minutos", "todos os dias às HH:MM", "nos dias selecionados às HH:MM". O horário é o do estabelecimento selecionado. O horário indicado é a mediana, não um despertador: a variação na partida é obrigatória e não pode ser desligada, só estreitada — um trabalhador que começa exatamente às 09:00:00 é reconhecido por qualquer análise do outro lado à primeira vista. Há as "horas silenciosas": um disparo que cai nessa janela é adiado para o fim dela.

A classe de risco decide o que é possível: a vermelha não tem formato de agendamento nenhum (só execução na sua presença), a amarela tem um formato que avisa que o plano de fundo aqui funciona sem você e o risco é seu. Um período frequente demais não será aceito — cada classe tem o seu mínimo. Um agendamento que tem três falhas seguidas se desliga sozinho e avisa sobre isso; uma skill desligada ou removida apaga os seus agendamentos, mas não os exclui — se você devolver a skill, basta ligá-la no interruptor.

Proteções (proprietário):

• "Parar todos os trabalhadores" — um botão de emergência para toda a conta: todos os trabalhadores param de uma vez, as tarefas não se perdem, mas esperam na fila até a parada ser removida.
• "Domínios proibidos" — uma lista de hosts para onde o trabalhador não vai, independentemente do que esteja declarado na skill. Ela é mais forte que a própria skill e não se resolve reinstalando-a.

Limitações#

• Chrome e navegadores baseados nele, Firefox — e somente em um computador ligado. A extensão ainda é instalada manualmente no modo desenvolvedor — ainda não houve publicação na Chrome Web Store. No Firefox, o pacote ainda não é assinado pela Mozilla e dura até reiniciar o navegador; o Яндекс Браузер no Windows desliga essa extensão a cada inicialização (ative em browser://tune); o Safari ainda não é suportado. A extensão não tem scanner de QR próprio: o QR é necessário para transferir a linha de conexão para outra máquina.
• A seção é nova. Há poucas skills prontas da plataforma no catálogo, e o efeito "quantas horas economiza" nós honestamente não medimos. O caminho real hoje é o ensino por demonstração para o seu sistema específico.
• Contornar proteções não está previsto de forma alguma. Captcha, segundo fator, antibot — isso é uma parada educada e um pedido a um humano, não uma tarefa para o trabalhador.
• Plataformas vermelhas — somente na sua presença. Para Booking.com, Airbnb e similares não há agendamento em segundo plano nenhum, e o ramo de instalação da skill com agendamento simplesmente não existe na interface. Onde há uma integração honesta por API, nós a oferecemos, e não um trabalhador.
• Não há capturas de tela das etapas. O cartão da execução conta em palavras o que aconteceu, mas não salva imagens da página.
• Uma pergunta esquecida não acumula fila indefinidamente: uma execução que ficou esperando por um humano mais de seis horas tira o trabalhador do turno e avisa sobre isso. A linha "o trabalhador está esperando você" na fila de tarefas é removida sozinha após vinte e quatro horas.
• O trabalhador pertence à conta, e não à unidade — por isso a linha sobre ele aparece na fila de tarefas de qualquer unidade.
• Não temos as suas senhas dos sistemas de destino. Se a sessão no sistema de destino cair, só um humano pode entrar lá.
• As chamadas de IA são pagas. A decisão da etapa, a interpretação da tarefa do chat e a interpretação da gravação do ensino consomem o saldo de IA do proprietário; com o saldo esgotado, o trabalhador não decide a etapa.
• A voz do ensino é transcrita na nuvem da marca onde você trabalha e é armazenada exatamente até o fim da transcrição; o ensino sem microfone também é válido — só que haverá mais perguntas para você.

Solução de problemas#

Se o motivo não estiver claro, clique em "Relatar problema" no painel do trabalhador: as últimas linhas do log (sem os valores dos campos), junto com a versão da extensão e o número da execução, chegarão ao canal do trabalhador no chat de trabalho — você pode encaminhá-las ao suporte. Também é possível "Copiar log", e o filtro acima do log deixa apenas erros, passos ou treinamento.

A análise geral por sintomas está em — solução de problemas; se nada ajudou, fale conosco — como obter ajuda.

Perguntas frequentes#

É preciso entregar ao trabalhador o login e a senha de outro sistema?#

Não, e essa é a principal diferença em relação aos "robôs" para os quais se entregam credenciais. O trabalhador atua sobre a sessão que você mesmo abriu, no seu navegador. Ele não vê senhas, e nós não as armazenamos nem as transmitimos.

Isso é legal?#

Você é responsável por verificar se as regras da plataforma de destino permitem tais ações, e nós tornamos essa questão visível: cada skill tem uma classe de risco, toda ação irreversível exige a sua confirmação, e antes de iniciar uma skill treinada por você, você assina um termo de responsabilidade. Contornar captcha e antibot não é suportado de forma alguma.

Qual é a diferença em relação a uma integração?#

A integração fala com outro sistema via API — rápido, confiável e sem navegador. O trabalhador é necessário onde não existe API alguma. Se a plataforma tem uma API adequada, fazemos uma integração, e não um trabalhador.

É possível delegar qualquer coisa a ele por palavras?#

O trabalhador faz o que aprendeu: uma tarefa do chat é interpretada como a execução de uma skill instalada com parâmetros. "Faça algo útil" ele não executará e responderá honestamente que não tem essa habilidade.

O computador precisa estar ligado?#

Sim. As mãos do trabalhador são a extensão no navegador da sua máquina; um computador desligado significa "sem conexão", e as tarefas simplesmente aguardam na fila.

Quantos trabalhadores é possível criar?#

Quantos forem necessários — por exemplo, um por computador. O nome da persona deve ser escolhido de forma que, na fila de tarefas, fique claro para qual máquina ir.

O que acontece se o trabalhador errar?#

Ele não executa uma ação irreversível sem o seu "sim", e, em um ponto desconhecido, ele para e chama uma pessoa. Tudo o que ele fez fica no cartão da execução: passos, valores coletados e o motivo da parada.

O que fazer se o site mudou de layout?#

Normalmente — nada: o trabalhador encontra sozinho para onde o elemento se moveu. Se a substituição envolver entrada ou clique, ele pergunta "sim / não" no chat, e, após o seu "sim", passará a usar o novo local sozinho. Se a página mudou demais, ele pedirá para mostrar a rotina novamente.

Quem pode clicar em "parar"?#

O proprietário e o gerente podem pausar o trabalhador; o freio de emergência da conta e a lista de domínios proibidos — somente o proprietário. Também é possível revogar o navegador pareado na própria máquina.

Seções relacionadas#

• Loja de aplicativos — onde a seção é ativada e de onde vêm as habilidades prontas
• Chat de trabalho e convidados — o canal do trabalhador: é lá que se delegam tarefas e se responde às perguntas dele
• Quadro de tarefas do turno — a fila de afazeres em que aparece a linha “o trabalhador está esperando você”
• Modelos de IA e sua própria chave — qual modelo toma as decisões passo a passo
• Assinatura — saldo e consumo de IA
• Base de conhecimento — a mesma técnica da extensão executora para coletar páginas atrás de um login
• Funcionários e turnos — papéis dos quais depende o direito de delegar e confirmar
• Como obter ajuda — se o trabalhador parou e o motivo não está claro