Skip to content

Acceso remoto ​

Usa tu zqagent en remoto desde el móvil u otros dispositivos: la tarea se ejecuta en el nodo y el progreso, las solicitudes de aprobación y los resultados vuelven en tiempo real.

Un enlace, dos identidades ​

El acceso remoto usa pasarela Rust + WSS binario:

   móvil / navegador ──wss──▶ pasarela Rust ◀──wss── nodo (máquina que ejecuta las tareas)
                            ▲
                      emite credenciales (HTTPS)
                            │
                          plano de control del Hub
  • Nodo: posee una clave de firma (FLEET_SECRET) y, al conectar, demuestra su identidad a la pasarela con ella.
  • Terminal (móvil / navegador): no toca la clave del nodo. Inicia sesión en el Hub con la cuenta, la cambia por un token de corta duración que solo autoriza el nodo indicado y lo usa para conectar a la pasarela. Cuando caduca, basta con pedir otro sin volver a iniciar sesión.

Ventaja: el móvil no guarda a largo plazo una clave capaz de controlar el nodo, y si el token se pierde solo afecta al nodo autorizado.

Uso en el móvil ​

  1. Completa la conexión en la máquina del nodo (ver «Conexión a la nube» en Configuración del servidor) y activa el acceso remoto en los ajustes del nodo.
  2. Abre el centro de usuario (dirección del Hub) en el navegador del móvil e inicia sesión con la misma cuenta.
  3. En la página «Nodos» verás los nodos conectados; haz clic para entrar en la consola.

La app nativa reutiliza actualmente las mismas páginas de consola. Si desarrollas un cliente propio, el contrato del protocolo está en docs/wire-protocol.md del repositorio (formato de tramas, envoltura, definición de mensajes y algoritmo de firma).

Qué puedes hacer ​

OperaciónDescripción
Enviar tareasEnvía un mensaje y el nodo empieza a ejecutar
Información adicionalAñade indicaciones durante la ejecución y se inyectan en la tarea actual
AprobarAnte operaciones que requieren autorización: aceptar / aceptar todo / rechazar
Responder preguntasResponde a las preguntas de la IA o a la confirmación de planes
Interrumpir tareasDetén la tarea actual en cualquier momento
Gestión de conversacionesCrear, cambiar y ver la lista de conversaciones
Explorar archivosVer el directorio del proyecto y el contenido de los archivos

Notificaciones y progreso ​

  • Los hitos clave de la tarea (requiere aprobación, requiere respuesta, completada, error) se envían a tu cuenta y se ven en cualquier dispositivo.
  • El progreso (qué herramienta se está llamando, qué se ha emitido) se envía en tiempo real.
  • Varios dispositivos de la misma cuenta reciben la notificación a la vez.

Disponibilidad ​

  • El nodo solo necesita una conexión saliente a la pasarela (wss://, normalmente 443); no requiere entrada pública ni abrir puertos.
  • Si la pasarela no es accesible, el nodo reconecta con retroceso exponencial y las funciones locales no se ven afectadas en absoluto.