Laydyne
Crie e verifique plantas baixas 2D/3D com sua IA via MCP. Compare opções de layout e operacionais no Pro ou Max.
Servidor MCP hospedado
npx add-mcp 'https://laydyne.com/api/mcp/oauth'Instala no Claude Code, Codex, Cursor e outros
Documentação
Crie gratuitamente com sua própria IA
Após o cadastro gratuito, conecte ChatGPT, Claude, Codex, Claude Code ou seu próprio agente MCP para criar e editar espaços gratuitamente no Laydyne; seu provedor de IA cobra separadamente. Você também pode explorar e editar o Studio sem uma conta. Verifique a Conta para acesso de execução, IA integrada e limites manuais de salvamento em nuvem.
- Escolha um ponto de partida. No Studio, abra Comece com um propósito em Modelo, IA ou Novo espaço. Crie um layout ou abra um exemplo editável. Modelos e exemplos usam dimensões presumidas; verifique-as com suas medidas.
- Descreva o layout para a IA. Siga as etapas de conexão MCP e diga ao seu agente o que construir ou alterar. Revise o piso, as peças e as conexões em 2D ou 3D. Você também pode ajustá-los manualmente no Studio.
- Verifique antes de calcular. Use a Verificação de rota gratuita no Studio ou peça ao seu agente para chamar
check_space. Ela identifica sobreposições e passagens estreitas e pode testar a acessibilidade quando você especifica destinos de rota. Ela não executa uma simulação. - Guarde uma cópia. Escolha Projeto → Arquivo de projeto para baixar um arquivo JSON do projeto. Você pode abrir esse arquivo no Studio mais tarde.
Design residencial. Crie cômodos, móveis e qualquer área externa, verifique dimensões e corredores livres, salve o projeto e exporte um desenho. Simulações são opcionais: escolha uma apenas para uma pergunta sobre movimento, tempo ou capacidade.
Casos de uso explicam decisões, entradas e saídas; exemplos são modelos e resultados salvos que você pode abrir.
Importando um desenho? O Studio aceita arquivos PNG, JPEG, WebP e PDF de até 5 MB para rascunho assistido por IA quando esse recurso estiver disponível na sua conta. Trate as dimensões lidas de uma imagem como suposições; verifique a escala e as medidas principais antes de usar um resultado.
Modele um espaço em 2D, 2.5D e 3D
O Studio abre em Ver modelo. Arrastar navega pela visualização. Escolha Editar antes de mover peças, áreas de piso ou alterar conexões; volte para Ver modelo para inspecionar sem movê-las.
Navegação de visualização
Em 3D, arraste em qualquer lugar para orbitar, arraste com o botão direito para panoramizar e role para ampliar. Em telas de toque, use um dedo para orbitar e dois dedos para panoramizar ou beliscar para ampliar. Em 2D, abra uma área de piso, arraste para panoramizar e role ou belisque para ampliar. Foque a visualização: as setas do teclado panoramizam; + / − ampliam. Visualizar não altera o modelo nem seu histórico de Desfazer.
Escolha Plantas 2D para ver todos os níveis de um projeto de vários andares lado a lado na mesma escala. Abra uma folha ou use os botões de nível para navegar. Layout de nível organiza as áreas em um nível; Editar área abre suas peças, dimensões e ferramentas de desenho. Os botões de nível mantêm você na edição de área quando já está editando. Todos os níveis retorna à visão geral. Em Modelo 3D, escolha Edifício inteiro ou Editar área. Holograma, Desenho de linha e Sólido são estilos visuais 3D, separados do nível ou área que você está visualizando. As configurações de visualização também definem o fundo 3D.
Os agentes podem definir {"dimension":"2d","scope":"building","planLayout":"all-levels"} com set_space_view. Defina planLayout="level" para organizar o nível ativo, ou scope="floor" para editar e reproduzir uma simulação na área ativa. A visão geral mostra folhas de layout; a reprodução aparece dentro de uma área.
As visualizações de planta e perspectiva mostram o mesmo modelo espacial editável. Um piso pode ter um contorno poligonal e furos; uma peça pode ser uma caixa ou um prisma poligonal, rotacionado e elevado acima do piso. Isso é eficiente para layouts e rotas, mas não é uma malha de forma livre ou um modelo CAD detalhado.
2D Coloque e meça pegadas em uma planta.
2.5D Dê alturas e elevações a pisos e peças.
3D Inspecione esses mesmos pisos e peças em perspectiva.
Um nível é um andar. Ele pode conter várias áreas de piso separadas. Áreas que se tocam não são conectadas automaticamente: adicione uma passagem, escada, elevador ou escada rolante. Use um piso contínuo com paredes e portas para cômodos ligados por um corredor. As verificações de rota podem cruzar conexões explícitas.
Um local pode conter vários edifícios: blocos de apartamentos, um armazém e um bloco de escritórios, torres, um estacionamento. Coloque cada um em Edifícios no local com seus andares e, opcionalmente, um elevador e escadas; o solo sob ele abre para sua pegada. O solo e as pontes entre edifícios permanecem áreas de piso separadas. Mostre um edifício sozinho, copie-o ou arraste-o na planta do nível com suas entradas. Pessoas e robôs ainda se movem apenas ao longo das conexões, e um cenário pode enviá-los a lugares em um edifício.
Com nada selecionado, Áreas e contagens nas propriedades mostra a área do piso (o contorno menos seus furos), a área zoneada e não zoneada, a área de cada zona, áreas por tag e contagens de peças por tipo. Níveis e áreas adiciona a área de piso de cada nível e o total. Zonas sobrepostas contam uma vez nos totais. Estas são áreas do desenho, não uma área de piso legal. Os nomes de zonas e peças na planta 2D saem das prateleiras e giram para caber em corredores estreitos, para nunca ficarem uns sobre os outros.
As coordenadas do agente estão em metros: x vai para a direita, z vai para a borda próxima e y é a elevação da parte inferior acima do piso. O rotation de uma peça é em graus anti-horários na planta. Pergunte a get_space pelos IDs de piso atuais, IDs de peças e revisão antes de alterá-los.
Conecte seu aplicativo ou agente de IA
Um agente conectado usa o mesmo espaço de trabalho do Studio aberto que você vê. Você fornece seu próprio agente; os custos de uso do provedor dele são separados do Laydyne. Edição de espaço e preparação de cenários via MCP são gratuitas.
Aplicativos de IA: adicione uma URL
ChatGPT, Claude, GitHub Copilot e outros aplicativos que aceitam um servidor MCP personalizado (geralmente chamado de conector ou aplicativo) usam uma URL fixa. O aplicativo abre o login do Laydyne e você aprova a aba do Studio aberta que ele pode editar. Nenhuma chave de API, segredo ou link de agente é necessário.
https://laydyne.com/api/mcp/oauth
- Entre em uma conta gratuita do Laydyne e deixe o Studio aberto no seu navegador.
- No seu aplicativo de IA, adicione um servidor MCP personalizado com a URL acima. Quando solicitado, escolha OAuth e registro automático de cliente (DCR). Digite a URL exatamente como mostrado, sem uma “/” final.
- Quando o aplicativo abrir o Laydyne, entre, escolha a aba do Studio aberta e aprove-a.
- Ative o Laydyne em uma conversa e peça para chamar
get_spaceprimeiro. Peça para salvar um projeto nomeado no navegador ou exportar JSON ao terminar.
Na tabela, “esta URL” significa https://laydyne.com/api/mcp/oauth.
| Aplicativo | Onde adicionar |
|---|---|
| ChatGPT | Configurações → Segurança e login → Modo desenvolvedor. Em Plugins, adicione um aplicativo de desenvolvedor com esta URL e OAuth/DCR. Selecione-o no menu Modo desenvolvedor da conversa. Configuração oficial e elegibilidade |
| Claude | Personalizar → Conectores → Adicionar conector personalizado. Nomeie-o Laydyne e insira esta URL. Escolha Entrar agora e Registrar automaticamente (DCR), depois conecte. Ative-o em + → Conectores em um chat. Configuração oficial e elegibilidade |
| Gemini | Em contas elegíveis: Gemini web → Configurações → Aplicativos conectados (ou Inteligência pessoal → Aplicativos conectados) → Aplicativos personalizados. Adicione esta URL, complete o OAuth e selecione @Laydyne no seu prompt. Configuração oficial e elegibilidade |
| GitHub Copilot (VS Code) | Execute MCP: Adicionar servidor na Paleta de Comandos e adicione um servidor HTTP com esta URL. Entre no Laydyne e aprove quando o VS Code solicitar, depois use as ferramentas no Copilot Chat. Configuração oficial e elegibilidade |
| Outros aplicativos | Adicione um servidor MCP remoto (Streamable HTTP) com esta URL e escolha OAuth com registro automático (DCR). Se o aplicativo aceitar apenas uma chave de API ou token de portador, use Criar link de agente no Studio. |
Cada aplicativo define sua própria disponibilidade. Planos, regiões e menus mudam, então verifique a página oficial vinculada acima. Leitura, edição e salvamento por meio de cada aplicativo ainda estão sendo verificados. O acesso termina quando você desconecta ou sai, após duas horas sem uso ou dentro de 24 horas; depois, reconecte pelo aplicativo. Agentes sempre ativos, como os pontos do ChatGPT, podem usar o Laydyne apenas enquanto sua aba do Studio permanecer aberta.
Codex, Claude Code e outros clientes MCP
Agentes de codificação podem usar a mesma URL. Após adicioná-la, entre com codex mcp login\ ou claude mcp login\ (ou /mcp\ dentro do Claude Code). Cada login abre o Laydyne no seu navegador para aprovação.
codex mcp add laydyne-oauth --url https://laydyne.com/api/mcp/oauth
codex mcp login laydyne-oauth
claude mcp add --transport http laydyne-oauth https://laydyne.com/api/mcp/oauth
claude mcp login laydyne-oauth
# Optional, ~/.codex/config.toml: let Codex edit without asking each time
[mcp_servers.laydyne-oauth]
default_tools_approval_mode = "approve"
Guias para seu agente
Dê ao seu agente de codificação as regras de trabalho e prompts iniciais do Laydyne uma vez, para que ele não os redescubra em cada sessão: uma habilidade do Claude Code, uma seção para o AGENTS.md do Codex e um guia completo para qualquer agente. Aplicativos conectados também listam os prompts iniciais como prompts MCP.
mkdir -p ~/.claude/skills/laydyne
curl -fsSL https://laydyne.com/agents/laydyne/SKILL.md -o ~/.claude/skills/laydyne/SKILL.md
curl -fsSL https://laydyne.com/agents/AGENTS.md >> AGENTS.md
Para um cliente que não pode entrar com OAuth, crie um link de agente:
- Entre em uma conta gratuita do Laydyne e deixe o Studio aberto no seu navegador.
- Escolha Conectar IA → Criar link de agente. Selecione seu cliente e copie o comando ou a configuração MCP mostrada lá. O link inclui uma chave de edição privada.
- Adicione a conexão ao seu cliente e reabra a sessão para que ele carregue as novas ferramentas. Peça para chamar
get_spaceprimeiro. - Revise as edições no Studio. Peça
check_spaceantes de qualquer cálculo pago e use Desfazer se uma edição precisar ser revertida.
Use as ferramentas do Laydyne no meu Studio aberto. Leia get_space primeiro. Construa uma loja de 12 × 9 m com um balcão perto da entrada, duas fileiras de prateleiras com corredores de 1,2 m e uma mesa de exibição. Execute check_space com folga mínima de 0,9 m e corrija qualquer passagem estreita. Diga-me quais dimensões você presumiu. Não execute uma simulação ainda.
A sequência usual é get_space → create_space, edit_space ou edit_floors → check_space. As edições usam a revisão mais recente para que um agente não sobrescreva silenciosamente uma alteração mais nova. get_process_catalog descreve o esquema e exemplos de cenário; put_process_scenario salva uma definição validada sem executá-la.
Mantenha uma conexão MCP para um fluxo de trabalho. Armazene definições completas, projetos e resultados padrão em variáveis ou arquivos; imprima apenas os campos necessários para a decisão atual.
Leia um espaço desconhecido com get_space usando detail=summary ou detail=full. Uma vez que suas entradas são conhecidas, detail=status lê apenas revision, busy, Desfazer/Refazer, persistence, activeFloor, spaceHash e o resultado do processo/status de reprodução mais recente. Não combine detail=status com floor ou select. update_process_parameters mescla chaves de parâmetros existentes em um cenário salvo; copyAs copia sua definição completa para um ID e nome não utilizados primeiro. Outras condições e estudos arquivados permanecem intactos.
Ao reavaliar um estudo salvo, mantenha toda a specification padrão do estudo e altere apenas os IDs de opções relevantes e os valores de entrada solicitados pelo usuário. Use o mecanismo, avaliador e relatórios padrão. Manter uma comparação antiga não reavalia o caso alterado.
Seu projeto de trabalho é salvo no navegador. Os links MCP usam um relé de servidor do Laydyne que armazena temporariamente solicitações e resultados de ferramentas para entrega; isso não é salvamento de projeto em nuvem. O WebMCP experimental permite que um agente de navegador compatível chame as ferramentas de edição gratuitas diretamente na página, sem esse relé ou uma conta Laydyne. Nenhum dos caminhos promete uso offline: carregamento de aplicativo, verificações de conta e plano e solicitações do provedor de IA ainda podem usar a rede. As taxas e políticas de dados do seu provedor de IA se aplicam separadamente.
Proteja o link. Qualquer pessoa com sua chave pode editar a aba vinculada. Mantenha o Studio aberto; o link expira em 24 horas e termina quando você desconecta ou sai nesse navegador. Agentes de navegador podem usar o WebMCP experimental diretamente da página se o navegador deles for compatível.
Construa modelos grandes com um programa
Quando um layout segue regras (pavimentos idênticos, vários blocos de apartamentos, uma largura de corredor alterada em todos os edifícios), peça ao seu agente para escrever um programa em vez de fazer centenas de chamadas de ferramentas. O programa constrói o local com o kit Laydyne, verifica-o na sua máquina com as mesmas verificações que o Studio usa e envia o resultado através do MCP. Verificações, Desfazer e salvar ainda acontecem no seu Studio aberto.
- Leia o formato.
get_project_schemaretorna o formato do projeto salvo como JSON Schema, uma parte de cada vez, com suas regras: os pavimentos ficam no local em metros do local, e tudo em um pavimento (peças, extremidades de conexão, pontos de cenário) usa os metros desse próprio pavimento. - Use o kit.
/sdk/laydyne-kit.mjsneste site é um único arquivo JavaScript para Node.js sem dependências (tipos:/sdk/laydyne-kit.d.ts). Ele posiciona peças, paredes e portas, empilha os pavimentos de um edifício com elevador e escadas, conecta pavimentos, monta cenários e verifica o resultado. - Aplique apenas o que mudou.
apply_changesadiciona, substitui ou remove pavimentos, edifícios, conexões e cenários inteiros por id. Todo o resto permanece como está, incluindo suas próprias edições no Studio. ComdryRun, ele primeiro mostra o que seria adicionado, substituído ou perdido, e impressões digitais impedem que ele sobrescreva um pavimento que você alterou manualmente desde então.
Para fluxos de trabalho de código, /sdk/laydyne-mcp.mjs fornece um cliente MCP separado para Node.js 22+. Ele mantém uma conexão, lê resultados paginados completos e verifica transferências de projeto. Mantenha as chaves fora dos seus scripts. As mesmas permissões do Studio se aplicam.
Para reutilizar uma comparação salva, o deriveStudySpecification do kit altera IDs de opções especificados e valores de entrada com suas notas de origem. Ele preserva a pergunta, objetivos, restrições e evidências. Execute a especificação retornada por meio de run_simulation_study para avaliar as opções alteradas.
Use room(x, z, w, d, { label: "Exam room", group: "exam-room" }) para nomear as paredes geradas e seu grupo. Os diagnósticos retêm IDs de peças e mostram associação ao grupo junto com medições de folga.
Leia get_project_schema. Baixe o kit Laydyne e escreva um script Node.js que construa quatro blocos idênticos de seis pavimentos de apartamentos, cada um com elevador e escadas, em torno de um pátio compartilhado. Verifique com o kit, aplique com apply_changes (simulação primeiro) e me diga o que mudou.
Uma aplicação é uma etapa de Desfazer. Conjuntos de alterações grandes são enviados em blocos ordenados com uma soma de verificação. O formato, o kit e a aplicação de alterações são gratuitos.
Escolha o que mudar antes de gastar dinheiro com isso
Um gerente de loja pode precisar escolher onde adicionar funcionários. Um engenheiro de fábrica pode precisar escolher qual estação de trabalho mover. Um integrador de robôs pode precisar restringir uma proposta de frota antes de um teste no local. Compare essas escolhas contra a mesma demanda, um prazo ou uma meta de serviço.
- Nomeie a decisão. Uma rota de reabastecimento mais curta pode lidar com o trabalho esperado antes de adicionar um segundo assistente de estoque?
- Registre a operação atual. Meça chegadas, rotas e tempos de processamento. Verifique se a linha de base se assemelha ao local antes de confiar em um layout diferente.
- Compare opções alcançáveis. Mantenha a demanda fixa. Compare o layout atual, uma zona de descarga movida e um assistente extra. Mude um fator de cada vez para ver qual ajuda.
- Leia o resultado contra uma meta. Verifique conclusão, esperas, rotas bloqueadas e carga de trabalho juntos. Uma média rápida pode esconder trabalhos que nunca terminam.
- Conecte a diferença a um custo real. Inclua horas pagas, equipamento, instalação, supervisão e o custo da mudança. Valide a opção promissora no local.
Uma rota de reabastecimento mais curta: um cálculo ilustrativo
Suponha que uma opção economize 30 segundos por viagem de ida e volta e haja 60 viagens por dia ao longo de 22 dias úteis. Isso é 30 × 60 × 22 ÷ 3.600 = 11 horas de equipe por mês. A um custo assumido de $20 por hora, isso representa $220 de tempo de equipe.
Estes são insumos inventados para explicar a aritmética, não resultados do exemplo de vestuário publicado. Se a equipe e as horas pagas permanecerem as mesmas, a economia de caixa é $0; o benefício é tempo para outro trabalho. Economias de custo reais exigem uma mudança como menos horas extras, após subtrair o custo de reorganizar o local.
Quando isso afeta as vendas?
Esperas menores podem ajudar a atender clientes que antes saíam, mas o exemplo atual de vestuário envia cada comprador pelo mesmo percurso e não modela vendas perdidas. Uma estimativa de lucro bruto adicional exigiria compras recuperadas medidas e lucro bruto por compra, com custos operacionais adicionais deduzidos. Não transforme a redução simulada de espera em uma porcentagem de vendas.
Exemplos gerais de fluxo de trabalho calculam medidas operacionais, não uma previsão financeira completa. A comparação separada de robôs de limpeza/transporte pode usar insumos fornecidos de mão de obra e custo de robô; ainda precisa de validação no local. O rascunho de layout também tem valor: meça o tempo necessário para preparar, revisar e explicar uma proposta com seu fluxo de trabalho existente e com Laydyne.
Separe as mudanças antes de precificá-las. O projeto de vestuário inclui a configuração atual, somente checkout, somente provador e mudanças combinadas. Forneça seus custos e verifique a demanda antes de escolher um investimento.
Compare um investimento em robô com uma mudança de layout
Abra o estudo de linha de abastecimento AMR para comparar o layout atual, um segundo robô e uma coleta mais próxima. Jogue em 3D, siga o AMR 1 ou mude para o mesmo plano em 2D. Carregamento, viagem carregada, descarregamento e retorno vazio seguem o cronograma registrado. Os contadores ao vivo descrevem o tempo exibido; a tabela sempre cobre a hora completa. Alterne opções sem mudar o tempo para inspecionar o mesmo momento.
Escolha uma opção e abra seu projeto no Studio. Editar e salvar um arquivo JSON são gratuitos; verifique a Conta antes de recalcular insumos alterados. A coleta movida assume que o material já está na preparação ao lado da linha. Inclua o trabalho de reabastecimento a montante e o custo de configuração em uma decisão de investimento. A aparência humana e do robô pode ser selecionada nas condições do processo sem mudar parâmetros físicos.
Abra uma loja de vestuário, faça três mudanças e mantenha o projeto
Comece com Vestuário: provador e checkout. A página pública mostra uma renderização 3D real, o mesmo modelo em 2D e a saída do motor registrada. Selecione Abrir este exemplo e confirme a substituição no Studio. Exporte seu projeto existente primeiro se precisar de uma cópia do arquivo.
- Edite em 2D. Mude para 2D. Mova a mesa de destaque 1 m em direção à vitrine, alargue um trilho de roupas de 2,2 m para 2,6 m e gire a exibição da nova coleção de 12° para 0°. Verifique cada mudança e desfaça se necessário. As dimensões do exemplo são suposições.
- Inspecione o mesmo modelo em 3D. Os objetos, pavimentos e cenários permanecem juntos; mudar a visão não cria outro projeto. Use Verificação de rota entre as zonas de chegada, navegação, provador e checkout.
- Salve e restaure gratuitamente. Escolha Projeto → Arquivo do projeto. Reabra de Projeto → Novo espaço → Abrir arquivo. Tanto a geometria quanto a visão 2D/3D escolhida são salvas, junto com cenários e comparações congeladas. Salvar mudanças de geometria não atualiza um resultado antigo.
- Execute uma comparação justa. Retorne à geometria original antes de reproduzir o resultado publicado. O projeto inclui quatro cenários e quatro opções congeladas: 2 provadores / 1 checkout, 2 / 2, 4 / 1 e 4 / 2. Execute ou compare esses insumos sob as mesmas 36 chegadas. Compare trabalhos concluídos e esperas juntos.
Pergunte ao seu agente MCP
Após o login gratuito, use Conectar IA para vincular ChatGPT, Claude, Codex ou Claude Code a esta aba aberta do Studio. Um pedido útil é:
Inspecione o projeto de vestuário atual e sua revisão. Mova a mesa de destaque 1 m em direção à vitrine, alargue o primeiro trilho de roupas para 2,6 m e defina a rotação da exibição da nova coleção para 0°. Aplique as mudanças uma de cada vez, verificando a revisão atual. Verifique sobreposições e uma rota de comprador da chegada pela navegação, provador e checkout. Mude para 2D e exporte o projeto completo para eu restaurar depois. Mantenha a demanda do fluxo de trabalho inalterada.
get_space, edit_space, check_space e set_space_view são gratuitos. export_project e import_project transferem o projeto inteiro em blocos validados. O agente deve seguir o esquema de ferramentas atual, manter o manifesto de exportação e concluir a transação de importação. Não salve apenas o resumo de espaço menor retornado por get_space.
Peça ao seu agente para olhar o que ele construiu antes de relatar. get_view_image retorna sua visão atual como uma imagem, ou uma escolhida: uma área de pavimento, um nível, todos os níveis ou o edifício inteiro, em 2D ou 3D, de uma câmera nomeada como top ou north-east, ou focada em uma peça. As imagens permanecem dentro do limite de 1 MB do link (um PNG grande volta como JPEG, e o resultado diz isso). Tirar uma não muda sua visão ou seu histórico de desfazer. get_space_quantities retorna áreas de pavimento, zona, tag, nível e edifício e contagens de peças. Ambos são gratuitos.
Para comparar alternativas mantidas como áreas de pavimento de um nível (o presente, plano A, plano B), compare_areas lista o que foi adicionado, removido e movido entre duas delas e a diferença em área, assentos e acessórios, get_view_set desenha as mesmas visões de cada alternativa, e get_proposal_packet coleta imagens, desenhos, quantidades, mudanças e suposições em uma página HTML que imprime em PDF. Todos os três são gratuitos e não declaram custo ou previsão de vendas.
Quando um fluxo de trabalho espacial tem uma execução salva, peça ao seu agente para reproduzi-la com set_space_view usando playbackTarget: "process". Ele pode reproduzir, pausar, mudar a velocidade e buscar um tempo registrado em 2D ou 3D. Inspecione get_space.processResult.playback para o tempo final, resultados obsoletos e limites de rastreamento. A reprodução não executa um novo cálculo. Use playbackTarget: "robot" para retornar à reprodução de limpeza ou transporte.
Para outro fluxo de trabalho de loja, tente Reabastecimento de vestuário. Ele inclui um depósito no mezanino, conexão explícita de elevador e comparação de um versus dois funcionários. Ele modela trabalhos de transferência e a viagem de retorno, não inventário ou vendas.
Reprodução registrada versus nova execução. A reprodução pública usa rastreamentos salvos, não um novo cálculo de insumos editados. Revise avisos de insumos alterados em resultados antigos. Salvar no navegador, arquivos de projeto e visualizar resultados salvos permanecem gratuitos; salvar na nuvem é uma ação manual separada sujeita aos limites do seu plano.
Escolha o cálculo que corresponde à pergunta
Defina a carga de trabalho e verifique seu acesso de execução na Conta antes de executar. O mecanismo de cálculo roda no navegador; os resultados são calculados a partir do modelo e cenário, não adivinhados por um modelo de linguagem.
| Ferramenta / fluxo de trabalho | Use para | Escopo espacial |
|---|---|---|
simulate_space | Cobertura de limpeza ou transporte de duas estações | Um pavimento ativo, no máximo 60 × 60 m |
compare_cleaning_deployment | Comparar 1–8 robôs de limpeza e custos inseridos | Cena de limpeza atual |
run_process_scenario | Chegadas, serviços, esperas, recursos compartilhados e rotas | Entre pavimentos conectados, em pavimentos de qualquer tamanho |
Abra Projeto → Novo espaço → Exemplos de simulação no cabeçalho. A galeria tem 31 exemplos: Fila de serviço, Transporte, Separação de armazém, Registro de local, Visitantes de shopping, Fluxo de fábrica, Tarefas domésticas, Entregas de edifício, Serviço de café, Inspeção e retrabalho, Vestuário: provador e checkout, e Reabastecimento de vestuário. A biblioteca pública de exemplos inclui downloads de projetos, resultados registrados e links diretos para abrir cada exemplo. Cada um explica o fluxo, o que mudar e quais resultados observar. Exemplos espaciais podem abrir seu layout e cenário juntos. Abrir um exemplo não o executa.
No painel de simulação, escolha Executar simulação e depois Reproduzir agentes no plano para ver as rotas calculadas em 2D ou 3D. Ambos os controles aparecem acima dos campos de entrada do cenário. Layouts e entradas permanecem editáveis gratuitamente; verifique a Conta para acesso à execução. Para um processo personalizado, peça ao seu agente para inspecionar get_process_catalog e list_process_scenarios, depois salve uma definição completa com put_process_scenario. Use goto para caminhos através de pisos e conexões modelados; a etapa mais simples move viaja entre coordenadas e ignora obstáculos.
A escolha do modelo é importante. As amostras de fila de serviço e transporte não usam o layout visível. Use uma amostra espacial ou goto quando portas, obstáculos ou conexões entre andares devem afetar as rotas.
Veja as questões resolvidas para transporte em armazém multinível, fluxo de entrada em local de evento e cobertura de limpeza de escritório. Cada exemplo lista as entradas e o limite do seu modelo.
Experimente um experimento repetível em vários andares
- Abra Novo espaço → Shopping. Ele inclui três níveis, pisos modelados e conexões explícitas de escada rolante.
- Abra Simulação → Procurar exemplos de simulação e escolha Visitantes do shopping → Adicionar ao layout atual. Inspecione os parâmetros iniciais e escolha Executar simulação se o seu plano incluir acesso.
- Altere apenas a taxa de chegada de visitantes a pé, mantenha a mesma semente e execute novamente. Compare visitas concluídas, esperas e trabalhos bloqueados em vez de confiar apenas na animação.
- Mova uma peça bloqueante ou desconecte uma conexão de andar, execute Verificação de rota e execute novamente o cenário. Registre o novo layout e as suposições com cada resultado.
Ler e comparar resultados
Compare variantes com a mesma geometria, carga de trabalho, horizonte de tempo e semente aleatória, a menos que essa entrada seja a variável que você está testando. Altere uma suposição por vez e registre sua fonte. Cenários de processo podem relatar trabalhos concluídos e bloqueados, tempos de espera, uso de recursos e rastros de movimento. Quando um layout muda, seu resultado de processo anterior é marcado como desatualizado; execute novamente antes de citar seus números.
Repetir um cenário com a mesma semente reproduz seu resultado. Múltiplas execuções mostram variação quando um cenário contém chegadas, durações ou ramificações aleatórias. A reprodutibilidade não prova que um local se comporta da mesma maneira. Insira medições reais e compare com operações observadas antes de usar um resultado para tomar uma decisão de implantação.
Salvar e exportar seu trabalho
O Studio mantém o projeto de trabalho neste navegador. Use Projeto → Arquivo de projeto para baixar uma cópia JSON portátil e Projeto → Novo espaço → Abrir arquivo para abri-lo depois. Um link MCP edita a aba aberta; não é um repositório de projeto headless. Mantenha seus arquivos JSON se você gerenciar dados com Codex ou Claude Code.
Projeto → Desenho 2D… salva uma folha em escala desta área de piso, deste nível ou de todos os níveis como SVG ou PNG: uma escala padrão escolhida para caber no papel (A4 a A1), uma barra de escala, dimensões de contorno, nomes de zonas com suas áreas, uma tabela de áreas e um bloco de título com o projeto, a data e a versão do espaço. Zonas pequenas demais para o nome são numeradas na tabela. Adicione uma seta norte no ângulo que você definir; o modelo não armazena o norte verdadeiro. Projeto → Imagem 3D salva a visualização 3D que você vê como PNG, com legenda do que mostra e a mesma versão do espaço, para que um desenho e uma imagem possam ser correspondidos a um modelo. Seu agente recebe a mesma folha com get_view_image em 2D (format: "svg" retorna o SVG para salvar).
Seu agente MCP pode usar export_project para salvar todo o projeto como JSON e import_project para restaurá-lo. Ambos são gratuitos, incluindo todas as áreas de piso, comparações de layout salvas e configurações de visualização. Restaurar um projeto não executa uma simulação. Desfazer retorna ao projeto que você tinha antes da importação. Mantenha o Studio aberto enquanto seu agente transfere o arquivo e peça para verificar o download concluído antes de substituir seu backup.
Se Projetos na nuvem estiver habilitado no seu plano, salvar lá é uma ação separada. Abrir um projeto na nuvem o carrega no espaço de trabalho do navegador; alterações posteriores permanecem locais até você escolher salvá-las novamente na nuvem. O desenho ou foto original não está incluído no projeto salvo; mantenha o arquivo de origem separadamente.
Peça um relatório ao seu agente MCP
Peça ao seu agente conectado um layout de página próprio com texto, tabelas, desenhos, imagens e blocos de título. Criação de relatórios estáticos, edição, exportação HTML/PDF e salvamento no navegador são gratuitos.
Crie um relatório de duas páginas a partir deste modelo: um plano e dimensões primeiro, depois uma tabela de áreas de piso e suposições. Não execute uma simulação. Exporte HTML e PDF, mantenha o JSON do projeto editável e salve um projeto nomeado no navegador.
- Rascunho e revisão. O agente lê um exemplo válido curto com
get_reportview="example"(o contrato completo éview="schema"), depois usacreate_reporteedit_reportpara seu layout e alterações parciais. Peça para verificarpreview_reportantes de exportar. - Exportar.
export_reportproduz HTML ou PDF autossuficiente. PDF requer um navegador Studio aberto e conectado e preserva caminhos vetoriais e texto selecionável com fontes incorporadas; imagens incorporadas permanecem como imagens. MCP headless suporta apenas HTML. Mantenha o JSON do projeto como fonte editável. - Salvar e retomar. Peça
save_reportcom um nome eexport_projectpara o JSON do projeto inteiro. Depois, useopen_local_projectou importe o JSON, leiaget_reporte edite ou reexporte o documento salvo.
Relatórios congelam o modelo e as comparações salvas selecionadas. Métricas de comparação referenciadas adicionam páginas de evidência com valores, unidades, intervalos, condições, avisos e suposições: um resumo de uma página pode ter um apêndice de evidências. Edições ao vivo não atualizam um relatório antigo; update_report_source cria explicitamente um novo documento.
Localização e exterior opcionais
Localização e exterior são opcionais; você pode modelar um interior, salvá-lo e comparar opções sem eles.
Escolha Projeto → Projetos no navegador → Adicionar localização (ou Editar localização): um endereço sozinho não tem pino, então insira latitude e longitude manualmente para um pino; nenhuma API automática de busca de endereço é usada.
Use Salvar localização para o trabalho atual e depois Salvar trabalho atual para manter uma cópia nomeada no navegador.
Abra um modelo salvo de Lista, ou escolha Locais, selecione um pino e pressione Abrir.
Com MCP, get_project_location e set_project_location leem e atualizam a localização; get_exterior e edit_exterior leem e alteram paredes externas, janelas, entradas e telhados.
O que o resultado pode e não pode dizer a você
Os resultados vêm de um modelo simplificado e determinístico: robôs são círculos movendo-se a velocidade constante, e a mesma entrada sempre dá o mesmo resultado. Ele não modela colisões ou evasão entre robôs ou pessoas (apenas capacidades e filas), física de multidões, controle otimizado de grupo de elevadores (cabines seguem regras fixas simples), curvas ou qualidade de limpeza. Baterias, quando um cenário as fornece, descarregam em linha reta e carregam a uma taxa constante. Dimensões lidas de fotos e desenhos são suposições a verificar com medições. É para explorar opções, não uma previsão calibrada de um local real.
- Cenários de processo contam capacidades e esperas FIFO, mas não modelam evasão de colisão, ultrapassagem, pressão de multidão ou velocidade de caminhada dependente de densidade.
- Viagem de elevador usa velocidade e capacidade; despacho e seleção de parada não são modelados. As esperas podem, portanto, ser baixas demais.
- Tempo de abertura de porta, aceleração, curvas, carregamento, quebras, evacuação e conformidade com códigos de segurança estão fora do modelo.
- Uma verificação de rota verifica a geometria simplificada e as folgas declaradas. Ela não pode verificar se seu desenho, tamanhos de objetos ou suposições operacionais correspondem a um local real.
Use Laydyne para reduzir opções e expor suposições. Confirme folgas críticas, capacidade e custos com medições e ferramentas especializadas quando necessário.
Solução de problemas
Meu agente MCP não consegue alcançar o Studio.
Mantenha a aba do Studio vinculada aberta, reabra seu cliente de IA após adicionar sua configuração MCP e crie um novo link se o antigo terminou. Não publique a chave do link.
Uma edição diz que a revisão está desatualizada ou expira.
Peça ao agente para chamar get_space antes de tentar novamente. Uma edição que expirou pode já ter sido aplicada, então inspecione o modelo atual primeiro.
Uma rota não consegue alcançar outro andar.
Verifique se as duas áreas de piso têm uma conexão explícita, se o tipo de agente pode usar essa conexão e se nenhuma âncora ou passagem está bloqueada. check_space pode retornar um motivo de falha de rota.
Uma simulação diz que assinatura é necessária.
Edição, verificações de rota e definições de cenário permanecem disponíveis. As ferramentas de execução exigem acesso ativo à simulação; verifique o plano mostrado na sua conta.