Manuel de RotoSpider › Partager et obtenir de l'aide

Demander à un assistant d'IA ou appeler la WebAPI

Décrit RotoSpider Web App 0.8.13 et Desktop 0.8.14 · vérifiée le 2026-09-13 D5

On peut interroger le moteur de disposition de RotoSpider sans même ouvrir RotoSpider : par un assistant d'IA qui lui parle par MCP, ou par votre propre logiciel par une API Web. Les deux répondent à la même question que les applications, à savoir si un ensemble de moules tient sur un bras et comment, et les deux sont aujourd'hui des services publics d'évaluation. Cette page indique à quoi sert chacun et où trouver les détails; les pages du site donnent les étapes de connexion, les schémas et le code d'exemple, et elles sont tenues à jour avec le service.

Un assistant d'IA, par MCP

Un assistant qui prend en charge les serveurs MCP distants (le Model Context Protocol) peut recueillir au fil de la conversation les dimensions des moules, les quantités et les caractéristiques du bras, puis appeler RotoSpider pour obtenir la réponse physique au lieu de la deviner à partir du texte. RotoSpider reste responsable de dire si les moules tiennent; l'assistant organise les données et explique le résultat.

La connexion est un seul serveur MCP personnalisé, en Streamable HTTP, à l'adresse :

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

Nommez-le « RotoSpider » dans les paramètres de connecteurs de l'assistant, puis posez votre question avec les dimensions et les unités : la forme, les dimensions, le nombre, et le bras ou une machine d'exemple publique. L'assistant demande ce qui manque, par exemple l'espace libre. Ce qui revient est une réponse de disposition vérifiable : si chaque moule demandé a été placé, les nombres demandés et placés par moule, l'espace libre et le taux d'occupation de l'araignée, la rehausse choisie sur un bras coudé (en L), et les coordonnées de placement rapportées au bras.

La page MCP EN du site donne les trois étapes de connexion, un exemple de question et les limites de travail : l'assistant ne doit pas conclure que des moules tiennent à partir de noms ou de texte, ni inventer des dimensions de machine, ni traiter les machines d'exemple publiques comme les données de votre usine.

Votre propre logiciel, par la WebAPI

Cette API est fournie à titre d'essai et peut changer. Si vous devez garder une version précise, écrivez à [email protected] pour l'enregistrer, afin que votre service ne soit pas interrompu.

Une vérification de disposition est une seule requête HTTPS avec un corps JSON :

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

Envoyez les moules comme des boîtes ou des cylindres avec leurs dimensions, ou comme une forme exacte préparée, désignée par son identifiant, avec soit une machine d'exemple publique, soit la géométrie de votre propre bras (droit ou coudé, araignée, diamètre de rotation, rehausses). Vous recevez en retour si la demande est complète, les nombres demandés et placés, l'espace libre, le taux d'occupation, le choix de rehausse, la géométrie du bras utilisée et les coordonnées de placement. Les longueurs sont des champs explicites en millimètres sur une grille de 0,001 mm, ou des champs en pouces désignés par leur nom; les valeurs physiques du résultat sont en millimètres.

Les formes exactes se construisent une seule fois, puis on y fait référence : une requête publie une forme construite (un L, un triangle, un biseau, un cylindre conique ou une emprise dessinée) ou importe un fichier préparé .rotogeom ou .rotoshape, et renvoie l'identifiant à envoyer avec le moule. Le service n'accepte pas les fichiers STEP bruts; un fichier STEP se prépare dans l'application de bureau pour Windows, comme le décrit la page sur l'importation, et c'est son paquet portable que l'API prend.

La page WebAPI EN du site contient le contrat, la description OpenAPI et les exemples en avant-première pour les développeurs EN : des requêtes équivalentes en millimètres et en pouces, avec des clients Python, JavaScript, curl et PowerShell que vous pouvez lancer tels quels.

Avant de vous fier à l'un ou à l'autre

Les deux services servent à l'évaluation. Leur débit est limité, ils n'ont pas de niveau de service de production, et leurs schémas évoluent encore. N'envoyez pas de commandes confidentielles ni de données de base aux services publics tant que le traitement des données et l'accès n'ont pas été convenus pour votre intégration; la page À propos EN est l'endroit où cette discussion commence. Une intégration en usine apporte sa propre géométrie de machine, de bras et d'araignée, ses données de base de moules et ses règles de planification, et convient d'abord des versions, de la capacité et de l'accès.