APS və MCP ilə Revit Cloud Worksharing miqrasiya axını necə qurulur?

Bu bələdçidə nə öyrənəcəksiniz?

Bu bələdçi APS ilə əlaqə quran Model Context Protocol (MCP) serverində Revit Cloud Worksharing (RCW) miqrasiya axınının necə qurulmasını izah edir. Autodesk-in nümunəsi MCP müştərisinin təbii dildəki sorğunu alət çağırışlarına çevirməsini, serverin APS əməliyyatlarını idarə etməsini və Revit avtomatlaşdırmasının modeli köçürməsini göstərir. Buradakı addımlar nümunə arxitekturanı anlamaq üçündür; istehsal mühiti üçün hazır, hər layihəyə birbaşa tətbiq edilə bilən quraşdırma təlimatı deyil.

Əsas fərq budur: süni intellekt müştərisi miqrasiya qərarını və alət çağırışlarını əlaqələndirir; model üzərində faktiki əməliyyat isə Revit API-dən istifadə edən Design Automation for Revit tərəfində icra olunur. MCP serveri iki tərəf arasındakı əməliyyatları və icazələri idarə edir.

Tələblər və giriş

Autodesk-in nümunəsi Node.js əsaslı MCP serverini APS funksiyaları ilə genişləndirir. MCP serveri uyğun müştəriyə qoşulmalı, mənbə modelin və hədəf layihənin yerləşdiyi APS məlumatlarına giriş əldə etməlidir. Revit avtomatlaşdırmasının işləməsi üçün miqrasiyaya uyğun Revit mühərriki və konfiqurasiya edilmiş avtomatlaşdırma fəaliyyətləri də tələb olunur. Mənbədə konkret Node.js versiyası və ya qiymət barədə məlumat verilmədiyindən burada versiya və ya xərc fərziyyəsi irəli sürülməməlidir.

Autentifikasiya seçimi serverin harada işləməsindən və əməliyyatın kimin məlumatları üzərində aparılmasından asılıdır. Yerli masaüstü müştərisinin STDIO vasitəsilə başladığı serverdə müştəri-server səviyyəsində ayrıca autentifikasiya tələb olunmaya bilər. APS tərəfində istifadəçi adından əməliyyat aparmaq üçün 3-legged OAuth (3LO) və ya gizli açarın saxlanmasının mümkün olmadığı yerli proses kimi hallarda PKCE istifadə edilə bilər. Server üzrə paylaşılan tətbiq identifikatorunun tələb olunduğu işlərdə 2-legged OAuth (2LO) və ya giriş icazəsi verilmiş Secure Service Account (SSA) seçimləri nəzərdən keçirilir. Nəzərə alın ki, hər API hər autentifikasiya növünü qəbul etmir.

Miqrasiya axınını addım-addım planlaşdırın

1. İstifadə ssenarisini və müştərini müəyyənləşdirin. Əvvəlcə əməliyyatın istifadəçinin öz giriş məlumatları ilə, yoxsa ümumi avtomatlaşdırma identifikatoru ilə aparılacağını dəqiqləşdirin. Sonra MCP serverinin yerli proses kimi işləyəcəyini, yoxsa HTTP vasitəsilə uzaqdan təqdim ediləcəyini seçin. Autodesk-in bələdçisi yerli istifadə üçün STDIO-nu, uzaqdan və çoxistifadəçili ssenarilər üçün isə Streamable HTTP-ni nəzərdən keçirir. HTTP-yə açıq serverlərdə müştəri-server autentifikasiyası APS autentifikasiyasından ayrıca layihələndirilməlidir.

2. APS autentifikasiya üsulunu tələb olunan icazələrə uyğun seçin. İstifadəçinin şəxsi məlumatlarına giriş üçün istifadəçinin daxil olmasına əsaslanan 3LO və ya PKCE nəzərdən keçirilir. Tətbiqin öz resursları üçün 2LO istifadə oluna bilər, lakin bu üsul istifadəçi konteksti tələb edən API çağırışları üçün yetərli olmaya bilər. Avtomatlaşdırmanın istifadəçinin davamlı giriş etməsinə ehtiyac olmadan layihə məlumatlarına çıxışı tələb olunursa, hədəf hub və layihələrə icazə verilmiş SSA nəzərdən keçirilə bilər. Serverlə müştəri arasındakı giriş tokenini APS tokeni ilə qarışdırmayın; bu iki səviyyənin tokenləri fərqli məqsədlərə xidmət edir.

3. MCP alətlərinin vəzifələrini ayırın. Autodesk nümunəsində server mövcud məlumatların idarə edilməsi alətləri ilə layihə və qovluqları tapa bilir; qovluğun məzmunundakı extensionType sahəsi RCW modellərini müəyyənləşdirməyə kömək edir. Miqrasiya üçün əlavə edilmiş migrate-rcw-model aləti mənbə modelini, hədəf layihə və qovluğu, həmçinin hədəf Revit versiyasını qəbul edir. Tətbiq bu məlumatlarla APS Automation işini hazırlayıb göndərir. Alətləri layihələndirərkən axtarışla məlumatı dəyişdirən miqrasiya əməliyyatını ayrı saxlamaq müştəriyə hansı əməliyyatı başlatdığını aydın göstərir.

4. İlkin şərtləri yoxladın və istifadəçinin təsdiqini alın. Nümunə axında check-migrator-setup konfiqurasiya edilmiş Revit mühərriklərini və avtomatlaşdırma fəaliyyətlərini yoxlamaq üçün nəzərdə tutulub. Autodesk bildirir ki, iş axınının təlimatları köməkçini ilkin şərtləri yoxlamağa və miqrasiyadan əvvəl istifadəçidən təsdiq istəməyə yönləndirə bilər. Hədəf layihə, qovluq və Revit versiyası dəqiqləşmədən miqrasiya işini göndərməyin; bu seçimləri istifadəçinin sorğusu ilə təsdiqləyin.

5. Asinxron işi izlənə bilən edin. Miqrasiya bir neçə dəqiqə çəkə biləcəyindən, alətin iş identifikatorunu qaytarması işin tamamlandığı demək deyil. Nümunədə get-migration-status işin vəziyyətini və xəta məlumatını alır; cancel-migration isə gözləyən işlərin ləğvini tələb edir. MCP Apps istifadə edən uyğun müştərilərdə vəziyyət paneli aktiv işləri, tamamlanmış miqrasiyaları, xəta təfərrüatlarını və ləğvetmə idarəetmələrini göstərə bilər. Bu təbəqə miqrasiya işini başladan alətdən ayrıca nəzərdən keçirilməlidir.

6. İş axınını təhlükəsiz və məhdud şəkildə sınayın. Əvvəlcə əlçatan modellərin siyahılanmasını və konfiqurasiya yoxlamasını təsdiqləyin. Sonra istifadəçinin təsdiqi ilə bir modeli hədəf layihəyə göndərin və iş identifikatorunun, vəziyyətin və xəta məlumatının gözlənildiyi kimi qaytarıldığını yoxlayın. APS tokenlərini müştəriyə vermək və ya müştəri tokenini birbaşa APS-ə ötürmək düzgün yanaşma deyil. Uzaqdakı MCP serveri üçün serverə kimin giriş əldə edə biləcəyini də müəyyənləşdirin; bu, APS-in hansı identifikatorla işlədiyini təyin edən təbəqədən fərqlidir.

Memarlıq və vizuallaşdırma iş axınları üçün əhəmiyyəti

Bir neçə Revit layihəsi və ya RCW modeli ilə işləyən memarlıq ofisləri miqrasiyanı təbii dildə başlatmaq və gedişatı eyni müştəridə izləmək imkanından yararlana bilər. Tərtibatçılar üçün MCP alətləri mövcud APS avtomatlaşdırmasını müxtəlif uyğun müştərilərə qoşmaq üçün nümunə təqdim edir. Ancaq bu, BIM koordinasiyası və ya model asılılıqlarının təhlili məsələlərini öz-özünə həll etmir.

Mənbələrdə avadanlıq və ya lisenziya xərcləri barədə məlumat yoxdur. Buna görə qərar verməzdən əvvəl təşkilatın APS girişini, seçilmiş Revit avtomatlaşdırma konfiqurasiyasını və istifadə ediləcək autentifikasiya üsulunun layihə icazələrinə uyğunluğunu ayrıca yoxlamaq lazımdır. Xüsusilə əlaqələndirilmiş modellərlə işləyən komandalar köçürülən modelin əlaqəli modellərinin də daşındığını güman etməməlidir.

Tez-tez edilən səhvlər və növbəti addımlar

Nümunənin əsas məhdudiyyəti ayrı-ayrı RCW modellərinə fokuslanmasıdır: əlaqələndirilmiş modellərin münasibətlərini avtomatik köçürmür və hədəf layihədəki bağlantıları bərpa etmir. Əlaqələndirilmiş modelləri olan layihələrdə asılılıqların təhlili, ilkin yoxlama və koordinasiya ayrıca tələb olunur; mənbə bunları gələcəkdə əlavə oluna biləcək imkanlar kimi nəzərdən keçirir.

Digər geniş yayılmış layihələndirmə xətası MCP müştərisi ilə server arasındakı autentifikasiyanı APS-ə girişlə eyni hesab etməkdir. Əvvəlcə hər təbəqədə hansı tərəfin kimə qarşı autentifikasiya olunduğunu müəyyənləşdirin. Sonra alətləri, icazələri və istifadəçi təsdiqini bu fərq əsasında yoxlayın. Texniki tətbiqə başlayarkən Autodesk-in nümunə deposunu və APS MCP autentifikasiya nümunələrini başlanğıc nöqtəsi kimi götürün; istehsal mühiti üçün təhlükəsizlik və əlaqələndirilmiş model tələblərini ayrıca təmin edin.

Mənbə və lisenziya

Məzmun Autodesk Platform Services-ın “Bringing Revit Cloud Worksharing Migration to AI Assistants with APS and MCP”, “Building Custom MCP Servers with Autodesk Platform Services” və “Authentication Patterns for APS MCP Servers” bələdçilərindən uyğunlaşdırılıb. Təqdim olunan mənbə qeydlərində lisenziya statusu serbest kimi göstərilib, lakin konkret açıq lisenziyanın adı verilməyib; buna görə məzmun CC BY kimi lisenziya ilə yayımlanıb kimi təqdim edilməyib.