rdp-cli
Como usar um Raspberry Pi como cliente RDP de um agente de IA para Windows
Um Raspberry Pi é pequeno, barato e adequado para automação por linha de comando. Ele pode funcionar como cliente RDP dedicado para um agente de IA que precisa controlar um desktop Windows remoto.
A arquitetura é:
Agente de IA → Raspberry Pi → rdp-cli → sessão RDP do Windows
O Pi não substitui o Windows. Ele executa o rdp-cli e fornece ao agente a tela e a entrada da sessão remota.
Requisitos
Use um Raspberry Pi 4, Raspberry Pi OS ou Debian de 64 bits, uma rota de rede até o Windows, RDP habilitado e uma conta autorizada.
O guia oficial de plataformas lista Raspberry Pi 4 com Debian 13.7 de 64 bits como configuração física testada. Raspberry Pi OS de 32 bits não é compatível; outros modelos devem ser verificados separadamente.
Instalação e conexão
Baixe o arquivo Linux ARM64:
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
Conecte ao Windows:
printf '%s' "$RDP_PASSWORD" |
./rdp-cli-linux-arm64 connect --host WINDOWS_IP --user WINDOWS_USER --password-stdin
Guarde o ID da sessão e não coloque senhas em scripts ou logs.
Observar, agir e verificar
Antes de cada ação importante, o agente deve capturar uma nova tela:
./rdp-cli-linux-arm64 screenshot --session SESSION --out before.png
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out after.png
Ele pode abrir um aplicativo de estoque, fazer login, escolher um depósito, inserir um SKU, confirmar uma janela, salvar e verificar o status. O guia de início rápido explica esse fluxo.
Arquivos, controle humano e limites
Se o servidor RDP permitir o redirecionamento de unidades, o rdp-cli pode enviar arquivos ou pastas e baixar os resultados. Os recursos de arquivos mostram o progresso, permitem cancelar, exigem confirmação para substituir arquivos e verificam o conteúdo.
Uma pessoa pode abrir a mesma sessão em um visualizador nativo ou navegador autorizado, pausar o agente, corrigir uma etapa e devolver o controle. O VNC permite visualizar e controlar, mas não oferece a mesma transferência nativa de pastas.
O rdp-cli não substitui APIs do Windows, testes unitários, testes de backend ou análise de desempenho.
FAQ e conclusão
É preciso ter ambiente gráfico no Pi? Não. O rdp-cli é um cliente de linha de comando.
O rdp-cli executa o agente de IA? Não. O agente ou framework chama os comandos.
Capturar tela → realizar uma ação → capturar novamente → verificar o resultado.