En este artículo
Google AX: suspensión, reinicios y autoalojamiento
Un agente gasta 30 dólares. Su proceso desaparece. Pagas otra vez por trabajo que ya había hecho. Ese es un problema de recuperación. Pagar por agentes que pasan casi todo el tiempo esperando es un problema de capacidad ociosa. Google AX puede ayudar a abordar ambos, pero una misma función no resuelve automáticamente los dos.
AX, también llamado Agent Executor, es el orquestador de Google con licencia Apache 2.0 para tareas de agentes en entornos aislados. Funciona sobre Agent Substrate y utiliza YAML y comandos parecidos a los de Kubernetes. La idea útil es gestionar la ejecución como infraestructura, no crear otro framework para el razonamiento del agente. Consulta el proyecto AX y su advertencia sobre el estado de desarrollo.
Revisión del : AX 56bd0fc55574 y Agent Substrate v1.0.0. Es un análisis de fuentes y arquitectura, no una prueba de despliegue ni un benchmark de rendimiento. El caso de los 30 dólares es ilustrativo, no un resultado de AX medido por nosotros.
¿Qué orquesta Google AX actualmente?
La API actual tiene tres recursos principales: Task, Workspace y Model. Las explicaciones anteriores con cuatro recursos incluyen un Gateway que ya no forma parte del esquema de AX revisado aquí. Un recurso declara configuración, no todas las garantías operativas que la rodean.
| Recurso | Qué declara | Qué no demuestra |
|---|---|---|
| Task | Imagen, comando, entorno, CPU y memoria, enlaces a workspaces y depuración. | Un límite de gasto para todo el trabajo o un resultado empresarial correcto. |
| Workspace | Repositorios, archivos, herramientas MCP y skills preparados para la tarea. | Persistencia automática de cada sesión o acción externa del agente. |
| Model | Proveedor, identificador del modelo, parámetros y referencia a credenciales. | Pesos locales o integración automática con cualquier SDK de agentes. |
Una tarea puede representar un trabajo completo o una operación delegada. El esquema de desarrollo permite vincular como máximo un espacio mediante spec.workspace. Su ruta es el directorio de trabajo del comando. Conceptos actuales de recursos y ciclo de vida en AX.
¿Qué cambió respecto a los ejemplos de AX de septiembre?
No despliegues sin cambios un manifiesto antiguo de cuatro recursos. Esta versión sustituye el ejemplo anterior de Gateway y revisa el contrato de ejecución. Fija versiones compatibles de CLI, plano de control y runner antes de migrar.
| Área | Contrato actual | Acción |
|---|---|---|
| Gateway | El esquema no incluye un recurso AX Gateway ni su enlace desde Task. | Configura y prueba la capa real de políticas del sustrato o de la red. |
| Workspaces | Una vinculación opcional spec.workspace con nombre y ruta de montaje. | Crea primero el espacio en el mismo atespace y comprueba dónde se guardan los archivos de sesión. |
| Cambios de Task | Las tareas se crean como recursos inmutables. | Usa otro nombre para cambiar la ejecución; conserva el estado antes de sustituir la tarea. |
| Plano de control | Reconciliación directa con Substrate, estado y bloqueos con caducidad en PostgreSQL. | Comprueba esquema, almacenamiento y versiones compatibles antes de salir de la versión publicada. |
| Metadatos | Servidor en loopback, por defecto 127.0.0.1:8099. | Lee AX_METADATA_URL en lugar de asumir acceso a metadatos por el puerto 80. |
El esquema de Task recoge las vinculaciones de espacios de trabajo, opciones de ejecución y campos de estado. Revisa el esquema actual de la API de AX.
AX v0.3.1 sigue siendo la última versión etiquetada y usa Redis y un controlador separado. Esta revisión de desarrollo de noviembre usa PostgreSQL y fija Substrate v1.0.0. Usa la misma referencia de AX para CLI, servidor y runner. Antes de migrar tareas, valida por separado la restauración y la vuelta a la versión anterior. Notas de instalación y versiones de AX.
¿AX es realmente Kubernetes para agentes de IA?
Es una analogía útil, no un sustituto de Kubernetes. El harness gestiona razonamiento y decisiones sobre herramientas. AX gestiona declaraciones y ciclos de vida de tareas. Agent Substrate ejecuta los entornos aislados, mientras Kubernetes administra la infraestructura de workers.
El servidor actual de AX reconcilia directamente con Substrate mediante bloqueos distribuidos y guarda el estado de los recursos en PostgreSQL. No crea un recurso personalizado de Kubernetes por cada tarea breve. Su diseño también define expresamente las tareas como inmutables. Diseño actualizado del plano de control de AX.
El despliegue incluido genera logs JSON y expone métricas de Prometheus por defecto. La exportación OTLP requiere configuración. Comprueba que tu sistema de logs recibe un evento de ciclo de vida de una tarea desechable y guarda un registro de aplicación separado para las acciones externas completadas. Documentación de observabilidad de AX.
La referencia del README a millones de tareas es un objetivo de diseño. No demuestra que tu clúster ejecute millones de agentes activos a la vez. Dimensiona por concurrencia activa, tamaño del estado, latencia del modelo y picos de carga. Para bucles de razonamiento, herramientas y feedback, consulta la guía de ingeniería de agent harness.
¿Qué sobrevive a la suspensión y reanudación de AX?
Según el runner documentado de AX, sobreviven los archivos del workspace; el comando vuelve en un proceso nuevo. Tanto detener como suspender envía SIGTERM al PID 1. El runner propaga la señal para que el comando guarde su estado. Ese cierre ordenado no equivale a perder una máquina en mitad de una llamada. El contrato fijado del runner explica persistencia y cierre.
| Estado | Límite documentado o responsabilidad de la aplicación |
|---|---|
| Archivos en /workspace | El contrato describe una instantánea que se restaura en un contenedor nuevo. |
| Variables del proceso | AX describe un árbol de procesos nuevo. No dependas de conservar su RAM. |
| Conversación y resultados de herramientas | El harness debe guardarlos en un formato recuperable y cargarlos al arrancar. |
| Correo, pago o escritura en una base de datos | Restaurar archivos locales no deshace un efecto externo. Verifica la operación antes de repetirla. |
| Éxito del comando | El runner puede seguir vivo después; el plano de control documentado no recoge su código de salida. |
Haz que los reintentos sean idempotentes: asigna una identidad persistente a cada operación para que repetir la solicitud no repita silenciosamente su efecto. Registra además un resultado explícito de éxito o error. Ready, WorkspaceReady y un runner sano no sustituyen un entregable aceptado.
La recuperación de un rastreador también depende de qué registros extraídos se conservan junto a la cola de solicitudes. Nuestra guía de checkpoints y salida de Scrapling sigue esos datos durante una pausa y su reanudación.
Hay que distinguir las capas. Agent Substrate describe instantáneas completas que conservan RAM y sistema de archivos, y muestra unos 250 actores compartiendo ocho pods. Eso no sustituye el contrato específico del runner de AX. Prueba exactamente la pareja de runner y backend prevista. Capacidades de instantáneas, demostración y despliegue de Substrate.
¿Reanudar en menos de un segundo significa cero arranque en frío y cero coste ocioso?
No. Activarse rápido es una afirmación de latencia, no una garantía sobre toda la factura. El README de Substrate informa de reanudaciones por debajo de 500 ms y más de 500 activaciones de suspensión/reanudación por segundo. Son capacidades comunicadas por el proyecto, no un benchmark de Wavect ni una promesa para cualquier carga de AX.
El primer arranque, la falta de workers, una instantánea grande, la instalación de dependencias o una respuesta lenta del modelo todavía pueden retrasar el trabajo útil. Mide tanto el tiempo hasta estar listo como el tiempo hasta el primer resultado útil, incluida la latencia p95.
Liberar CPU y RAM de un actor suspendido puede mejorar el uso de la flota. No hace gratuitos los pools de workers, PostgreSQL, el almacenamiento de instantáneas, la red o la operación. Una solicitud de modelo ya admitida puede seguir generando cargos mientras el agente local espera. Capacidad ociosa y tokens son partidas distintas.
También hay que separar comandos de automatización. AX documenta ax suspend y ax resume. La detección de inactividad y suspensión automáticas siguen en la hoja de ruta, junto con presupuestos de tokens, tiempos máximos y políticas de aprobación. Un comando existente no demuestra una política automática activa. Comprueba qué capacidades de AX siguen en la hoja de ruta.
¿Cuánto puede ahorrar una recuperación mejor?
Mide el trabajo repetido tras la interrupción, no todo el trabajo original. Un checkpoint útil puede reducir repeticiones. No devuelve el dinero de la inferencia consumida, y una función de suspensión no demuestra recuperación ante fallos abruptos.
Supongamos un mes con 1.000 trabajos. El 10 % sufre exactamente una interrupción. Si cada trabajo afectado repite 30 dólares de llamadas a modelos y herramientas, la repetición cuesta 3.000 dólares. Si la recuperación probada reduce ese trabajo a 3 dólares, el coste baja a 300 dólares. Son 2.700 dólares de repetición evitada, no un ahorro garantizado por instalar AX.
Si la ejecución adicional, las instantáneas y la operación suman 600 dólares, el escenario deja 2.100 dólares antes de otros costes que hayan cambiado. Son supuestos ilustrativos en USD, no tarifas de proveedores ni resultados de clientes. La mejora debe probarse con fallos abruptos, no deducirse de una pausa correcta.
La metodología completa, incluida la revisión humana y los resultados aceptados, está en nuestra guía de coste por acción de agentes de IA. Este artículo se centra en repeticiones y recuperación relacionadas con el ciclo de vida de AX.
¿Cómo probar la recuperación de archivos en AX sin gastar tokens?
Empieza con un workspace desechable y un proceso inocuo que espera. El ejemplo usa los campos actuales del manifiesto. No incluye llamadas al modelo ni credenciales de repositorios. Sí consume infraestructura. Contrasta el ejemplo con la referencia actual de manifiestos.
Necesitas una instalación compatible de AX/Substrate, la CLI y acceso autorizado al clúster. Guarda el ejemplo como task.yaml. debug: true es deliberado para esta tarea aislada de diagnóstico: SSH permite ejecutar comandos y acceder a archivos. No es una configuración predeterminada para producción ni exposición pública.
apiVersion: ax.io/v1alpha1
kind: Workspace
metadata:
name: recovery-lab
spec:
files:
- path: README.txt
content: "Disposable recovery test. No model calls."
---
apiVersion: ax.io/v1alpha1
kind: Task
metadata:
name: recovery-lab-001
spec:
workspace:
name: recovery-lab
path: /workspace/recovery-lab
command: ["python3", "-c", "import time; time.sleep(3600)"]
debug: trueAplica el manifiesto y comprueba que la tarea se crea en estado Suspended. Reanúdala cuando el WorkerPool de Substrate tenga capacidad. Espera a Ready y cierra la observación con Ctrl+C.
ax apply -f task.yaml
ax resume task recovery-lab-001
ax watch task recovery-lab-001Escribe el marcador después del arranque y luego suspende y reanuda. El comando de la tarea no vuelve a crear el archivo. Leerlo después comprueba persistencia, no una inicialización repetida.
ax ssh recovery-lab-001 -- sh -c 'printf "%s\n" "checkpoint-before-suspend" > /workspace/recovery-lab/recovery-marker.txt'
ax suspend task recovery-lab-001
ax resume task recovery-lab-001
ax watch task recovery-lab-001Espera de nuevo a Ready, detén el watch con Ctrl+C y lee el marcador:
ax ssh recovery-lab-001 -- cat /workspace/recovery-lab/recovery-marker.txtEl resultado esperado es checkpoint-before-suspend. Superar esta prueba demuestra que ese archivo sobrevivió a una suspensión y reanudación ordenadas. No demuestra restauración de RAM, durabilidad ante fallos abruptos ni reintentos seguros de acciones externas. No hemos ejecutado aquí esta prueba de clúster.
Copia las evidencias que necesites y borra únicamente los recursos desechables creados arriba. Estos comandos eliminan la tarea de prueba y su definición de workspace:
ax delete task recovery-lab-001
ax delete workspace recovery-lab¿Dónde se controla la red tras retirar AX Gateway?
No sigas aplicando el ejemplo antiguo de AX Gateway. El esquema revisado de Task no tiene un enlace gateway. Diseña restricciones de salida en la capa real de ejecución o red y comprueba que se aplican al actor de la tarea.
Substrate v1.0.0 filtra HTTP(S) y DNS según la política. El proxy por defecto bloquea WebSocket, CONNECT de proxy directo y otro tráfico TCP. Comprueba si la política instalada rechaza destinos sin aprobar y qué recoge la monitorización del tráfico TLS permitido. Revisa las reglas de tráfico de salida de Substrate.
Prueba endpoints permitidos, destinos bloqueados, redirecciones, acceso directo al proveedor y revocación de credenciales. Mantén autorización por solicitud en los servidores permitidos: un hostname autorizado no concede acceso a todos sus clientes o documentos. Son comprobaciones propuestas, no vulnerabilidades reproducidas por nosotros. La lista de seguridad para entornos aislados de agentes cubre el perímetro más amplio.
¿AX detiene automáticamente una factura de tokens descontrolada?
El esquema revisado de Task no declara un límite acumulado de dinero o tokens. Los límites de CPU y memoria se aplican a la sandbox. La infraestructura que realiza las llamadas se encarga de autorizar y contabilizar el uso del modelo.
Utiliza una capa independiente que autorice las llamadas al modelo. Vincula preparación, subtareas y reintentos a un identificador persistente del trabajo. Reserva presupuesto antes de admitir llamadas concurrentes, concilia el consumo después y bloquea nuevas admisiones al llegar al límite. Las solicitudes ya admitidas aún pueden generar cargos. Define un exceso acotado en lugar de prometer una parada instantánea sin sobrecoste.
El componente que revoca credenciales o bloquea solicitudes debe estar fuera del workspace modificable por el agente. Un prompt que le pide respetar un presupuesto no es un control de gasto.
¿Puedes alojar AX sin Google Cloud?
Existe una ruta de desarrollo sin GCP, pero la portabilidad en producción necesita su propia prueba. Substrate documenta quickstarts locales con kind y también en GKE. AX requiere una API de control de Substrate accesible, su propio plano de control con PostgreSQL e imágenes de runner adecuadas. Ejecutar localmente no implica inferencia local.
AX sigue advirtiendo de posibles cambios incompatibles. Prueba la combinación y registra conjuntamente la referencia de AX, la versión de Substrate y el digest del runner.
¿Antigravity es obligatorio en todas las tareas?
El esquema de Task de desarrollo declara un comando y un espacio de trabajo opcional. La prueba usa un proceso en espera sin inferencia. El runner ofrece metadatos en la dirección de loopback de AX_METADATA_URL. Contrato actual de arranque y metadatos dentro de la sandbox.
¿Y Pi u otro harness personalizado?
Trátalo como una integración pendiente de validar, no como un adaptador listo confirmado por este análisis. La imagen debe incluir /usr/local/bin/ax-task-runner, leer AX_TASK_YAML y AX_WORKSPACE_YAML, preparar workspaces persistentes, informar de disponibilidad y supervisar el cierre. Verifica por separado dónde guarda la sesión el harness y cómo la recupera.
Tener el repositorio es solo una parte de controlar tu IA. Debes poder inspeccionar la ejecución, exportar el estado, elegir proveedores de inferencia, revocar permisos y abandonar el despliegue. La ubicación en una nube no resuelve por sí sola esas preguntas.
¿Qué debe demostrar un piloto de AX antes de producción?
Empieza con tareas sintéticas y sistemas desechables. Son criterios de aceptación propuestos por nosotros, no pruebas que AX haya superado en nuestro entorno.
| Prueba | Evidencia que recoger |
|---|---|
| Suspensión ordenada | Sobrevive un marcador escrito después del arranque y el harness carga su sesión guardada. |
| Fallo abrupto | Detén el worker desechable a mitad de un paso y mide la ventana de estado perdido y el coste repetido. |
| Finalización ambigua de herramienta | Un timeout simulado después de una escritura externa produce un efecto, no dos, tras la recuperación. |
| Presupuesto agotado | Las subtareas paralelas dejan de admitir llamadas en el límite común, con exceso en curso medido. |
| Comunicación del resultado | El supervisor recibe éxito y error aunque el runner siga sano. |
| Red y credenciales | Los destinos bloqueados siguen bloqueados y revocar permisos impide nuevas solicitudes privilegiadas. |
| Reanudación con carga | Mide p50/p95 hasta disponibilidad y primer resultado útil con el pool de workers ocupado. |
| Portabilidad y actualización | Exportación, restauración y rollback funcionan con las versiones e infraestructura previstas. |
Registra revisiones AX/Substrate, digest del runner, ruta del modelo, políticas y resultados de cada ejecución. Elige AX cuando las mejoras medidas de capacidad y recuperación justifiquen operar la plataforma. Una flota pequeña con trabajos breves y baratos quizá todavía no necesite esta infraestructura adicional.
Los servicios de ingeniería de IA de Wavect cubren integración y preparación para producción. El caso Twinsoft AI demuestra experiencia de entrega independiente, no un despliegue de referencia de AX. Utiliza la lista de QA antes del lanzamiento para organizar las evidencias o hablemos de los costes de reinicio y requisitos de tu runtime de agentes.
Google AX: preguntas sobre recuperación y despliegue
¿Qué es Google AX Agent Executor?
AX es un orquestador con licencia Apache 2.0 para tareas de agentes aisladas sobre Agent Substrate. Sus recursos principales actuales son Task, Workspace y Model. Gestiona infraestructura de ejecución, no el bucle de razonamiento del agente.
¿La API actual de AX sigue incluyendo Gateway?
El esquema revisado en noviembre de 2026 no incluye un recurso Gateway ni un enlace gateway en Task. Sustituye los ejemplos antiguos por configuración de la capa real de ejecución o red y verifica tanto el bloqueo de salidas como la autorización.
¿AX reanuda el estado exacto del agente en memoria?
El runner documentado de AX restaura el workspace en un contenedor y un árbol de procesos nuevos. Substrate describe por separado instantáneas de estado completo. Valida la integración concreta; no deduzcas recuperación de RAM de las capacidades del runtime inferior.
¿AX recupera automáticamente un trabajo de 30 dólares después de un fallo?
No debes darlo por hecho. La suspensión ordenada puede conservar archivos, pero un fallo abrupto requiere puntos de control persistentes y recuperación probada. Las acciones externas necesitan conciliación e idempotencia para evitar repetir el efecto.
¿Reanudar en menos de un segundo elimina los costes de inactividad?
No. Substrate publica reanudaciones por debajo de 500 ms, pero activar infraestructura no equivale a la latencia completa de la aplicación. La capacidad de workers, el plano de control, las instantáneas y la operación siguen costando. Las llamadas al modelo se contabilizan aparte.
¿AX suspende automáticamente todas las tareas inactivas?
La documentación revisada ofrece comandos explícitos para suspender y reanudar. La detección de inactividad y suspensión automáticas aún aparecen en la hoja de ruta de AX. Comprueba la política y la implementación de tu versión instalada.
¿AX impone un presupuesto acumulado de tokens?
El esquema revisado de Task no declara un límite de tokens o dinero para todo el trabajo. Utiliza autorización externa de llamadas que contabilice preparación, subtareas y reintentos, con un exceso en curso acotado.
¿AX puede funcionar sin Google Cloud?
Substrate documenta desarrollo local con kind y despliegue en GKE. AX necesita una API de control de Substrate compatible, su propio plano de control e imágenes de runner adecuadas. Es una opción de desarrollo, no una validación de producción en cualquier infraestructura.
¿Por qué ax ssh rechaza la conexión?
La tarea debe habilitar explícitamente spec.debug: true para los servicios de ejecución y archivos. Están desactivados por defecto. Limita el diagnóstico a entornos controlados; las tareas inmutables requieren un plan de sustitución cuando cambia su configuración.
¿Puede ejecutarse un agente Pi u otro harness dentro de AX?
Trátalo como una integración con runner personalizado que debes validar. La imagen debe cumplir el contrato de AX: preparación del workspace, disponibilidad, metadatos y cierre. Este análisis no acredita un adaptador oficial de Pi listo para usar.
Reflexiones finales
AX merece una evaluación cuando tu flota desperdicia capacidad o repite trabajo caro. Separa la oportunidad de las garantías. Demuestra qué sobrevive, qué puede repetirse, qué sigue costando y quién puede detener el sistema. Controla la recuperación y el gasto, no solo el YAML.
