特許・Qi

眠っているマクロを「実行単位」に包み直す——資産の棚卸しから始めるQi導入

2026.09.06 / 読了目安 9分 / 執筆: Qronix 開発チーム

#特許Qi#自働化思想#CATIA#CATIAマクロ

AIにCADを触らせる、と聞くと、AIがその場でコードを書いて実行する姿を思い浮かべる方が多いようです。Qiはそこを取っていません。実際に動くのは、社内で誰かが書いて、現場で何年も使われてきたCATIAマクロそのものです。だからQiの導入は、開発からではなく棚卸しから始まります。

パズルのピースPhoto: Unsplash
CONTENTS
1. Qiが実行しているのは、新しく書いたコードではない 2. 「実行単位」とは、マクロにメタデータを着せたもの 3. どれから包むかを、頻度と手戻りの重さで決める 4. 包める状態かどうかは、4つ見れば分かる 5. 実行前チェックは、たいていもう書いてある 6. 棚卸しから最初の1本まで 7. 手持ちが多いほど、導入は短くなる

Qiが実行しているのは、新しく書いたコードではない

特許第7907964号の請求項5には、実行部は「実行単位に対応する既存のマクロまたはテンプレートを呼び出してアプリケーション操作を実行する」と書いてあります。方法として書かれた請求項10も同じ内容です。つまり権利の中身として、動かす対象は最初から既存資産だと決めてあります。

AIが担当するのは、どの実行単位を呼ぶかを決めるための意図の解析と、足りない入力値を埋めることだけです。処理の中身を書くことも、途中で別の処理に乗り換えることもしません。ここを外すと、出力が正しいかどうかを確かめる手立てがなくなります。

この前提に立つと、導入の入口が変わります。新しく何を作るかではなく、すでに何を持っているかから始まります。そして多くの設計部門は、自分たちが思っているより多くを持っています。

「実行単位」とは、マクロにメタデータを着せたもの

請求項2では、実行単位を「アプリケーション操作に対応する処理内容」と「入力項目、出力情報および制約条件を含むメタデータ」を対応付けて定義したもの、としています。処理内容は今あるマクロです。足りていないのは、その後ろ半分です。

出願書類の背景にも、同じことを課題として書きました。既存のマクロやテンプレートは個別に管理されていることが多く、入出力仕様や制約条件、用途といった統一的な表現を備えていない。だからAIによる自動処理に安全に組み込むことが難しい、という認識です。

現場の言葉に直すと、こうなります。マクロは動きます。ところが「何を渡せばよいのか」「渡してはいけない値は何か」「いつ実行してよいのか」が、コードの中と、書いた人の頭の中にしかありません。包み直すとは、コードを書き換えることではありません。この3つを、外から読める形にして横に置くことです。

動くのに使われていないマクロは、資産としては眠っている状態です。使い方を知っている人がその場にいるときだけ動く、という状態だからです。メタデータは、その人が席にいなくても伝わるようにするための書き付けでもあります。

同じ操作をAIから動かすまでに必要になるもの新しく書かせる100処理内容の設計・実装・検証・メタデータをすべて用意する既存マクロを包む35処理内容は現物を使う。入力項目・出力情報・制約条件を書き出す
図1: 既存資産を包み直す場合、書き起こすのはメタデータだけです。※これはイメージです。

どれから包むかを、頻度と手戻りの重さで決める

手持ちのマクロが50本あったとして、50本すべてを包む必要はありません。棚卸しの目的は、全部を包むことではなく順番を決めることです。

並べる軸は2つで足ります。どれくらいの頻度で使われているかと、間違えたときの手戻りがどれくらい重いかです。当社がセミナーで使っている年間原価の式も、作業時間・利用頻度・手戻り係数・汎用度・アワーレートの掛け算で、見ているものは同じです。金額に直すと、部署をまたいでも話が通じます。

頻度が高くて手戻りが重いものから包むと、最初の1本で効果が出ます。逆に、年に一度しか使わない大物から手を付けると、包む労力のわりに何も変わりません。順番を決めずに着手した自働化が途中で止まる理由の多くは、ここにあります。

AIに作らせない。
すでにあるものを、呼ぶ。

どのマクロから実行単位にするか年に数回だが影響は大きい2番目に包む毎週使い、間違えると重い最初に包むたまに使い、直しも軽い急がない毎日使うが影響は軽い余力が出たら間違えたときの手戻りの重さ使用頻度(右が高い)
図2: 使用頻度と、間違えたときの手戻りの重さで並べます。

包める状態かどうかは、4つ見れば分かる

順番が決まったら、上から順に、包める状態かどうかを見ます。見るのは4点です。引数が名前付きで外から渡せるか。実行の前に前提を確かめているか。前提を満たさないときに止まるか。何をしたかが残るか。

この4つが揃っているマクロは、ほぼそのまま実行単位になります。揃っていないものの多くは、画面で選んだ状態に依存して動く作りです。人が操作する前提なら自然な書き方ですが、選択状態という外から見えない入力に頼っているぶん、メタデータに書き出せません。

ただし、包みにくいマクロは、作り直す対象ではなく包み方を変える対象です。選択状態を引数として受け取る入口を1つ足すだけで、中身に触らずに包めることがよくあります。作り直しの判断は、その入口すら足せないと分かってからで遅くありません。

そのマクロは、実行単位に包める状態か✓引数が名前付きで外から渡せる✓実行の前に前提を確かめている✓前提を満たさないときに止まる✓何をしたかが記録に残る✗画面で選んだ状態に依存して動く
図3: 上の4つが揃っていれば、中身に触らずに包めます。

実行前チェックは、たいていもう書いてある

請求項3では、制約条件を「入力値の許容範囲、必須入力の有無、および実行可能状態に関する条件」と定義しています。このうち実行可能状態は、まともに運用されてきたマクロならすでに入っていることが多い項目です。

弊社の共通ライブラリにも、起動時に呼ぶチェックがあります。開いているファイルの種類を確かめて、想定と違えばメッセージを出してそこで終わる、というものです。

実行可能状態のチェックは、AIのために書かれたものではありません。人が誤って別の種類のファイルで起動したときに、CATIAの中で妙なことが起きないようにするために書かれています。それでも、書いてある内容はそのまま実行単位の制約条件になります。すでにある安全装置を、AIからも読める場所へ移すだけです。

残る「入力値の許容範囲」と「必須入力の有無」は、多くの場合コードの中には書かれていません。担当者が経験で避けているぶんが、そのまま抜けています。ここは書き起こす必要があります。

こうしてメタデータが揃うと、実行単位の定義はこのような形になります。処理内容の呼び出し先と、入力項目、出力情報、そして守るべき条件が1か所に並びます。

呼ぶ側は、この定義を読んで検証してから既存マクロを呼びます。請求項1の検証部にあたる部分です。制約条件を満たさないと判定されたときは、実行しません。AIに選ばせないという設計は、選択肢をこちらで用意しておくこととセットです。

棚卸しから最初の1本まで

ここまでを手順に直すと4つです。持っているマクロを並べる、頻度と手戻りで順番を付ける、上から1本を選んでメタデータを書く、検証を通してから呼ぶ形に包む。1本目が動けば、2本目からは書式の写し替えに近くなります。

所要は資産の状態によります。引数が外から渡せて、実行前チェックが入っているマクロなら、メタデータを書く作業が中心になります。逆に、選択状態に依存した作りが多いと、入口を足すぶんの時間が乗ります。どちらにしても、同じ処理を新しく書き起こすより短い、というのがこれまでの実感です。

包んだあとも、マクロ本体はこれまでどおり人が直接呼べます。実行単位として登録したことで、呼び出し口が1つ増えるという理解で構いません。使い慣れた運用を止めずに済むことは、現場に入れるうえで小さくない条件です。

棚卸しから最初の1本を包むまで手持ちのマクロを並べる頻度と手戻りの重さで順番を付ける上から1本を選ぶ選択状態に依存している?選択状態を受け取る入口を1つ足す前提チェックを制約条件に移す許容範囲と必須入力を書き起こす入力・出力・制約をメタデータに書く呼ぶ前に検証する制約条件を満たす?実行しない既存マクロを呼ぶ最初の1本が動くはいいいえいいえはい
図4: 順番を決めて1本選び、入口とメタデータを整え、検証で条件を満たさなければ実行しない。

手持ちが多いほど、導入は短くなる

AIエージェントを設計業務に入れる話は、どうしても新しく何を作るかという話になりがちです。ただ、CATIAを長く使っている部門ほど、実際には道具をすでに持っています。使われなくなったものも含めて、社内のどこかに残っています。

手持ちのマクロが多いほど、Qiの導入は短くなります。作る量が減るからです。ゼロから作らせるより、すでに現場で確かめられてきたものを呼ぶほうが、結果の確からしさという意味でも分がありますし、AIが誤った出力を出しても、実行の手前で止められます。

まずは棚卸しから、というのはそういう意味です。手元にどれだけあるか分からない、という段階でも構いません。どのマクロから包むと効果が出そうか、どこまでが実行単位になりそうかを一緒に見ていくことはできます。AIエージェントの構築を検討されていて、社内の資産の使いどころに心当たりがあれば、contact@qronix.jp までご相談ください。

VBA弊社共通ライブラリより抜粋:起動前に実行可能状態を確かめる(CanExecute)
'*****************************************************************************
'*  マクロスタートチェック
'*  主にアクティブドキュメントの型チェック
'*  param: arrDocTypes-許可するアクティブなドキュメントの型
'*      単体文字列OK, カンマ区切りの文字列OK, 文字の配列OK
'*  return: OKならTrue
'*****************************************************************************
Public Function CanExecute( _
        ByVal arrDocTypes As Variant) As Boolean

    CanExecute = False

    'MAP
    Dim oDocTypeMap As Object
    Set oDocTypeMap = CreateObject("Scripting.Dictionary")
    With oDocTypeMap
        Call .Add("PartDocument", "CATPart")
        Call .Add("ProductDocument", "CATProduct")
        Call .Add("DrawingDocument", "CATDrawing")
        Call .Add("AnalysisDocument", "CATAnalysis")
        Call .Add("ProcessDocument", "CATProcess")
    End With

    'ウィンドウ数チェック
    If CATIA.Windows.count < 1 Then
        MsgBox "ファイルが開かれていません"
        Exit Function
    End If

    'カンマ区切りの文字列
    If VarType(arrDocTypes) = vbString Then
        arrDocTypes = Split(arrDocTypes, ",")
    End If

    'ドキュメントかチェック
    Dim ActDoc As Document
    On Error Resume Next
        Set ActDoc = CATIA.ActiveDocument
    On Error GoTo 0
    If ActDoc Is Nothing Then
        MsgBox ErrMsg, vbExclamation + vbOKOnly
        Exit Function
    End If

    If UBound(Filter(arrDocTypes, TypeName(ActDoc))) < 0 Then
        MsgBox ErrMsg, vbExclamation + vbOKOnly
        Exit Function
    End If

    CanExecute = True

End Function

clsCatHelperLib.cls より抜粋(メッセージ組み立て部は省略)。許可するドキュメントの種類を渡し、合わなければ実行させません。実行単位でいう「実行可能状態に関する条件」がそのままここにあります。

JSON参考実装例:既存マクロを「実行単位」として定義する
{
  "id": "hole_pattern_v3",
  "label": "板金の取付穴を等間隔で並べる",
  "calls": "MacroLib.HolePattern.Run",
  "target": ["PartDocument"],
  "inputs": [
    { "name": "diameter", "type": "number", "unit": "mm",
      "required": true,  "min": 3.0, "max": 20.0 },
    { "name": "count",    "type": "integer",
      "required": true,  "min": 2,   "max": 24 },
    { "name": "pitch",    "type": "number", "unit": "mm",
      "required": true,  "min": 6.0, "max": 200.0 },
    { "name": "hbName",   "type": "string",
      "required": false, "default": "Holes" }
  ],
  "outputs": [
    { "name": "createdCount", "type": "integer" }
  ],
  "rules": [
    "pitch >= diameter * 1.5",
    "diameter * count + pitch * (count - 1) <= plateLength"
  ]
}

calls が既存マクロの呼び出し先、inputs と rules が制約条件にあたります。処理そのものは1行も書いていません。値はすべて例示です。

VBA参考実装例:検証を通ったときだけ既存マクロを呼ぶ
'---------------------------------------------------------------
'  実行単位のラッパー:検証を通ったときだけ既存マクロを呼ぶ
'---------------------------------------------------------------
Public Function RunUnit( _
        ByVal sUnitId As String, _
        ByVal dicArgs As Object) As Boolean

    RunUnit = False

    Dim dicMeta As Object
    Set dicMeta = UnitStore.GetMeta(sUnitId)      '処理内容とメタデータを取り出す

    '実行可能状態(このドキュメントで動かしてよいか)
    Dim h As New clsCatHelperLib
    If Not h.CanExecute(dicMeta("target")) Then Exit Function

    '必須入力と許容範囲(補完された値をここで確かめる)
    Dim sNg As String
    sNg = Validate(dicMeta("inputs"), dicArgs)
    If Len(sNg) > 0 Then
        Call Logger.Deny(sUnitId, sNg)            '止めた理由を残す
        Exit Function
    End If

    'ここまで通って初めて、既存マクロを呼ぶ
    Call CallByName(UnitStore.Owner(sUnitId), dicMeta("calls"), VbMethod, dicArgs)

    RunUnit = True

End Function

補完された入力値を確かめてから呼び、満たさなければ実行せずに理由を残します。止めた記録が残ることは、後から制約条件を直すときの手がかりになります。

Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →