Comece pela sessão conectada

Conecte-se seguindo o guia para Mac e use data.session do JSON. O agente trabalha por comandos e não precisa abrir um visualizador local. Abra a janela quando você quiser acompanhar o progresso.

Observe antes de decidir

Capture a tela e leia data.observation. Coloque esse valor em OBSERVATION. As coordenadas abaixo são apenas um exemplo da sintaxe: escolha o ponto de clique a partir da sua própria imagem. Obtenha uma nova observação após reconexão, mudança de controle ou alteração das telas.

No PowerShell do Windows, execute os exemplos na pasta do executável e substitua rdp-cli por .\rdp-cli.exe.

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x 420 --y 315 --observation OBSERVATION

Envie texto e confira o resultado

O teste registrado mostra uma frase em chinês no Bloco de Notas do Windows. O texto foi gravado explicitamente na área de transferência remota e colado com CTRL+V; a imagem não comprova um teste de entrada direta com type. Antes disso, o editor precisa estar aberto e com foco de entrada.

Use uma observação atual e tire outra captura após a operação. Confira a linha realmente exibida no aplicativo. O envio bem-sucedido de um comando não confirma seu processamento pelo aplicativo. A imagem abaixo é um registro, não uma conexão ao vivo.

rdp-cli clipboard set --session SESSION --text "Tarefa remota concluída." --observation OBSERVATION
rdp-cli key --session SESSION --keys CTRL+V --observation OBSERVATION
rdp-cli screenshot --session SESSION --out result.png

Este teste real do produto usa texto em chinês. A captura original foi preservada e o guia explica o resultado.

Registro do Bloco de Notas do Windows com uma frase de verificação em chinês colada pela área de transferência remotaVer captura original ↗

Não repita uma ação sem conferir o estado

Uma operação pode ter enviado a entrada mesmo quando o prazo expira. Consulte o estado usando a REQUEST_ID retornada e observe a tela novamente. Só repita um clique de salvar ou enviar se o estado exigir. Se a observação estiver vencida, obtenha uma nova captura; não passe automaticamente a controlar o mouse local.

rdp-cli operations status --session SESSION --request-id REQUEST_ID

Mantenha o resultado verificável

Guarde os estados e as imagens necessários à tarefa, considerando o conteúdo confidencial que podem conter. Uma pessoa pode abrir a mesma sessão, pausar e assumir o controle. Após a devolução, o agente verifica a tela atual antes de continuar. Para arquivos em RDP, há comandos específicos de upload, progresso e download.

Artigos relacionados

Comece na sua área de trabalho remota

Baixar o rdp-cli · Seguir o guia rápido da sua plataforma