Define el resultado esperado
Indica a tu agente la ubicación del ejecutable, el destino autorizado o una sesión y un resultado concreto: por ejemplo, escribir una nota en el editor remoto y comprobarla. rdp-cli no incluye un modelo de IA; tu agente decide a partir de la pantalla. Conecta primero y conserva data.session. SESSION representa ese valor.
Observa antes de actuar
Captura y abre before.png. Guarda data.observation para la entrada siguiente. Las coordenadas son del escritorio remoto, no del visor local. El clic de ejemplo solo sirve si el campo está realmente en ese lugar: elige las coordenadas mirando tu imagen y sustituye OBSERVATION. Si aparece un diálogo o se mueve la aplicación, observa de nuevo.
En PowerShell de Windows, ejecuta estos ejemplos desde la carpeta del ejecutable y sustituye 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
Introduce texto y comprueba
Con el editor enfocado, consigue una observación nueva. Si el portapapeles remoto está permitido, establece el texto y pégalo explícitamente. La captura grabada muestra este resultado en el Bloc de Notas de Windows; no es una conexión en directo ni demuestra una entrada directa con type.
También puedes usar type; consulta rdp-cli type --help. En ambos casos, abre la captura final. Que el envío tenga éxito no significa que la aplicación haya aceptado o terminado la tarea.
rdp-cli clipboard set --session SESSION --text "Tarea remota completada." --observation OBSERVATION
rdp-cli key --session SESSION --keys CTRL+V --observation OBSERVATION
rdp-cli screenshot --session SESSION --out result.png
Esta prueba real del producto utiliza texto en chino. Se conserva la captura original y la guía explica el resultado.
Recupera el estado sin duplicar trabajo
Una observación caducada requiere otra captura. Si una persona pausa o toma el control, deja de enviar entradas. Después de reconectar o devolver el control, usa un token nuevo. Si una operación agota el tiempo, consulta su solicitud original antes de repetirla. Un resultado incierto no prueba que no ocurrió nada. Para archivos, usa files status y verifica el resultado; no vuelvas a subir porque se perdió la primera respuesta.
rdp-cli operations status --session SESSION --request-id REQUEST_ID
Conserva tu escritorio local
Las capturas y entradas normales viajan por el protocolo remoto, sin mover tu puntero ni abrir un visor local. Una persona puede observar o tomar el control de la misma sesión cuando lo necesite. Los permisos del portapapeles y de archivos siguen dependiendo del servidor y del protocolo.