「実行を禁止する」を先に作る——制約違反のとき何もしない設計
AIに何かを任せるとき、先に作りたくなるのは「できること」のほうです。動いて結果が出ると、話が前に進んだ感じがします。ところが現場に配ったあとで効いてくるのは、できないときに何をするかの決め方でした。特許第7907964号の請求項3は、制約条件を満たさないと判定された場合には実行を禁止する、と書いています。この「禁止」を先に書いておくと何が変わるのかを、CATIAのマクロの書き方に寄せて整理します。

請求項3が決めているのは、止め方ではなく「何もしない」こと
特許第7907964号の請求項3は、制約条件を「入力値の許容範囲、必須入力の有無、および実行可能状態に関する条件」と定めています。そのうえで、これを満たさないと判定された場合には実行を禁止する、と続きます。
読み飛ばされやすいのは後半です。禁止するとだけ書いてあり、代わりに何をするとは書いていません。近い値へ直すとも、一部だけ進めるとも、後で自動的にやり直すとも書いていない。何もしないことが、そのまま仕様になっています。
現場のマクロに置き換えると、当たり前のようでいて抜けやすいところです。前提を確かめる行は書いてあるのに、確かめて駄目だったときにどう終わるかまでは決めていない、ということが起こります。メッセージだけ出して処理は続く、という書き方が残っているマクロは珍しくありません。
制約条件そのものを誰が書くのかは、制約条件は現場にしか書けないで書きました。今日はその次の話、書いた条件に引っかかったときに何をするのかを決める話です。
既定を「禁止」に置く——許可は条件を通ったときだけ立てる
弊社が配っているCATIAマクロは、入口で実行してよいかを判定してから本体に入ります。書き方の要点は、判定の戻り値の既定を「実行しない」側に置いてあることです。検査をすべて通ったときにだけ、最後の行で許可を立てます。
この順序だと、途中で想定していない状態に出会っても、許可を立てないまま関数を抜けます。書き漏らしや、後から足した分岐の抜けが、そのまま実行しないほうへ落ちます。逆に、既定を許可にしておいて違反のときだけ落とす書き方は、列挙し切れたときだけ正しく動きます。
CATIAのマクロは、開いているドキュメントの種類や、そのときの選択状態で振る舞いが変わります。条件を列挙し切れたと言い切れる場面は、あまりありません。だから既定を禁止に置くほうが、後から足す分に強くなります。
禁止は列挙するものではなく、既定として置くものです。社内ではそういう言い方をしています。
' 既定は「実行しない」。検査を通ったときにだけ許可を立てる。
' 断るときは理由を添えて返し、呼び出し側が記録に残せるようにする。
Option Explicit
Public Function CanRun( _
ByVal sDocTypes As String, _
ByRef sReason As String) As Boolean
CanRun = False ' ここが既定。以降どこで抜けても実行しない
sReason = ""
' 実行可能状態: ドキュメントが開いているか
If CATIA.Windows.Count < 1 Then
sReason = "NO_DOC|ファイルが開かれていません"
Exit Function
End If
Dim oDoc As Document
On Error Resume Next
Set oDoc = CATIA.ActiveDocument
On Error GoTo 0
If oDoc Is Nothing Then
sReason = "NO_ACTIVE|アクティブなドキュメントを取得できません"
Exit Function
End If
' 実行可能状態: 想定した型か
If UBound(Filter(Split(sDocTypes, ","), TypeName(oDoc))) < 0 Then
sReason = "BAD_TYPE|" & sDocTypes & " のときだけ実行します"
Exit Function
End If
' 実行可能状態: 書き込めるか
If oDoc.ReadOnly Then
sReason = "READ_ONLY|読み取り専用のため実行しません"
Exit Function
End If
CanRun = True ' ここまで通って初めて許可を立てる
End Function「何もしない」を3つに分けて決めておく
何もしない、と一言で書いても、実装の場面では判断が要ります。私たちは3つに分けて決めています。途中まで実行しない、値を丸めない、黙って終わらない、の3つです。
1つ目は、まとめて処理するときの扱いです。50本のエッジを順に処理していて30本目で範囲外の値に当たったら、29本ぶんの変更が残ります。残ったものを戻す作業は、やらなかった作業より重くなります。そこで、処理を始める前に全件を判定し、1件でも違反があれば、1件も実行しません。
2つ目は、範囲外の値の扱いです。下限を下回る半径を受け取ったとき、下限に寄せて実行すると、依頼した人は指示どおりに通ったと受け取ります。違う値で通ったことに気づけるのは、後工程に出てからです。範囲を外れた値は直さずに断ります。
3つ目は、断り方です。何もせずに終わるだけだと、実行されなかったのか、実行されて何も変わらなかったのかが区別できません。断った条件と、渡された値を記録に残します。断られた記録が残らない仕組みは、条件のほうを直せません。
通らなかったときに何をしないか。
先に決めておくのは、そちらのほうです。
' 途中まで実行しない。丸めない。黙って終わらない。
' 判定だけを先に1周し、違反が1件でもあれば処理には入らない。
Private Const MIN_R As Double = 0.5 ' 許容範囲の下限(現場からの指摘で決めた値)
Private Const MAX_R As Double = 12# ' 同 上限
Public Function RunFillet( _
ByRef arrR() As Double, _
ByRef sLog As String) As Boolean
RunFillet = False
sLog = ""
Dim sReason As String
If Not CanRun("PartDocument", sReason) Then
sLog = "DENY " & sReason
Exit Function ' 1本も触らずに戻る
End If
' 1周目: 判定だけ。ここでは形状に一切手を付けない
Dim i As Long, lNg As Long
lNg = 0
For i = LBound(arrR) To UBound(arrR)
If arrR(i) < MIN_R Or arrR(i) > MAX_R Then
sLog = sLog & "OUT_OF_RANGE idx=" & i & " R=" & arrR(i) & vbCrLf
lNg = lNg + 1
End If
Next
If lNg > 0 Then
sLog = "DENY 範囲外 " & lNg & " 件のため実行しません(丸めも行いません)" _
& vbCrLf & sLog
Exit Function ' 1件でも外れたら、1件も実行しない
End If
' 2周目: ここから先は全件が範囲内であることが分かっている
For i = LBound(arrR) To UBound(arrR)
' 既存のフィレット付与マクロを呼ぶ
Next
sLog = "OK " & (UBound(arrR) - LBound(arrR) + 1) & " 件"
RunFillet = True
End Function禁止を後から足すと、通っていたものを止める作業になる
順番の話をします。動くものを先に作り、事故が起きてから禁止条件を足す、という進め方はよく見かけます。手は動いている感じがしますし、実際に事故は減ります。ただ、代償があります。
禁止を後から足すのは、通っていたものを止める作業になります。これまで実行できていた依頼が、明日から断られるようになる。現場からは「壊れた」という連絡が来ます。条件が正しくても、入れ方の説明に時間を取られます。
もう1つは、材料が足りないことです。何を禁止すべきかは、これまでどんな値が渡されてきたかを見れば決めやすくなります。ところが断った記録どころか、実行した記録も残していないことが多い。事故が起きてから、当時の値を思い出しながら条件を書くことになります。
先に禁止から書くと、この2つが逆になります。最初から断られる依頼は「壊れた」になりませんし、断った記録が最初から溜まります。溜まった記録を見て、条件が厳しすぎたところを緩めていく順番のほうが、後から締めるより摩擦が小さく済みました。
AIから呼ぶときも、禁止の置き場所は変わらない
ここまではマクロの話ですが、AIエージェントから呼ぶ場合も置き場所は同じです。実行の手前に判定があり、通らなければ実行しない。判断するのが人かAIかで、要るものは変わりません。
変わるのは、断り方の宛先です。人に断るならメッセージで足りますが、AIに断るなら、どの条件に当たったのかと、渡された値を構造のある形で返します。返ってきたものを見て、AIができるのは、足りない入力を埋め直して出し直すところまでです。範囲の外へ出る書き換えはできません。
何を呼ぶかをその場で選び直させない、という前提については実行単位を固定する話に書きました。実行単位を固定したうえで、その単位ごとに禁止条件を持たせる。実行前検査の関所で見ているのも、同じ位置です。
自動で何度もやり直させない、という決めごとも入れています。断られたものを同じ値で出し直しても、結果は同じです。回数を区切り、越えたら人に回します。
禁止から書く——今日から始められる順番
禁止条件は、AIを入れる前に書けます。手順は4つです。手戻りになった場面を集める、それを「これでないなら実行しない」という言い方に直す、既定を禁止側に倒す、断った記録を残す。この4つは、いま動いているマクロにも足せます。
集めるときは、ルールを聞くより失敗を聞くほうが早く出てきます。守っている条件ほど言葉になっていないので、「これまでに手戻りになったのはどんなときですか」から入ります。出てきた話の多くは、そのまま禁止条件の形をしています。
全部を一度に書く必要はありません。よく使うマクロを1本選び、そこに3つか4つの禁止条件を置いて、断った記録を1か月ぶん溜めてみる。厳しすぎた条件は記録に出ますし、足りなかった条件も、通ってしまった依頼として出ます。
どの作業から禁止条件を書き出すとよいか、実際のマクロを見ながら一緒に整理することもできます。クロニクスでは、CATIAのマクロを実行の手前で止める作りを長く続けてきた経験をもとに、社内で安全に回るAIエージェントの構築を、相談の段階からお手伝いしています。contact@qronix.jp までお気軽にご連絡ください。