Documentación · 01

Primeros pasos.

Abre el banco de trabajo, abre un proyecto y ejecuta tu primera simulación. Diez minutos, nada que instalar.

Qué es CommandAGI

CommandAGI es un banco de trabajo donde personas y agentes planifican, simulan y operan máquinas reales. Todo en él se apoya en cuatro ideas:

  • Dispositivos. Una definición de dispositivo describe un tipo de máquina como un conjunto de canales — una línea de G-code, un bus de servos, un flujo de video, una shell. Una fresadora CNC, un láser, una impresora, un brazo, un dron, un teléfono, una cámara y una computadora son todos dispositivos.
  • Mundos. Un mundo sitúa dispositivos como unidades, con posiciones, en un espacio. Un mundo es physical (llega al hardware) o simulation (cada canal se ejecuta en un simulador).
  • Ejecuciones. Lo que hacen los dispositivos se registra como flujos en una ejecución: una carpeta por ejecución, un flujo por canal de cada unidad, todos con el mismo reloj.
  • Permisos. Un agente o una persona actúa sobre hardware físico solo dentro de un permiso permanente que le otorgó una cuenta.

Todo son archivos simples en una carpeta que tú eliges.

Abrir el banco de trabajo

Ve a commandagi.com. El banco de trabajo se abre al instante — no necesitas una cuenta.

  • Como invitado, tu proyecto vive en el almacenamiento propio de este navegador. Puedes importar una carpeta a él y exportarlo como zip en cualquier momento.
  • Con la sesión iniciada, tus proyectos pueden vivir en la nube y acompañarte entre dispositivos. Crea una cuenta o inicia sesión desde el pie del panel izquierdo.
  • En la app de escritorio, el mismo banco de trabajo se ejecuta con el host de esta computadora integrado, así que puede abrir cualquier carpeta del disco y llegar a las máquinas por USB y en la red local. Consulta Descargar.

Abrir un proyecto

La carpeta que abres es el proyecto. Usa el menú de proyecto en la parte superior del panel izquierdo:

  • abrir carpeta… — una carpeta de tu computadora (en navegadores con la File System Access API, o en la app de escritorio);
  • proyecto en este navegador — el proyecto de invitado;
  • importar una carpeta a este navegador… y exportar este proyecto del navegador (.zip).

Una pestaña nueva (+, o Mod+T) ofrece archivos sugeridos, archivos recientes y las unidades desde las que puedes abrir: la nube, una carpeta local, archivos locales, este navegador y cualquier host que hayas emparejado.

El banco de trabajo incluye proyectos de ejemplo de solo lectura para explorar: placas indicadoras LED (eda), un proyecto mecánico, una celda de trabajo de biología, una biblioteca de simulaciones y una biblioteca de plantillas de paneles.

Orientarte

La ventana tiene un centro de pestañas dividido en paneles y tres regiones alrededor: izquierda (navegación y el explorador), derecha (detalles de lo seleccionado) e inferior (ejecuciones, eventos, terminal y logs). El panel que usaste por última vez tiene el foco y decide lo que muestran las regiones.

  • Mod+Shift+P abre la paleta de comandos. Todas las acciones están ahí.
  • Mod+P abre un archivo por su nombre.
  • Mod+Enter maximiza el panel con el foco.

Crear un mundo

Desde la paleta, ejecuta nuevo mundo (simulación)…. Un mundo de simulación vincula cada canal a un simulador, así que nada de lo que contiene puede llegar al hardware.

Las unidades se enumeran en el world.json del mundo. Selecciona una unidad en la vista 3D o en la lista y edita su posición, rotación y dispositivo en la pestaña Detalles de la derecha. Para añadir unidades, agrégalas a world.json — consulta Formatos de archivo.

Ejecutar una simulación

  1. Abre el mundo y elige simular en el canal de una unidad, en la vista de dispositivos.
  2. Al conectar se inicia una ejecución de sesión en ese mundo (o se une a la que ya está abierta). Cada comando y cada estado se escriben en la ejecución a medida que ocurren.
  3. Los mundos que nombran un archivo de simulación también ofrecen arrastre con fuerza: agarra un cuerpo y empújalo. La fuerza se registra con tu nombre.
  4. Usa cerrar ejecución cuando termines.

Un mundo de simulación lo indica en pantalla: los canales se ejecutan solo en el simulador; nada de aquí llega al hardware, y los resultados simulados nunca cuentan como evidencia física. En un ejemplo de solo lectura, las ejecuciones no se registran — abre una carpeta propia para conservarlas.

Reproducir y bifurcar

Cualquier ejecución puede reproducirse en la barra de tiempo al pie de la ventana, a velocidades de 0,25× a 8×, o seguirse en directo.

  • Mod+Alt+P reproducir o pausar · Mod+Alt+L ir al directo · Mod+Alt+, y Mod+Alt+. avanzar o retroceder cinco segundos.
  • La pestaña ejecuciones de la región inferior enumera las ejecuciones de un mundo.
  • bifurcar inicia una nueva ejecución simulada desde el cabezal de reproducción — el mismo momento, un futuro distinto.

Siguiente

Cuando estés listo para hardware real, lee Conectar una máquina. Para dejar que un agente lo controle, lee Agentes y permisos permanentes.