دليل RotoSpider › المشاركة والحصول على المساعدة

سؤال مساعد ذكاء اصطناعي أو استدعاء WebAPI

تصف RotoSpider Web App 0.8.13 و Desktop 0.8.14 · رُوجعت في ‎2026-09-13 D5

يمكن سؤال محرك التخطيط في RotoSpider دون فتح RotoSpider إطلاقًا: من خلال مساعد ذكاء اصطناعي يتحدث إليه عبر MCP، أو من خلال برامجك الخاصة عبر واجهة برمجة تطبيقات على الويب. وكلاهما يجيب عن السؤال نفسه الذي يجيب عنه التطبيقان، هل تتسع مجموعة من القوالب على ذراع وكيف، وكلاهما اليوم خدمة تقييم عامة. تبيّن هذه الصفحة الغرض من كل منهما وأين توجد التفاصيل؛ أما صفحات الموقع نفسه ففيها خطوات الاتصال ومخططات البيانات والشيفرة النموذجية، وتُحدَّث مع الخدمة.

مساعد ذكاء اصطناعي، عبر MCP

يستطيع المساعد الذي يدعم خوادم MCP البعيدة (أي بروتوكول Model Context Protocol) أن يجمع مقاسات القوالب وكمياتها وتفاصيل الذراع في المحادثة، ثم يستدعي RotoSpider للحصول على الجواب الفيزيائي بدلًا من التخمين من النص. ويبقى RotoSpider مسؤولًا عن الحكم هل تتسع القوالب؛ أما المساعد فينظّم المدخلات ويشرح النتيجة.

والاتصال خادم MCP مخصص واحد، من نوع Streamable HTTP، على العنوان:

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

سمِّه "RotoSpider" في إعدادات الموصلات لدى المساعد، ثم اسأل مع ذكر الأبعاد والوحدات: الشكل، والمقاس، والعدد، والذراع أو ماكينة نموذجية عامة. ويسأل المساعد عما ينقص، مثل الخلوص. وما يعود جواب تخطيط يمكن التحقق منه: هل وُضع كل قالب مطلوب، والعدد المطلوب والعدد الموضوع لكل قالب، والخلوص ونسبة استغلال اللوح، وقاعدة الرفع المختارة في ذراع الإزاحة على شكل L، وإحداثيات المواضع المرتبطة بالذراع.

وفي صفحة MCP EN على الموقع خطوات الاتصال الثلاث، وسؤال نموذجي، وحدود العمل: فلا ينبغي للمساعد أن يستنتج اتساع القوالب من الأسماء أو من النص، ولا أن يخترع أبعاد الماكينات، ولا أن يعامل الماكينات النموذجية العامة على أنها بيانات مصنعك.

برامجك الخاصة، عبر WebAPI

تُقدَّم واجهة برمجة التطبيقات هذه تجريبيًا وقد تتغير. وإذا احتجت إلى الإبقاء على إصدار معين، فراسل [email protected] لتسجيله، حتى لا تتعطل خدمتك.

التحقق من التخطيط طلب HTTPS واحد بمتن JSON:

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

أرسل القوالب صناديقَ أو أسطوانات بأبعادها، أو شكلًا دقيقًا مُعدًّا بمعرّفه، مع ماكينة نموذجية عامة أو مع هندسة ذراعك أنت (مستقيم أو إزاحة، واللوح، ونطاق الدوران، وقواعد الرفع). ويعود إليك: هل الطلب مكتمل، والعدد المطلوب والعدد الموضوع، والخلوص، ونسبة الاستغلال، وقاعدة الرفع المختارة، وهندسة الذراع المستخدمة، وإحداثيات المواضع. والأطوال حقول صريحة بالمليمتر على شبكة دقتها 0.001 مم، أو حقول بالبوصة تُعرف بأسمائها؛ والقيم الفيزيائية في النتيجة بالمليمتر.

تُنشأ الأشكال الدقيقة مرة واحدة ثم يُشار إليها: فطلب واحد ينشر شكلًا منشأً (شكل L، أو مثلثًا، أو سطحًا علويًا مائلًا، أو أسطوانة مخروطية، أو بصمة مرسومة) أو يستورد ملف .rotogeom أو .rotoshape مُعدًّا، ويعيد المعرّف الذي يُرسل مع القالب. ولا تقبل الخدمة ملفات STEP الخام؛ فملف STEP يُعدّ في تطبيق سطح المكتب على Windows، كما تصف صفحة الاستيراد، وحزمته القابلة للنقل هي ما تأخذه واجهة برمجة التطبيقات.

وفي صفحة WebAPI EN على الموقع العقد، ووصف OpenAPI، وعينات المعاينة للمطورين EN: طلبات متقابلة بالمليمتر وبالبوصة مع برامج عميلة بـ Python و JavaScript و curl و PowerShell يمكنك تشغيلها كما هي.

قبل أن تعتمد على أي منهما

الخدمتان كلتاهما للتقييم. فهما محدودتان بعدد الطلبات، وليس لهما مستوى خدمة إنتاجي، ومخططات بياناتهما ما زالت تتغير. لا ترسل طلبيات سرية أو بيانات أساسية إلى الخدمات العامة حتى يُتفق على معالجة البيانات والوصول إليها في تكاملك؛ وصفحة من نحن هي حيث يبدأ هذا الحديث. والتكامل الخاص بمصنع يأتي بهندسة ماكيناته وأذرعه وألواحه، وبيانات قوالبه الأساسية، وقواعد تخطيطه، ويتفق أولًا على الإصدارات والسعة والوصول.