Dispositivos conectados y transferencia de datos.

Disponibilidad de Amazi Desktop

Amazi Desktop está disponible para Windows x64, Linux amd64 (Debian/Ubuntu) y macOS 13 o posterior en Apple Silicon. Descargue el instalador desde la pestaña Dispositivos del proyecto. En macOS, abra DMG y mueva Amazi a Aplicaciones. Las actualizaciones de macOS requieren descargar e instalar el DMG más nuevo.

Solicite a Amazi un enlace en el que se pueda hacer clic para Dispositivos en su proyecto actual. Su formato es https://app.amazi.pro/project/{projectId}?chat={chatId}&rightTab=devices, con su proyecto real y los ID de chat y el origen actual de su aplicación Amazi. Mantenga el valor chat existente cuando esté disponible; de lo contrario omitirlo. Consulte Enlaces directos a pestañas del proyecto para ver el formato completo. Esto abre la pestaña de descarga; un enlace a esta guía abre las instrucciones de instalación.

Instale y abra Amazi Desktop, inicie sesión a través de su navegador y guarde la configuración de acceso del proyecto en Desktop. Luego seleccione el dispositivo en Dispositivos y haga clic en Guardar. Las descargas están disponibles para todos; El uso de dispositivos conectados depende de su plan.

Si su cuenta ya tiene dispositivos conectados, puede seleccionar o anular la selección de uno para el proyecto incluso cuando esté desconectado. Cambie el interruptor del dispositivo y luego haga clic en Guardar en la parte superior derecha de Dispositivos. Los cambios se aplican sólo después de guardarlos; elegir otro dispositivo reemplaza la selección anterior. Las actualizaciones de estado conservan los cambios no guardados y, si falla al guardarlos, quedan disponibles para volver a intentarlo. El encabezado muestra el estado de conexión de la selección guardada: Conectado, Sin conexión o No conectado. Conecte nuevos dispositivos y elija el nivel de acceso del proyecto y las carpetas permitidas en Amazi Desktop. El agente solo trabaja dentro de esos permisos mientras el dispositivo está en línea. La selección de un dispositivo no otorga acceso por sí sola. Si no hay ningún dispositivo conectado, la pestaña muestra un marcador de posición vacío.

Trabajo en segundo plano y puesta en marcha.

Al cerrar la ventana Desktop, Amazi se mantiene ejecutándose en la bandeja del sistema en Windows y Linux, o en la barra de menú en macOS. Las tareas del dispositivo y el acceso al navegador continúan con los permisos guardados del proyecto. Utilice el icono Amazi para volver a abrir la ventana o elija Salir para detener la aplicación y desconectar el dispositivo. Al iniciar Amazi nuevamente también se vuelve a abrir su ventana. Algunos entornos de escritorio Linux requieren soporte de bandeja para mostrar el icono.

Abra el menú de la cuenta y habilite Iniciar al iniciar sesión para iniciar Amazi en segundo plano cuando inicie sesión en su computadora. Esto está desactivado de forma predeterminada y se aplica solo a esta instalación, no a sus otros dispositivos. Puedes desactivarlo en el mismo menú. En macOS, apruebe la solicitud de elementos de inicio de sesión en Configuración del sistema si se le solicita. Instale la aplicación primero; El inicio no está disponible en versiones portátiles o de desarrollo.

Acceso al dispositivo

Cada tarjeta de dispositivo muestra Acceso a la red/Red bloqueada y Acceso al navegador/Navegador bloqueado para los permisos guardados del proyecto. La etiqueta de red sigue el modo de acceso al comando: el acceso completo permite la conexión en red, el acceso restringido usa su configuración de red guardada y el apagado la bloquea. Esta etiqueta no prueba la conexión a Internet del dispositivo ni limita Chrome. El acceso completo incluye el navegador automáticamente; Restringido tiene un interruptor de navegador independiente y Desactivado bloquea el navegador. Expanda Detalles del dispositivo para ver el estado de la conexión de Chrome: Conectado, Conectando, Desconectado, No configurado o Error de conexión. El estado se actualiza automáticamente; un dispositivo fuera de línea o una verificación de conexión vencida ya no se muestra como conectado. Cambiar el permiso del navegador en Amazi Desktop; el agente se conecta cuando es necesario para una tarea.

Solicite a Amazi que enumere los dispositivos del propietario del proyecto para ver su conexión y configuración de acceso, incluidos los dispositivos que no están seleccionados actualmente. Sólo el dispositivo seleccionado puede ejecutar comandos; enumerar dispositivos no los conecta al proyecto ni cambia sus permisos.

Cuando una tarea autorizada funciona en otro proyecto de su propiedad, los comandos del dispositivo utilizan el dispositivo seleccionado de ese proyecto de destino y los permisos guardados. El acceso desde el proyecto original no otorga acceso al dispositivo del otro proyecto.

Amazi puede verificar los detalles de un dispositivo seleccionado incluso cuando el acceso está Desactivado o sus permisos no se han guardado. Explica si es necesario habilitar el acceso, guardar la configuración o volver a conectar el dispositivo. Un dispositivo conectado aún puede tener acceso desactivado para este proyecto.

En Desktop, el recordatorio de selección web aparece en la parte superior de la configuración del proyecto. Desactivado bloquea todo el acceso a proyectos en el dispositivo, incluidos comandos, archivos y el navegador. Restringido ejecuta comandos en el entorno limitado con sus límites de carpeta y red. El agente también puede solicitar un comando de terminal ordinario sin estos límites: una regla guardada lo autoriza; de lo contrario, solo el propietario del dispositivo puede aprobarlo en el chat. Acceso completo ejecuta comandos con los permisos de archivos, programas y redes de su cuenta del sistema operativo, sin esos límites de carpetas/redes. Guarde los permisos en Desktop y guarde la selección del dispositivo por separado en la pestaña Dispositivos del proyecto web.

Cada dispositivo muestra su modo de acceso al lado de su estado en línea y en sus detalles: Acceso apagado, restringido o completo. Restringido también muestra permisos de carpetas y redes. El permiso de Solo lectura o Lectura y escritura de cada carpeta aparece como una etiqueta gris; Los dos permisos usan tonos diferentes. Restringido también muestra las reglas de comando de terminal guardadas. Seleccionar un dispositivo no cambia su carpeta guardada ni su configuración de red. Al deseleccionarlo en Web se revocan sus reglas de comando y aprobaciones pendientes para el proyecto.

El propietario de la cuenta o un administrador puede expandir Detalles del dispositivo y elegir Desconectar dispositivo en la parte inferior derecha. Confirme la acción, luego haga clic en Guardar para desvincular el dispositivo de la cuenta de su propietario y de cada proyecto y cerrar sesión en su sesión Desktop. Antes de guardar, Deshacer eliminación cancela la desconexión pendiente. Para conectarlo nuevamente es necesario iniciar sesión y seleccionarlo para los proyectos relevantes. Los participantes invitados, incluidos aquellos con acceso completo al proyecto, no pueden desvincular el dispositivo de la cuenta de su propietario.

En Amazi Desktop, abra el menú de la cuenta y elija Cerrar sesión y eliminar dispositivo. Después de la confirmación, el dispositivo se elimina de su cuenta y de todos los proyectos, y se cierra su sesión en Desktop. Si la eliminación falla, permanecerás conectado y podrás volver a intentarlo.

Las acciones del dispositivo están disponibles únicamente a través del chat Amazi. En Restringido, una solicitud de terminal ordinaria sin una regla coincidente muestra una confirmación antes de la ejecución. Los comandos fallidos de la zona de pruebas también solicitan una nueva ejecución en la terminal normal, utilizando una regla guardada o la aprobación del propietario. El error puede tener otra causa; volver a intentarlo puede repetir cambios parciales. El comando aparece en un bloque de código separado con sus primeros 100 caracteres seguidos de puntos suspensivos cuando son más largos. Las opciones muestran sólo sus etiquetas, con el prefijo del programa resaltado. Esto sólo acorta la visualización; La aprobación ejecuta el comando original completo con acceso completo. El propietario del dispositivo puede Denegar, Permitir solo esta vez, Permitir este comando en el futuro o Permitir todos los comandos del programa * en el futuro. La última opción permanece visible pero deshabilitada cuando Amazi no puede identificar un programa literal. Sólo las dos opciones de permisos futuros salvan una regla. Una regla exacta coincide con todo el comando, incluidos sus argumentos y cualquier carácter literal *. Una regla de prefijo permite al programa argumentos literales adicionales desde cualquier carpeta de trabajo para este proyecto y dispositivo; no permite automáticamente cadenas de shell, sustituciones o redirecciones. Amazi ve permisos recordados en la siguiente verificación del dispositivo. Elija Denegar o detener la tarea para cancelar la acción. Después de la aprobación, Amazi continúa el comando guardado automáticamente; no se necesita ningún mensaje adicional ni solicitud de agente. La cancelación, la pérdida de conexión y el acceso revocado nunca solicitan reintentos. Los errores del terminal ordinario no inician otra solicitud de aprobación. Un comando de zona de pruebas exitoso aún puede omitir procesos o servicios del host; Amazi puede solicitar explícitamente una verificación de terminal cuando sea necesario. El cambio de modos cancela las aprobaciones pendientes y únicas y detiene los comandos activos. Las reglas de comando guardadas y la configuración de red/carpeta restringida se conservan por separado, incluso después de reiniciar Desktop. El acceso completo incluye archivos, programas y la red con los permisos de su cuenta del sistema operativo.

En Amazi Desktop, Acceso a la red se encuentra encima de las pestañas de configuración y controla la red de espacio aislado. Restringido tiene dos pestañas: Carpetas de la zona de pruebas para permisos de carpetas y Lista de permisos de terminal para comandos permitidos fuera de los límites de la zona de pruebas, incluidos los permisos otorgados en el chat. Haga clic en Agregar comando, ingrese un comando y elija exacto o prefijo; ingrese prefijos como git o git status sin agregar *. Utilice el botón Eliminar para revocar una regla. Las entradas existentes no se pueden editar: elimínelas y agregue una de reemplazo. Los cambios en la lista de comandos se aplican inmediatamente mientras está conectado, independientemente de Guardar para proyecto. Dispositivos web muestra la lista de solo lectura. Las reglas guardadas autorizan la ejecución del terminal en Restringido y permanecen disponibles cuando regresa a ese modo. Un prefijo de programa permite cualquier argumento literal, incluidas operaciones destructivas o código pasado a un intérprete.

Solo el propietario del proyecto puede aprobar un comando de dispositivo o guardar una regla de permiso. Otros participantes ven esta restricción dentro de la tarjeta de preguntas. Cualquiera que tenga permiso para chatear puede elegir Omitir: el comando no se ejecutará y no se guardará ningún permiso. La entrada del chat permanece visible mientras la pregunta espera una respuesta.

Cuando guarda por primera vez los permisos de un dispositivo para un proyecto, los comandos aprobados comienzan con un pequeño conjunto de comandos de diagnóstico exactos para su sistema operativo, que cubren la carpeta actual, la lista de archivos, el usuario, el nombre de la computadora y los procesos en ejecución. Estas reglas autorizan la ejecución del terminal en modo Restringido y se pueden eliminar como cualquier otra regla guardada. No permiten argumentos extra. La configuración existente del proyecto/dispositivo no se cambia. Guardar nuevamente, cambiar de modo o volver a conectarse no restaura las reglas eliminadas.

En Amazi Desktop, el acceso completo incluye el acceso al navegador automáticamente. En Restringido, habilite Permitir acceso al navegador; esta opción comienza deshabilitada y los cambios se aplican inmediatamente. Cualquiera de los permisos permite al agente conectarse a su Google Chrome personal para las tareas de ese proyecto sin una confirmación de chat por separado. No es necesario mantener una sesión de navegador conectada de antemano ni pegar un token en Desktop.

Instale la extensión oficial de Playwright en Chrome. Cuando una tarea necesita su navegador, el agente inicia una conexión. Es posible que la extensión le solicite que seleccione la pestaña deseada en Chrome. Las credenciales del navegador guardadas existentes permanecen locales. El agente recibe solo el estado de la conexión y las pestañas expuestas.

Habilitar el acceso, reiniciar Desktop y verificar antecedentes no abren pestañas de conexión. Al cerrar la última pestaña del grupo Dramaturgo finaliza la sesión; el permiso de su proyecto permanece guardado. Si se pierde la conexión, Desktop actualiza su estado y envía una notificación del sistema, incluso mientras está minimizado. El agente puede solicitar una nueva conexión para una tarea, pero los intentos fallidos de conexión y las acciones interrumpidas del sitio web no se reintentan automáticamente.

La sesión del navegador se comparte entre proyectos permitidos. El acceso incluye páginas iniciadas y es independiente de los límites de carpetas y de la red sandbox. Desactivar bloquea todo el acceso al navegador, oculta la opción y detiene el trabajo actual del navegador de ese proyecto, incluso si el permiso del navegador se guardó anteriormente. El dispositivo debe estar seleccionado para el proyecto y en línea. En Restringido, desactive Permitir acceso al navegador para bloquear más acciones y detener el trabajo actual del navegador de ese proyecto. Otros permisos del proyecto permanecen guardados.

Una acción fallida en la página no significa por sí sola que se haya revocado el acceso al navegador. Amazi informa el error de la acción y puede continuar usando una sesión disponible. En acceso completo, la sincronización de una configuración de navegador restringido previamente guardada no interrumpe el trabajo del navegador.

Amazi Desktop le permite trabajar con los archivos de un dispositivo conectado desde su proyecto, con permisos de acceso separados para cada proyecto. El inicio de sesión utiliza el navegador y los métodos de inicio de sesión Amazi disponibles. El tema y el idioma siguen la configuración de su cuenta.

Las transferencias de archivos de dispositivos requieren acceso restringido con permisos de carpeta adecuados o acceso completo; Las reglas del terminal no autorizan transferencias ni excepciones a la configuración de sus carpetas.

En Desktop, Restringido le permite elegir permisos de carpeta y acceso a la red. En Windows, Todas las carpetas siempre está habilitada con acceso de Solo lectura y no se puede desactivar ni cambiar para acceso de escritura. Los comandos se pueden leer fuera de las carpetas seleccionadas, excepto los datos protegidos Amazi, sujetos a los permisos de Windows. Agregue carpetas individuales con acceso de lectura y escritura para permitir cambios. Puede guardar sin carpetas individuales cuando solo se necesita lectura. Linux y macOS restringen las lecturas de archivos de usuario a las carpetas seleccionadas, y los recursos del sistema necesarios para ejecutar comandos aún están disponibles.

En Linux/macOS, agregue al menos una carpeta o habilite Todas las carpetas antes de guardar. En estos sistemas, este modificador cubre su carpeta de inicio, no todas las unidades; su selector de lectura/escritura pasa a estar disponible cuando está habilitado. En todos los sistemas, las carpetas seleccionadas siguen siendo editables junto con el acceso general: puedes agregar, eliminar y cambiar permisos de carpetas individuales. Al guardar se conservan estos permisos juntos. Cambiar o desactivar el acceso general en Linux/macOS mantiene las carpetas individuales y sus permisos. La ruta de la carpeta de inicio y la explicación de acceso permanecen por encima de los modos de acceso. Aparecen errores y guardados exitosos dentro de Desktop. En segundo plano, Desktop también solicita notificaciones del sistema. En la Web, expanda las carpetas y los comandos aprobados para inspeccionar sus listas; sus configuraciones se cambian en Desktop. Puede corregir su configuración sin perder el borrador.

Si Desktop muestra Actualizar Amazi Desktop, seleccione Buscar actualizaciones o descargue el instalador más reciente desde Dispositivos. El aviso muestra su versión instalada y la versión mínima admitida. El acceso al dispositivo se detiene mientras las versiones son incompatibles; iniciar sesión nuevamente no soluciona este problema. Si el aviso solicita una actualización del servidor, actualice el servidor local o comuníquese con su administrador.

Actualizando Desktop

A partir de la versión 0.25.0, las aplicaciones instaladas de Windows y Linux buscan actualizaciones al inicio y periódicamente mientras se ejecutan. También puede seleccionar Buscar actualizaciones en el menú de la cuenta o en la pantalla de inicio de sesión. Seleccione Descargar actualización, espere la descarga, luego seleccione Actualizar y reiniciar y confirme. Antes de reiniciar, Amazi detiene los comandos activos y las transferencias de archivos. Guarde primero las configuraciones no guardadas. Se conservan sus configuraciones de inicio de sesión, dispositivo y acceso guardado. Linux puede solicitar la contraseña de su sistema. Puedes posponer una actualización; cerrar la aplicación no la instala automáticamente.

La versión 0.24.0 necesita una instalación manual de una versión más reciente para obtener esta característica. Cierre Amazi y ejecute el instalador más nuevo con la misma cuenta del sistema operativo sin eliminar la configuración de Amazi. En Debian/Ubuntu, abra el nuevo DEB en el instalador del paquete o ejecute sudo apt install ./<downloaded-file>.deb. Las compilaciones portátiles se actualizan manualmente. Si falla la verificación o la descarga, siga usando la versión instalada e inténtelo nuevamente cuando su conexión esté disponible.

Importar y exportar datos de la base de datos del proyecto.

Las transferencias de archivos conservan el contenido sin analizarlo ni convertirlo. Para importar bases de datos, primero copie el archivo en el proyecto, luego solicite a Amazi que escriba y ejecute un analizador específico de la tarea en el tiempo de ejecución del proyecto. Para las exportaciones, primero prepare y verifique el archivo en el tiempo de ejecución del proyecto y luego cópielo en su dispositivo. Los archivos que ya están en el proyecto se pueden procesar sin Desktop; consulte Base de datos y almacenamiento.

Especifique la tabla o consulta, la ruta del archivo del proyecto y el comportamiento de importación. Agregar, actualizar filas coincidentes, reemplazar filas y restaurar una base de datos tienen diferentes efectos. El desarrollo y la producción comparten la base de datos; confirmar los cambios consiguientes una vez que su alcance esté claro. Consulte Base de datos y almacenamiento.

Espere el resultado completo antes de usar el destino. Iniciar una transferencia no es prueba de finalización. La cancelación o un error pueden interrumpir el trabajo; pida a Amazi que inspeccione un resultado incierto antes de volver a intentarlo. Las transferencias que involucran archivos en su dispositivo requieren un dispositivo conectado con acceso a las carpetas relevantes.