Construye y crea
Instantáneas y bifurcación
Congela el estado completo de una máquina en vivo — el disco y la memoria del agente — en una instantánea, y luego bifurca una máquina nueva y aislada sembrada a partir de ella. Es el mismo movimiento para una VM de computadora y una simulación de robot 3D, y hace que cualquier ejecución sea reproducible por construcción.
Instantánea
Captura un dispositivo en cualquier momento. La instantánea contiene la máquina completa — herramientas instaladas, archivos y dónde estaba el agente — así que es un punto de partida lanzable, no solo una copia de seguridad.
# Freeze a machine's full state (disk + agent memory).
curl https://api.commandagi.com/threads/$THREAD_ID/embodiments/$EMBODIMENT_ID/snapshot \
-H "Authorization: Bearer $COMMANDAGI_API_KEY"
# → { "snapshotId": "snap_…" }Bifurcación
Lanza una máquina nueva a partir de una instantánea y obtienes una copia independiente: ramifica un experimento, ejecuta diez variaciones desde la misma configuración, o entrégale a alguien un entorno de trabajo. Bifurcar es simplemente adjuntar una máquina con un fromSnapshotId.
# Fork a brand-new machine seeded from that snapshot.
curl https://api.commandagi.com/threads/$NEW_THREAD/computers \
-H "Authorization: Bearer $COMMANDAGI_API_KEY" \
-d '{ "fromSnapshotId": "snap_…" }'Por qué importa
- Reproducibilidad — cada bifurcación parte exactamente del mismo estado, así que los resultados son comparables.
- Paralelismo económico — bifurca por rama de experimento en lugar de reconstruir un entorno cada vez.
- Nunca pierdas el progreso — las máquinas inactivas se instantanean automáticamente y se apagan de forma gratuita, y luego bifurcan de vuelta para reanudar.
- Configuraciones compartibles — publica una instantánea como plantilla lanzable que otros puedan bifurcar.
La superficie para desarrolladores
/app/threads/:id/embodiments/:embodimentId/snapshotCaptura el disco + la memoria del agente./app/threads/:id/computersAdjunta una máquina (pasa fromSnapshotId para bifurcar)./app/snapshotsInstantáneas lanzables — bases oficiales, las tuyas, y las publicadas.Las mismas operaciones son herramientas de agente (snapshot_device, list_snapshots, publish_snapshot, merge_snapshots), y una bifurcación es un create_thread con un snapshotId.