Manual do RotoSpider › Compartilhe e peça ajuda

Pergunte a um assistente de IA ou chame a WebAPI

Descreve o RotoSpider Web App 0.8.13 e Desktop 0.8.14 · conferida em 2026-09-13 D5

O motor de distribuição do RotoSpider pode ser consultado sem abrir o RotoSpider: por um assistente de IA que conversa com ele por MCP, ou pelo seu próprio software por uma API web. Os dois respondem à mesma pergunta que os apps respondem, se um conjunto de moldes cabe num braço e como, e os dois são hoje serviços públicos de avaliação. Esta página diz para que serve cada um e onde estão os detalhes; as páginas do próprio site trazem os passos de conexão, os esquemas e o código de exemplo, e são mantidas em dia com o serviço.

Um assistente de IA, por MCP

Um assistente que aceita servidores MCP remotos (o Model Context Protocol) pode reunir na conversa os tamanhos dos moldes, as quantidades e os dados do braço e depois chamar o RotoSpider para ter a resposta física, em vez de adivinhar a partir do texto. O RotoSpider continua responsável por dizer se os moldes cabem; o assistente organiza os dados e explica o resultado.

A conexão é um servidor MCP personalizado, Streamable HTTP, em:

https://www.rotospider.com/roto/mcp

Dê a ele o nome "RotoSpider" nas configurações de conectores do assistente e pergunte com dimensões e unidades: forma, tamanho, quantidade e o braço ou uma máquina de exemplo pública. O assistente pede o que falta, como a distância entre moldes. O que volta é uma resposta de distribuição verificável: se todos os moldes pedidos foram colocados, as quantidades pedidas e colocadas por molde, a distância entre moldes e o aproveitamento do prato, a base de elevação escolhida num braço offset L e as coordenadas de posição ligadas ao braço.

A página de MCP do site tem os três passos de conexão, uma pergunta de exemplo e os limites de uso: o assistente não deve concluir que os moldes cabem a partir de nomes ou de texto, inventar dimensões de máquina nem tratar as máquinas de exemplo públicas como dados da sua fábrica.

O seu próprio software, pela WebAPI

Esta API é oferecida em caráter de avaliação e pode mudar. Se você precisar manter uma versão específica, escreva para [email protected] para registrá-la, para que o seu serviço não seja interrompido.

Uma verificação de distribuição é uma requisição HTTPS com um corpo JSON:

POST https://www.rotospider.com/roto/api/layout/check

Envie os moldes como caixas ou cilindros com as suas dimensões, ou como uma forma exata preparada, pela identidade dela, com uma máquina de exemplo pública ou com a geometria do seu próprio braço (reto ou offset, prato, diâmetro de giro, bases de elevação). Você recebe de volta se o pedido está completo, as quantidades pedidas e colocadas, a distância entre moldes, o aproveitamento, a base de elevação escolhida, a geometria de braço usada e as coordenadas de posição. Os comprimentos são campos explícitos em milímetros numa grade de 0,001 mm, ou campos em polegadas pelo nome; os valores físicos do resultado ficam em milímetros.

As formas exatas são construídas uma vez e depois referenciadas: uma requisição publica uma forma construída (um L, um triângulo, uma cunha, um tronco de cone ou uma área ocupada desenhada) ou importa um arquivo .rotogeom ou .rotoshape preparado, e devolve a identidade a enviar com o molde. O serviço não aceita arquivos STEP brutos; um arquivo STEP é preparado no app desktop para Windows, como a página de importação descreve, e o pacote portátil dele é o que a API aceita.

A página da WebAPI do site traz o contrato, a descrição OpenAPI e os exemplos da prévia para desenvolvedores: requisições equivalentes em milímetros e em polegadas, com clientes em Python, JavaScript, curl e PowerShell que você pode rodar como estão.

Antes de depender de qualquer um dos dois

Os dois serviços são para avaliação. Eles têm limite de requisições, não têm nível de serviço de produção, e os seus esquemas ainda estão mudando. Não envie pedidos confidenciais nem dados de cadastro aos serviços públicos antes de o tratamento dos dados e o acesso estarem combinados para a sua integração; a página Sobre é onde essa conversa começa. Uma integração de fábrica traz a sua própria geometria de máquina, braço e prato, o seu cadastro de moldes e as suas regras de planejamento, e combina antes o versionamento, a capacidade e o acesso.