眠っているマクロを「実行単位」に包み直す——資産の棚卸しから始めるQi導入
AIにCADを触らせる、と聞くと、AIがその場でコードを書いて実行する姿を思い浮かべる方が多いようです。Qiはそこを取っていません。実際に動くのは、社内で誰かが書いて、現場で何年も使われてきたCATIAマクロそのものです。だからQiの導入は、開発からではなく棚卸しから始まります。
Photo: UnsplashQiが実行しているのは、新しく書いたコードではない
特許第7907964号の請求項5には、実行部は「実行単位に対応する既存のマクロまたはテンプレートを呼び出してアプリケーション操作を実行する」と書いてあります。方法として書かれた請求項10も同じ内容です。つまり権利の中身として、動かす対象は最初から既存資産だと決めてあります。
AIが担当するのは、どの実行単位を呼ぶかを決めるための意図の解析と、足りない入力値を埋めることだけです。処理の中身を書くことも、途中で別の処理に乗り換えることもしません。ここを外すと、出力が正しいかどうかを確かめる手立てがなくなります。
この前提に立つと、導入の入口が変わります。新しく何を作るかではなく、すでに何を持っているかから始まります。そして多くの設計部門は、自分たちが思っているより多くを持っています。
「実行単位」とは、マクロにメタデータを着せたもの
請求項2では、実行単位を「アプリケーション操作に対応する処理内容」と「入力項目、出力情報および制約条件を含むメタデータ」を対応付けて定義したもの、としています。処理内容は今あるマクロです。足りていないのは、その後ろ半分です。
出願書類の背景にも、同じことを課題として書きました。既存のマクロやテンプレートは個別に管理されていることが多く、入出力仕様や制約条件、用途といった統一的な表現を備えていない。だからAIによる自動処理に安全に組み込むことが難しい、という認識です。
現場の言葉に直すと、こうなります。マクロは動きます。ところが「何を渡せばよいのか」「渡してはいけない値は何か」「いつ実行してよいのか」が、コードの中と、書いた人の頭の中にしかありません。包み直すとは、コードを書き換えることではありません。この3つを、外から読める形にして横に置くことです。
動くのに使われていないマクロは、資産としては眠っている状態です。使い方を知っている人がその場にいるときだけ動く、という状態だからです。メタデータは、その人が席にいなくても伝わるようにするための書き付けでもあります。
どれから包むかを、頻度と手戻りの重さで決める
手持ちのマクロが50本あったとして、50本すべてを包む必要はありません。棚卸しの目的は、全部を包むことではなく順番を決めることです。
並べる軸は2つで足ります。どれくらいの頻度で使われているかと、間違えたときの手戻りがどれくらい重いかです。当社がセミナーで使っている年間原価の式も、作業時間・利用頻度・手戻り係数・汎用度・アワーレートの掛け算で、見ているものは同じです。金額に直すと、部署をまたいでも話が通じます。
頻度が高くて手戻りが重いものから包むと、最初の1本で効果が出ます。逆に、年に一度しか使わない大物から手を付けると、包む労力のわりに何も変わりません。順番を決めずに着手した自働化が途中で止まる理由の多くは、ここにあります。
AIに作らせない。
すでにあるものを、呼ぶ。
包める状態かどうかは、4つ見れば分かる
順番が決まったら、上から順に、包める状態かどうかを見ます。見るのは4点です。引数が名前付きで外から渡せるか。実行の前に前提を確かめているか。前提を満たさないときに止まるか。何をしたかが残るか。
この4つが揃っているマクロは、ほぼそのまま実行単位になります。揃っていないものの多くは、画面で選んだ状態に依存して動く作りです。人が操作する前提なら自然な書き方ですが、選択状態という外から見えない入力に頼っているぶん、メタデータに書き出せません。
ただし、包みにくいマクロは、作り直す対象ではなく包み方を変える対象です。選択状態を引数として受け取る入口を1つ足すだけで、中身に触らずに包めることがよくあります。作り直しの判断は、その入口すら足せないと分かってからで遅くありません。
実行前チェックは、たいていもう書いてある
請求項3では、制約条件を「入力値の許容範囲、必須入力の有無、および実行可能状態に関する条件」と定義しています。このうち実行可能状態は、まともに運用されてきたマクロならすでに入っていることが多い項目です。
弊社の共通ライブラリにも、起動時に呼ぶチェックがあります。開いているファイルの種類を確かめて、想定と違えばメッセージを出してそこで終わる、というものです。
実行可能状態のチェックは、AIのために書かれたものではありません。人が誤って別の種類のファイルで起動したときに、CATIAの中で妙なことが起きないようにするために書かれています。それでも、書いてある内容はそのまま実行単位の制約条件になります。すでにある安全装置を、AIからも読める場所へ移すだけです。
残る「入力値の許容範囲」と「必須入力の有無」は、多くの場合コードの中には書かれていません。担当者が経験で避けているぶんが、そのまま抜けています。ここは書き起こす必要があります。
こうしてメタデータが揃うと、実行単位の定義はこのような形になります。処理内容の呼び出し先と、入力項目、出力情報、そして守るべき条件が1か所に並びます。
呼ぶ側は、この定義を読んで検証してから既存マクロを呼びます。請求項1の検証部にあたる部分です。制約条件を満たさないと判定されたときは、実行しません。AIに選ばせないという設計は、選択肢をこちらで用意しておくこととセットです。
棚卸しから最初の1本まで
ここまでを手順に直すと4つです。持っているマクロを並べる、頻度と手戻りで順番を付ける、上から1本を選んでメタデータを書く、検証を通してから呼ぶ形に包む。1本目が動けば、2本目からは書式の写し替えに近くなります。
所要は資産の状態によります。引数が外から渡せて、実行前チェックが入っているマクロなら、メタデータを書く作業が中心になります。逆に、選択状態に依存した作りが多いと、入口を足すぶんの時間が乗ります。どちらにしても、同じ処理を新しく書き起こすより短い、というのがこれまでの実感です。
包んだあとも、マクロ本体はこれまでどおり人が直接呼べます。実行単位として登録したことで、呼び出し口が1つ増えるという理解で構いません。使い慣れた運用を止めずに済むことは、現場に入れるうえで小さくない条件です。
手持ちが多いほど、導入は短くなる
AIエージェントを設計業務に入れる話は、どうしても新しく何を作るかという話になりがちです。ただ、CATIAを長く使っている部門ほど、実際には道具をすでに持っています。使われなくなったものも含めて、社内のどこかに残っています。
手持ちのマクロが多いほど、Qiの導入は短くなります。作る量が減るからです。ゼロから作らせるより、すでに現場で確かめられてきたものを呼ぶほうが、結果の確からしさという意味でも分がありますし、AIが誤った出力を出しても、実行の手前で止められます。
まずは棚卸しから、というのはそういう意味です。手元にどれだけあるか分からない、という段階でも構いません。どのマクロから包むと効果が出そうか、どこまでが実行単位になりそうかを一緒に見ていくことはできます。AIエージェントの構築を検討されていて、社内の資産の使いどころに心当たりがあれば、contact@qronix.jp までご相談ください。
'*****************************************************************************
'* マクロスタートチェック
'* 主にアクティブドキュメントの型チェック
'* 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 FunctionclsCatHelperLib.cls より抜粋(メッセージ組み立て部は省略)。許可するドキュメントの種類を渡し、合わなければ実行させません。実行単位でいう「実行可能状態に関する条件」がそのままここにあります。
{
"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行も書いていません。値はすべて例示です。
'---------------------------------------------------------------
' 実行単位のラッパー:検証を通ったときだけ既存マクロを呼ぶ
'---------------------------------------------------------------
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補完された入力値を確かめてから呼び、満たさなければ実行せずに理由を残します。止めた記録が残ることは、後から制約条件を直すときの手がかりになります。
記事一覧をすべて見る →