O que é o CommandAGI
O CommandAGI é uma bancada de trabalho onde pessoas e agentes planejam, simulam e operam máquinas reais. Tudo nela se apoia em quatro ideias:
- Dispositivos. Uma definição de dispositivo descreve um tipo de máquina como um conjunto de canais — uma linha de G-code, um barramento de servos, um fluxo de vídeo, um shell. Uma fresadora CNC, um laser, uma impressora, um braço, um drone, um telefone, uma câmera e um computador são todos dispositivos.
- Mundos. Um mundo posiciona dispositivos como unidades, com posições, em um espaço. Um mundo é
physical(ele alcança hardware) ousimulation(todo canal roda em um simulador). - Execuções. O que os dispositivos fazem é registrado como fluxos em uma execução: uma pasta por execução, um fluxo por canal de cada unidade, tudo em um só relógio.
- Concessões. Um agente ou uma pessoa atua em hardware físico somente dentro de uma concessão permanente que uma conta lhe deu.
Tudo isso são arquivos simples em uma pasta que você escolhe.
Abrir a bancada de trabalho
Vá para commandagi.com. A bancada de trabalho abre na hora — você não precisa de uma conta.
- Como convidado, o seu projeto fica no armazenamento deste navegador. Você pode importar uma pasta para ele e exportá-lo como zip a qualquer momento.
- Com a sua conta, os seus projetos podem ficar na nuvem e acompanhar você entre dispositivos. Criar conta ou entrar pelo rodapé da doca esquerda.
- No aplicativo de desktop, a mesma bancada roda com o host deste computador embutido, então pode abrir qualquer pasta do disco e alcançar máquinas por USB e pela rede local. Veja Download.
Abrir um projeto
A pasta que você abre é o projeto. Use o menu de projeto no topo da doca esquerda:
- abrir pasta… — uma pasta do seu computador (em navegadores com a API File System Access, ou no aplicativo de desktop);
- projeto neste navegador — o projeto de convidado;
- importar uma pasta para este navegador… e exportar este projeto do navegador (.zip).
Uma nova guia (+, ou Mod+T) oferece arquivos sugeridos, arquivos recentes e os Drives dos quais você pode abrir: a nuvem, uma pasta local, arquivos locais, este navegador e qualquer host que você tenha pareado.
A bancada de trabalho traz projetos de exemplo somente leitura para explorar: placas de indicadores de LED (eda), um projeto mecânico, uma célula de trabalho de biologia, uma biblioteca de simulações e uma biblioteca de modelos de painéis.
Conheça o ambiente
A janela tem um centro de guias divididas em painéis e três regiões ao redor: esquerda (navegação e o explorador), direita (detalhes do que está selecionado) e inferior (execuções, eventos, terminal e registros). O painel que você usou por último tem o foco e define o que as regiões mostram.
- Mod+Shift+P abre a paleta de comandos. Toda ação está lá.
- Mod+P abre um arquivo pelo nome.
- Mod+Enter maximiza o painel em foco.
Crie um mundo
Na paleta, execute novo mundo (simulação)…. Um mundo de simulação vincula cada canal a um simulador, então nada nele pode alcançar hardware.
As unidades ficam listadas no world.tsx do mundo. Selecione uma unidade na visão 3D ou na lista e edite a posição, a rotação e o dispositivo na guia Detalhes, à direita. Para adicionar unidades, inclua-as no world.tsx — veja Formatos de arquivo.
Rode uma simulação
- Abra o mundo e escolha simular em um canal de uma unidade na visão de dispositivos.
- Conectar inicia uma execução de sessão nesse mundo (ou entra na que já está aberta). Cada comando e cada estado é gravado na execução conforme acontece.
- Mundos que citam um arquivo de simulação também oferecem arrasto por força: pegue um corpo e empurre-o. A força é registrada com o seu nome.
- Use fechar execução quando terminar.
Um mundo de simulação informa isso na tela: os canais rodam só no simulador; nada aqui alcança hardware, e resultados simulados nunca contam como evidência física. Em um exemplo somente leitura, as execuções não são registradas — abra uma pasta sua para guardá-las.
Repetir e bifurcar
Toda execução pode ser repetida na barra de tempo no rodapé da janela, em velocidades de 0,25× a 8×, ou acompanhada ao vivo.
- Mod+Alt+P reproduz ou pausa · Mod+Alt+L vai ao vivo · Mod+Alt+, e Mod+Alt+. avançam cinco segundos.
- A guia execuções, na região inferior, lista as execuções de um mundo.
- bifurcar inicia uma nova execução de simulação a partir do cursor — o mesmo momento, um futuro diferente.
Próximo
Quando estiver pronto para hardware real, leia Conectar uma máquina. Para deixar um agente operá-la, leia Agentes e concessões permanentes.