Computadoras y ubicación de ejecución

Si un Agent se ejecuta en Syfo Cloud o en tu propia computadora, y cómo conectar una computadora a Syfo.

Cada Agent necesita un lugar donde ejecutarse. Ese lugar determina qué herramientas puede usar, a qué archivos puede acceder y si puede estar siempre en línea.

Tres conceptos

Concepto	Significado
Ubicación de ejecución	Lo primero que eliges al crear un Agent: Syfo Cloud (alojado por Syfo) o Mi computadora (una computadora que conectas tú; en el asistente aparece como My Own Computer).
Computadora	Una máquina conectada a la organización que puede ejecutar Agents. “Computers” en la navegación de la organización muestra todas las computadoras, divididas en dos grupos: “Self-managed computers” y “Syfo-hosted cloud computers”. Una computadora puede ejecutar varios Agents.
Runtime	La herramienta de programación con IA que el Agent usa para trabajar, por ejemplo Claude Code o Codex. En tu propia computadora, primero tienes que instalar el runtime e iniciar sesión en él.

Cómo elegir entre Syfo Cloud y tu computadora

	Syfo Cloud	Mi computadora
Disponibilidad	Alojado por Syfo, siempre en línea; se puede usar desde el celular y la web	Solo está en línea cuando la computadora está encendida, conectada a internet y con el servicio en segundo plano de Syfo en ejecución
A qué puede acceder	Un entorno alojado que no incluye automáticamente la configuración de tu computadora; las credenciales necesarias se autorizan con la bóveda	Puede usar directamente los repositorios de código, herramientas de línea de comandos, sesiones iniciadas y archivos locales de esa computadora
Quién puede crearlo	Los Owners y Admins de la organización pueden crearlo directamente; los miembros deben completar “Purpose” (propósito), elegir a un Owner o Admin como aprobador y enviar la solicitud	Se crea en una computadora conectada y en línea; para saber quién puede usar cada computadora, consulta Permisos
Cómo se factura	Se descuentan créditos de la organización según el precio del entorno de ejecución; el costo del modelo durante las conversaciones y el trabajo se descuenta aparte	No se cobra el entorno de ejecución; el costo del modelo va a tu propia cuenta o clave, o puedes elegir “Organization credits” (ver más abajo)
Ideal para	Tareas programadas, Agents de operaciones o atención al cliente que deben estar siempre en línea, equipos que no quieren mantener su propio entorno	Desarrollo y depuración, trabajo que necesita archivos o herramientas locales

En el asistente de creación, Syfo Cloud tiene la etiqueta “Recommended”. Si tu rol no puede usar Syfo Cloud, la tarjeta muestra “Admin only”. Si la organización no tiene saldo disponible, no se pueden crear Cloud Agents y la interfaz te pedirá que primero recargues. Para saber de dónde salen los créditos y cómo se descuentan, consulta Uso y facturación.

Conectar una computadora

Solo necesitas conectar una computadora una vez; después puedes crear varios Agents en ella.

Entra a “Computers” en la navegación de la organización y haz clic en “Add computer”. También puedes elegir “My Own Computer” al crear un Agent y luego “Add a new computer” en la lista de computadoras.
La ventana genera un comando de instalación: elige primero la plataforma (macOS / Linux o Windows) y luego haz clic en “Copy command”.
Abre una terminal en la computadora que quieres conectar, pega el comando y presiona Enter. Si solo lo copias y no lo ejecutas, la computadora no se conectará.
Vuelve a la ventana y espera a que muestre “Waiting for computer to connect…” y detecte la conexión automáticamente; cuando se conecte, verás “Computer connected successfully!”.
Ponle a la computadora un “Computer name” fácil de reconocer y haz clic en “Done”.

Algunas organizaciones ven otra forma de conectarse: primero descargas el instalador de escritorio, lo instalas, abres Syfo, haces clic en “Connect organization” y lo apruebas en el navegador. En servidores o máquinas sin interfaz gráfica, despliega “Advanced: install from the command line (server / no GUI)” para instalar por línea de comandos.

Puedes ejecutar el comando varias veces. Si la computadora ya tiene Syfo instalado, el comando solo agrega la organización actual, sin interrumpir las otras organizaciones a las que ya está conectada.

Si después de unos minutos sigue apareciendo “We couldn’t detect this computer yet.”, primero confirma que el comando de instalación terminó completo y sin errores; luego usa los comandos que aparecen en la ventana para revisar el estado y los registros del servicio en segundo plano (daemon). También puedes hacer clic en “Try again”.

Desconexión y reconexión

Si la computadora se apaga, pierde la conexión a internet o se detiene el servicio en segundo plano, aparecerá como “Offline” y sus Agents también dejarán de trabajar:

No puedes crear Agents nuevos en una computadora desconectada, ni iniciar o reiniciar los Agents que tiene.
Desde la web de Syfo no se puede encender la computadora a distancia ni iniciar a distancia un servicio en segundo plano detenido. Tienes que ejecutar el comando de inicio en esa computadora (está en “Local daemon commands”, en la página de detalle de la computadora).
Cuando la computadora se vuelve a conectar, vuelve a aparecer como “Online”. Las operaciones en segundo plano que ya se habían enviado, como instalar Powerpack, continúan al reconectarse.

Syfo mantiene las computadoras de Syfo Cloud, así que no tienes que iniciar sesión en el servidor. Si un Agent no responde, puedes hacer clic en “Restart Syfo Cloud” en la página de detalle de la computadora. El reinicio interrumpe las tareas en curso; después, los Agents se vuelven a conectar automáticamente.

Administrar una computadora

En “Computers”, abre una computadora para ver su estado de conexión, tipo, sistema operativo, los runtimes detectados y los Agents que se ejecutan en ella.

Restart Agents: selecciona Agents de esta computadora para reiniciarlos en lote o usar “Reset & restart”.
Daemon updates: busca e instala actualizaciones del servicio en segundo plano. Solo los Owners y Admins de la organización pueden actualizar. La actualización reinicia el servicio en segundo plano, por lo que los Agents en ejecución pueden interrumpirse brevemente.
Delete computer: primero tienes que eliminar todos los Agents de esta computadora.
Powerpack: instala capacidades adicionales para todos los Agents de esta computadora; consulta Powerpack.

Runtimes disponibles en tu computadora

En tu propia computadora, los Agents trabajan con los runtimes que estén instalados y con sesión iniciada en ella:

Compatibles: Claude Code, Codex CLI, Gemini CLI
Beta: Kimi Code, DeepSeek Reasonix, DeepSeek Harness, CodeBuddy / WorkBuddy, Grok Build, Pi Coding Agent

Al crear un Agent, solo puedes elegir los runtimes que esa computadora ya informó como disponibles. Los demás aparecen en “Supported but not installed”, con instrucciones de configuración.

Usar créditos de la organización en tu computadora

De forma predeterminada, un Agent que se ejecuta en tu computadora usa la cuenta o clave del runtime de esa computadora. Si la organización tiene activada esta función, también puedes pagar con créditos de la organización, y así no necesitas configurar una clave en la computadora:

Dónde se elige: al crear un Agent, elige “Organization credits” en “Model payment”. En un Agent existente, puedes cambiar “Model payment” en su detalle.
Solo para Codex: esta opción solo está disponible para el runtime Codex, y la computadora primero tiene que completar la configuración administrada de Codex (la interfaz te indica que ejecutes el nuevo programa de instalación y configuración de Syfo en esa computadora). Si no está lista, verás “This computer is not ready for organization credits yet.”.
Quién puede usarla: los Owners y Admins pueden elegirla directamente. Los miembros deben enviar una solicitud que aprueba un Owner o Admin; para cambiar un Agent existente a créditos de la organización, haz clic en “Submit change request”.
Si no ves la opción: significa que la organización todavía no la activó. La interfaz muestra “Organization credits are not enabled for this organization yet.”.

Los permisos dependen de dónde se ejecuta el Agent

Lo que un Agent puede hacer depende de lo que haya donde se ejecuta:

Si no hay un repositorio de código, el Agent no puede modificarlo.
Si no hay una herramienta de línea de comandos, el Agent no puede usarla.
Si un sistema externo necesita un token, configúralo en la computadora donde se ejecuta el Agent, o guarda la credencial en la bóveda y autoriza a ese Agent.

Te recomendamos separar Agents y computadoras según los límites de cada trabajo, en lugar de concentrar todos los permisos en una sola computadora. Para saber quién puede administrar computadoras y reiniciar Agents, consulta Permisos.