Speckle Automateとは｜Version公開トリガーで自動QA・命名規約チェックを走らせる仕組み

本記事は Speckle カテゴリの一部として、Speckle Automate を整理します。モデルが更新されるたびに自動でチェックを走らせたい、という典型的なニーズに応える機能です。実務での組み込み方は データ連携実務 もあわせて参照してください。

1Speckle Automate とは

Speckle Automate は、Speckle サーバー上で 新しい Version（旧世代の Commit）が公開されたことなどをきっかけに、あらかじめ登録した処理を自動実行する仕組みです。CI（継続的インテグレーション）の発想を BIM データに持ち込んだもの、と捉えると理解しやすいでしょう。

ソースコードに対してテストが自動で走るように、モデルデータに対して「ルールどおりか」を自動でチェックできます。Version 公開のたびに人手で目視確認する代わりに、決まった検証を機械的に繰り返せるのが価値です。

2仕組み（トリガーと Function）

Function は SDK（Python の specklepy や .NET）を使って書くのが基本で、対象 Version のデータを受け取り、検査結果を Automate に返します。返した結果は実行の合否やモデルへのコメントとして反映されます。トリガーから Function、Run、結果の反映までが一本の流れになっているため、モデルを更新するたびに同じ検査が抜けなく繰り返される点が、人手の確認とは異なる安心材料になります。

同じ Model に複数の Automation を設定することもでき、たとえば「命名規約のチェック」と「必須属性のチェック」を別々の Function として用意し、それぞれ独立した Run として走らせる構成も取れます。どの Run がいつ・どの Version に対して走ったかはログに残るため、後から「この版はどの検査を通過したか」を追跡できます。

3Function でできること

Function は受け取った Speckle のオブジェクトツリーを走査し、任意のロジックを適用できます。代表的には次のような処理です。

処理は specklepy などでオブジェクトを取得して進めます。データ取得の基本は specklepy を参照してください。

4ユースケース：命名規約チェック

分かりやすい例が「命名規約チェック」です。たとえば「壁の名前は WL- で始まること」というルールがあるとき、Function でモデル内の壁要素を走査し、規約に反する要素を検出してマークします。概念的には次のような判定です。

# 概念例：壁の命名規約チェック（specklepy 風の擬似コード）
for el in walls:
    name = el["name"]
    if not name.startswith("WL-"):
        # 不合格として要素をマークし、理由を付ける
        attach_error(el, "命名規約違反: WL- で始めてください")

記号を含む条件式やパスを扱う場合、<（小なり）や >（大なり）、&（アンパサンド）などはコードとして崩れないよう注意します。チェック結果は Run の合否として残り、レビュー前に機械的に弾けます。

5その他の典型ユースケース

6導入時の考え方

Automate は「人手のレビューを置き換える」というより「機械的に判定できる部分を自動化し、人は判断が要る部分に集中する」ための道具です。最初は1つの明確なルール（命名規約や必須属性の有無など）から始め、Run のログで誤検出を調整しながら段階的にルールを増やすのが現実的です。

機能の提供形態・実行環境・料金体系は時期によって変わり得るため、本番運用の前提にする場合は最新の公式情報を確認してください。実務パイプラインへの組み込み例は データ連携実務 で扱います。

→次に読む