Tekoälyagentti ja skriptit käyttävät samoja komentoja kuin sinä
Jokainen piirustukseen tehtävä muutos on nimetty komento, esimerkiksi wall.room_rect. Myös tallennus ja vienti ovat komentoja, esimerkiksi export.pdf. Samat komennot toimivat ikkunan komentorivillä ja pirtocad-cli-skripteissä, ja MCP-palvelin tarjoaa ne tekoälyagentille.
# Ikkunan komentorivi (F2) wall.room_rect # Skripti päätteessä pirtocad-cli script huone.jsonl # MCP-palvelin agentille pirtocad-cli mcp
Kolme reittiä samoihin komentoihin
Ikkuna, komentorivityökalu pirtocad-cli ja MCP-palvelin käyttävät samaa komentorekisteriä, joten komennon tunnus ja parametrit ovat samat joka reitillä. Muutama komento toimii vain yhdellä reitillä: esimerkiksi 3D-näkymän kuvan voi tallentaa vain ikkunassa.
Komentorivi ikkunassa
Paina F2 ja kirjoita piirtoalueen alla olevalle komentoriville komennon tunnus, esimerkiksi revision.delete, tai komennon suomenkielinen nimi. Komentorivi kysyy pakolliset arvot yksi kerrallaan, ja merkintä nimi=arvo asettaa valinnaisen arvon. Enter suorittaa komennon yhtenä kumottavana vaiheena.
Skriptit: pirtocad-cli
pirtocad-cli script TIEDOSTO.jsonl suorittaa tiedoston komennot, yksi JSON-olio riviä kohden. Jokainen rivi saa vastauksen, jossa on joko "ok": true ja tulos tai "ok": false ja virhe. Jokainen ajo alkaa tyhjästä istunnosta: avaa ensin projekti komennolla project.open tai luo uusi, ja tallenna työ lopuksi komennolla project.save.
Agentit: pirtocad-cli mcp
pirtocad-cli mcp on MCP-palvelin (JSON-RPC), joka viestii agentin kanssa vakiosyötteen ja -tulosteen kautta. Se tarjoaa jokaisen komennon työkaluna parametreineen, ja automaattinen testi varmistaa, ettei työkaluluettelosta puutu yhtään komentoa. Rekisteröintiesimerkki on ohjelman mukana tulevan käyttöoppaan luvussa 11. Tekoälyagentit piirtävät jo PirtoCADilla pirtocad-cli-työkalun kautta. MCP-reitillä työpöydän tekoälysovelluksella on toistaiseksi kokeiltu vain yhteyden muodostamista ja työkaluluettelon hakemista, ei vielä piirtämistä. Työkaluluettelo on noin 3 Mt, joten asiakkaan on ladattava työkalut tarpeen mukaan; kaikki asiakkaat eivät siihen pysty.
Mukana asennuspaketissa
- macOS-paketissa
pirtocad-clijapirtocad-mcpovat kansiossaPirtoCAD.app/Contents/MacOS/.pirtocad-mcpon sama MCP-palvelin kuinpirtocad-cli mcp, omana ohjelmanaan. - Automaattinen testi varmistaa, että jokaista työkalurivin työkalua vastaa komento, jota agentti voi käyttää.
- Ikkunan omat toiminnot, kuten paneelien avaaminen, eivät ole piirustuskomentoja.
Esimerkki: huone, mitat ja PDF
Tallenna rivit tiedostoksi huone.jsonl, vaihda polut osoittamaan omaan kansioosi ja suorita tiedosto. Mitat ovat millimetreinä. Alin rivi on lyhennetty: oikeassa vastauksessa on lisäksi muun muassa arkit, kerrosviite (storey_ref) ja muutosluettelo.
# huone.jsonl {"command":"project.new","params":{"name":"Esimerkkitalo","paper_mm":[420,297],"scale":50}} {"command":"storey.add","params":{"where":"top","copy_walls":false,"name":"Pohjakerros"}} {"command":"wall.room_rect","params":{"p1":[3000,3000],"p2":[10000,8500],"thickness":200}} {"command":"dimension.auto_insert","params":{}} {"command":"project.save","params":{"path":"/absoluuttinen/polku/Esimerkkitalo.ifc"}} {"command":"export.pdf","params":{"path":"/absoluuttinen/polku/Esimerkkitalo.pdf"}} # suoritus ja rivin 2 vastaus (lyhennetty) pirtocad-cli script huone.jsonl {"command":"storey.add","line":2,"ok":true,"result":{"id":"floor-1"}}
Mitä rivit tekevät
- Luodaan uusi projekti A3-arkille (420 × 297 mm) mittakaavaan 1:50.
- Lisätään kerros nimeltä Pohjakerros.
- Piirretään huone, jonka vastakkaiset kulmat ovat pisteissä (3000; 3000) ja (10000; 8500): 7 × 5,5 m:n suorakaide, seinän paksuus 200 mm.
- Lisätään mitat automaattisesti.
- Tallennetaan projekti IFC-tiedostoon ja viedään arkki PDF-tiedostoksi.
Avaa tallennettu projekti valitsemalla Tiedosto > Avaa projekti…, niin näet saman huoneen mittoineen ikkunassa.
Agentti näkee, mitä se tekee
Agentti voi kokeilla muutosta, ennen kuin tekee sen, ja jokaisen komennon jälkeen se saa tiedon siitä, mitä piirustuksessa muuttui.
| Suoja | Mitä se tekee |
|---|---|
| Tarkistustila | Parametri check: true ajaa komennon erillisessä istunnossa ja palauttaa kentän would_work, joka kertoo, onnistuisiko komento. Piirustus, näkymä, kumoushistoria, asetukset ja leikepöytä pysyvät ennallaan. Tiedostoja kirjoittavia, tulostavia tai palautetta käsitteleviä komentoja ei voi kokeilla tarkistustilassa. |
| Hylkäys kertoo syyn | Hylätyn komennon vastaus kertoo syyn, kohteen ja kerroksen. Osassa hylkäyksiä on myös luvut: kun aukko ei mahdu seinään, vastauksessa on mitattu arvo, vaadittu arvo ja lähin sopiva arvo. |
| Muutosraportti | Jokaisen komennon vastauksessa agentti saa luettelon luoduista, muutetuista ja poistetuista kohteista. Kun muutoksia on yli 200, luettelo haetaan sivu kerrallaan. |
| Yksi kumottava vaihe | Jokainen piirustukseen tehty muutos on yksi kumottava vaihe. Kun erä (batch) ajetaan tilassa all_or_nothing, sen muutokset jäävät voimaan vain, jos jokainen komento onnistuu, ja koko erä on yksi vaihe. |
| Revisiotarkistus | Parametri expect_revision hylkää komennon, ennen kuin mitään tehdään, jos projekti on muuttunut annetun revision jälkeen. |
Kysy, ennen kuin teet
Agentti voi ajaa piirustusta muuttavan komennon tarkistustilassa. Tämä rivi kertoo, onnistuisiko huoneen piirtäminen, eikä muuta piirustusta:
{"command":"wall.room_rect","params":{"p1":[0,0],"p2":[4000,3000],"thickness":200,"check":true}}
Rivi olettaa, että istunnossa on jo projekti ja kerros, kuten yllä olevan esimerkin kahden ensimmäisen rivin jälkeen. Tyhjässä istunnossa vastaus on would_work: false, ja syynä on puuttuva projekti (no project).
Tiedostot eivät kumoudu. Tallennus ja vienti kirjoittavat tiedostoja, ja tulostus lähettää työn tulostimelle. Kumoa ei peru niitä. Siksi tarkistustila ja erä eivät hyväksy tiedostoja kirjoittavia, tulostavia tai palautetta käsitteleviä komentoja.
Käyttöehdot hyväksyy ihminen, ei agentti. Työkalut eivät avaa mitään projektia, ennen kuin ehdot on hyväksytty: käynnistä PirtoCAD ja valitse Hyväksy tai kirjoita itse päätteeseen pirtocad-cli accept-licence. Komento lukee vastauksen päätteestä eikä hyväksy putken kautta syötettyä vastausta.
Suunnittelija vastaa tuloksista. Tarkista agentin tekemä työ itse, ennen kuin piirustus lähtee eteenpäin.
Tulossa
Nämä ovat työn alla eivätkä ole vielä alfassa:
- Agentin istunnon käynnistys ikkunasta. Nyt agentin voi liittää ikkunassa auki olevaan projektiin vain käynnistämällä PirtoCADin päätteestä parametrilla
--agent-session. - Kokeilu, jossa työpöydän tekoälysovellus piirtää PirtoCADilla MCP-palvelimen kautta, ja video agentin työstä
Kaikki komennot nimineen ja pakollisine parametreineen ovat komentoviitteessä. Ohjelmalta saat saman tiedon: pirtocad-cli commands luettelee kaikki komennot JSON-muodossa, pirtocad-cli commands --brief näyttää esimerkin jokaisesta komennosta ja pirtocad-cli commands wall.chain yhden komennon koko skeeman.
Video tehdään, kun piirtämistä MCP-palvelimen kautta on kokeiltu.