rdp-cli

Como usar automação RDP com o Codex

Como usar automação RDP com o Codex

O Codex pode planejar a tarefa, mas não consegue ver nem clicar em uma área de trabalho Windows sozinho. Com o rdp-cli, ele pode conectar-se a uma sessão RDP, ler capturas de tela, executar ações controladas, transferir arquivos e verificar o resultado.

Conecte-se com segurança

Não coloque a senha no prompt nem no histórico de comandos.

$pw = Read-Host "RDP password"
$connection = $pw | .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin | ConvertFrom-Json
$session = $connection.data.session

Guarde o ID de sessão retornado.

Observe antes de inserir dados

Faça uma nova captura antes de cada ação importante.

$shot = .\rdp-cli.exe screenshot --session $session --out .\before.png | ConvertFrom-Json
$observation = $shot.data.observation

Deixe o Codex verificar a imagem mais recente. Depois de cada clique ou entrada de texto, faça outra captura e use a observation mais nova. Não reutilize coordenadas de uma tela antiga.

Transfira arquivos diretamente

.\rdp-cli.exe files upload --session $session --local .\sales.xlsx --path sales.xlsx
.\rdp-cli.exe files download --session $session --path report.xlsx --local .\report.xlsx

Confira o resultado da transferência e confirme que o arquivo final existe.

Mantenha uma opção de controle humano

.\rdp-cli.exe watch --session $session --viewer window
.\rdp-cli.exe pause --session $session

Pause diante de diálogos inesperados, pedidos de login ou ações destrutivas. A captura mais recente e o arquivo final são a evidência de que a tarefa foi concluída.