Repetir com dados novosPelo terminal, depois do passo 5. O nome do campo está em bundle/param_proposals.json
openadapt flow replay bundle --url [ENDEREÇO DA CÓPIA DE TESTE] --run-dir run --param [NOME DO CAMPO]=[VALOR NOVO]
01Pra que serve
- Repetir tarefas que são sempre iguais, como preencher o mesmo cadastro várias vezes, trocando só os dados.
- Funciona em site, em programas de Windows, macOS e Linux e em área de trabalho remota.
- Deixar o seu agente de IA chamar a tarefa inteira como uma ferramenta só, sem ele mexer na tela.
- Conferir se o cadastro foi salvo mesmo. Num teste com 30 cadastros errados, a IA disse que todos deram certo. A conferência do registro achou 25 dos 30, sem alarme falso nos 5 que estavam certos.
02O que você precisa
- Python 3.10, 3.11 ou 3.12 (o programa que roda a ferramenta). Na versão 3.13 ou mais nova, a instalação fica incompleta.
- Internet na primeira vez: ele pode baixar um navegador próprio.
- Uma cópia de teste do sistema que você quer automatizar. Nunca comece pelo sistema real.
- Só pra gravar programa do computador (não site), um complemento. No Mac, troque windows por macos: python -m pip install "openadapt[capture,windows]"
- Não precisa de conta nem de chave pra fazer o teste do passo 3.
03Passo a passo
- No Windows, abra o PowerShell (o terminal do Windows) e crie uma área separada pra ferramenta. No Mac, abra o Terminal e use: python3 -m venv .venv && source .venv/bin/activate
py -m venv .venv; .\.venv\Scripts\Activate.ps1
- Instale o OpenAdapt com um comando. É igual no Windows e no Mac.
python -m pip install --upgrade openadapt
- Faça o teste pronto, que leva uns 5 minutos. Ele roda duas vezes num sistema de mentira de uma clínica. Na primeira, salva e confirma. Na segunda, a tela diz que salvou, mas o dado se perdeu, e o OpenAdapt percebe e para. O resultado fica na pasta openadapt-quickstart.
openadapt quickstart --break-it
- Grave a sua tarefa. Troque o endereço do exemplo pelo da sua cópia de teste. O navegador abre: faça a tarefa uma vez, no ritmo normal, e feche a janela ou aperte Ctrl-C no terminal. Comece por algo curto que não salva nada, como abrir um registro e ver um campo. Senhas nunca são guardadas. Pra gravar um programa do computador, use --window "NOME DA JANELA" no lugar do --url.
openadapt flow record --url https://staging.your-app.example --out rec
- Transforme a gravação num programa. Ele pode perguntar quais campos que você digitou mudam a cada repetição. Aceite os que vão receber dados novos. A lista fica no arquivo bundle/param_proposals.json.
openadapt flow compile rec --out bundle --name my-first-workflow
- Repita a tarefa, sempre na cópia de teste. Ele faz tudo de verdade e não pede confirmação. No fim, o relatório fica em run/REPORT.md. Pra ver a explicação do que aconteceu, rode: openadapt flow explain run
openadapt flow replay bundle --url https://staging.your-app.example --run-dir run
04Exemplos de uso: comandos e pedidos prontos
Repetir uma lista inteiraQuando os dados estão numa planilha salva em CSV. Cria um programa novo que roda uma vez por linha. Pra ver todas as opções: openadapt flow for-each --help
openadapt flow for-each bundle --records [ARQUIVO.csv] --out program --map [COLUNA DA PLANILHA]=[NOME DO CAMPO]
Ligar no Claude CodeModo de teste. Precisa do uv, um programa que instala ferramentas Python: docs.astral.sh/uv/getting-started/installation/
claude mcp add --scope user openadapt -- uvx --python 3.12 openadapt-agent serve
Pedir pro seu agenteNa conversa com o agente, depois de ligar. Ele só manda os dados e recebe o resultado, sem ver a tela
Use o OpenAdapt pra listar os programas disponíveis. Depois rode o programa [NOME DO PROGRAMA] com estes dados: [CAMPO]: [VALOR]. Me diga em português qual foi o resultado exato. Se ele parou, pediu revisão ou não teve certeza de que salvou, me avise e não rode de novo. Nunca diga que deu certo se não foi confirmado.
05Antes de usar
- Gravar e repetir fazem a tarefa de verdade, inclusive salvamentos que não dá pra desfazer. O comando do passo 6 não pede confirmação. Use sempre uma cópia de teste, nunca os dados reais.
- O comando do passo 6 não confere o que foi salvo. Terminar sem erro só quer dizer que os passos acabaram. A conferência do registro é uma etapa à parte, e o sistema precisa deixar ler o registro salvo por outro caminho, sem depender da tela.
- Cada sistema, em cada plataforma, precisa da sua própria validação com registros de teste antes de rodar nos reais.
- Se o sistema já tem uma integração oficial pra essa tarefa, use ela. E se a tarefa muda toda vez, o OpenAdapt não compensa: ele vale a pena quando a mesma coisa se repete.
- Se o sistema mudar a ordem das telas ou as regras, grave de novo. Em área de trabalho remota, ele para mais vezes do que no navegador. Parar é melhor do que salvar no registro errado.
- Se aparecer que um salvamento pode ter passado, não rode de novo. Olhe o registro no sistema antes.
- No Mac, quem grava precisa das permissões Gravação de Tela, Acessibilidade e Monitoramento de Entrada, nos Ajustes do Sistema, e reiniciar depois de liberar Gravação de Tela. Sem isso, a gravação sai em branco e sem aviso de erro.
- No Windows, se o programa gravado roda como administrador, rode o OpenAdapt como administrador também. O próprio projeto diz que o teste em apps de Windows ainda é pequeno: um app deles, numa máquina só.
- O uso no seu computador é de graça, com licença MIT. O plano Team, com execução na nuvem deles, custa US$ 499 por mês e é opcional.
- Gravações e relatórios ficam no seu computador, mas guardam os valores digitados. Proteja essa pasta. Prints só saem do computador se você ligar a ajuda de IA pra achar botões, que vem desligada.
- O comando de ligar no Claude Code usa o modo de teste. Pra ele chamar os seus próprios programas, tem uma configuração a mais, explicada em docs.openadapt.ai.
Resumindo: instala com um comando, grava a tarefa uma vez numa cópia de teste e repete com dados novos, sem IA e sem mandar print de tela pra lugar nenhum.