Podręcznik RotoSpider › Udostępnij i uzyskaj pomoc

Zapytaj asystenta AI lub wywołaj WebAPI

Dotyczy: RotoSpider Web App 0.8.13 i Desktop 0.8.14 · sprawdzono: 2026-09-13 D5

Silnik rozmieszczania programu RotoSpider można zapytać w ogóle bez otwierania programu RotoSpider: przez asystenta AI, który komunikuje się z nim przez MCP, albo przez własne oprogramowanie przez web API. Oba sposoby odpowiadają na to samo pytanie co aplikacje, czyli czy i jak zestaw form mieści się na ramieniu, i oba są dziś publicznymi usługami do oceny. Ta strona mówi, do czego służy każdy z nich i gdzie są szczegóły; własne strony witryny zawierają kroki połączenia, schematy i przykładowy kod i są aktualizowane razem z usługą.

Asystent AI przez MCP

Asystent, który obsługuje zdalne serwery MCP (Model Context Protocol), może w rozmowie zebrać wymiary form, liczby sztuk i dane ramienia, a następnie wywołać RotoSpider, aby uzyskać odpowiedź fizyczną zamiast zgadywać na podstawie tekstu. RotoSpider odpowiada za to, czy formy się mieszczą; asystent porządkuje dane wejściowe i objaśnia wynik.

Połączenie to jeden niestandardowy serwer MCP, Streamable HTTP, pod adresem:

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

Nazwij go „RotoSpider” w ustawieniach konektorów asystenta, a następnie pytaj, podając wymiary i jednostki: kształt, rozmiar, liczbę sztuk oraz ramię lub publiczną przykładową maszynę. Asystent zapyta o to, czego brakuje, na przykład o odstęp. W odpowiedzi otrzymujesz rozmieszczenie, które można sprawdzić: czy umieszczono każdą żądaną formę, liczby żądane i umieszczone dla każdej formy, odstęp i wykorzystanie płyty, podwyższenie wybrane na ramieniu typu L oraz współrzędne położeń powiązane z ramieniem.

Strona MCP EN w witrynie zawiera trzy kroki połączenia, przykładowe pytanie i granice działania: asystent nie powinien wnioskować z nazw ani opisów, że formy się mieszczą, wymyślać wymiarów maszyn ani traktować publicznych przykładowych maszyn jako danych twojej fabryki.

Własne oprogramowanie przez WebAPI

To API jest udostępniane w wersji próbnej i może się zmieniać. Jeśli potrzebujesz zachować konkretną wersję, napisz na adres [email protected], aby ją zarejestrować, tak by twoja usługa nie została zakłócona.

Sprawdzenie rozmieszczenia to jedno żądanie HTTPS z treścią JSON:

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

Wyślij formy jako prostopadłościany lub walce z ich wymiarami albo jako dokładny przygotowany kształt wskazany identyfikatorem, razem z publiczną przykładową maszyną albo geometrią własnego ramienia (proste lub typu L, płyta, strefa obrotu, podwyższenia). W odpowiedzi otrzymujesz informację, czy zapotrzebowanie jest kompletne, liczby żądane i umieszczone, odstęp, wykorzystanie płyty, wybór podwyższenia, użytą geometrię ramienia i współrzędne położeń. Długości to jawne pola w milimetrach na siatce 0,001 mm albo pola calowe wskazane nazwą; fizyczne wartości wyniku są w milimetrach.

Dokładne kształty buduje się raz, a potem się do nich odwołuje: jedno żądanie publikuje zbudowany kształt (L, trójkąt, klin, stożek ścięty lub narysowany obrys podstawy) albo importuje przygotowany plik .rotogeom lub .rotoshape i zwraca identyfikator, który wysyła się razem z formą. Usługa nie przyjmuje surowych plików STEP; plik STEP przygotowuje się w aplikacji desktopowej dla systemu Windows, jak opisuje strona o imporcie, a API przyjmuje jego przenośny pakiet.

Strona WebAPI EN w witrynie zawiera kontrakt, opis OpenAPI i przykłady dla programistów w wersji zapoznawczej EN: odpowiadające sobie żądania w milimetrach i calach z klientami w Pythonie, JavaScripcie, curl i PowerShellu, które można uruchomić bez zmian.

Zanim zaczniesz polegać na którejkolwiek z usług

Obie usługi służą do oceny. Mają limity liczby żądań, nie mają produkcyjnego poziomu usług, a ich schematy wciąż się zmieniają. Nie wysyłaj do publicznych usług poufnych zamówień ani danych podstawowych, dopóki nie zostaną uzgodnione zasady przetwarzania danych i dostępu dla twojej integracji; ta rozmowa zaczyna się od strony „O nas”. Integracja z fabryką wnosi własną geometrię maszyn, ramion i płyt, dane podstawowe form i zasady planowania, a najpierw uzgadnia wersjonowanie, przepustowość i dostęp.