設計者のためのAIプロンプト設計——依頼文の書き方
AIに設計の仕事を頼んで期待外れだったとき、多くの場合の原因はAIではなく依頼文にあります。設計者は図面と仕様書で意図を伝える訓練を受けています。その技術はそのままプロンプト設計に使えます。実例で示します。
Photo: UnsplashAIへの依頼文は、外注の仕様書と同じもの
はじめて会う外注先に、口頭で「あの穴、いい感じに開けといて」と頼む人はいません。図面を出し、公差を書き、基準面を指定します。AIへの指示も同じです。AIは経験の浅い外注先だと思って書くのがいちばん近い。
違いは、AIが分からないときに聞き返さないことです。人間の外注なら「基準どこですか」と電話がかかってきます。AIは黙って推測で埋めます。だから推測される余地を先に潰しておく必要があります。
つまりプロンプト設計は、新しい技能ではありません。設計者がすでに持っている「曖昧さを潰して伝える」技能を、文章に適用するだけです。書き方のコツは、突き詰めると3つに集約されます。
悪い依頼文の実例と、そこで何が起きるか
まず実際にありがちな依頼文を挙げます。「CATIAでボルト穴を自動で開けるマクロを作って」。これだけです。私たちが現場で見た依頼文の大半が、この粒度です。
この一文からAIが決めなければならないことを数えると、10個以上あります。穴の直径は。座標の与え方はパラメータかExcelか。対象はパートかプロダクトか。既存の穴と重なったらどうするか。座ぐりは要るか。失敗したときロールバックするか。単位はミリか。決めなかったことは、全部AIが勝手に決めます。
結果、それらしいコードが出てきます。動きもします。しかし現場の運用とは噛み合わず、直すより書き直したほうが早い状態になる。「AIは使えない」という結論は、たいていここで生まれています。
もうひとつ悪い依頼文の典型が、「いい感じに」「うまく」「適切に」といった評価語です。評価語は指示ではなく丸投げです。適切という言葉が出てきたら、その裏に数値があるはずなので、それを書きます。
決めなかったことは、
全部AIが勝手に決める。
良い依頼文の実例——同じ依頼を書き直す
先ほどの依頼を書き直します。「CATIA V5のパートに対し、Excelで与えた座標リストからボルト穴を開けるVBAマクロを作ってください。入力はA列にX、B列にY、C列に直径(mm)。対象は現在アクティブなPartDocumentの最初のBody。穴は貫通ではなく深さ12mm固定。既存フィーチャと同じ座標があった場合は作成せずスキップし、スキップした行番号を最後にまとめてMsgBoxで表示。座標が数値でない行があれば処理全体を実行せず、行番号を示して終了してください」。
長いと感じるかもしれませんが、この程度で十分です。ポイントは4つ。入力の形式、対象の範囲、異常時の挙動、出力の形。この4つが埋まっていれば、AIは推測する必要がなくなります。
特に効くのが3つめ、異常時の挙動です。「数値でない行があれば実行せず終了」と書くだけで、生成されるコードの性格が変わります。私たちの言う自働化の思想を、依頼文の中に入れてしまうわけです。
そして重要なのは、この依頼文が自分の頭の整理そのものになっていることです。ここまで書けた時点で、仕様は固まっています。AIを使うかどうかに関わらず、価値があります。
Sub CreateHolesFromList()
Dim oDoc As PartDocument
' 前提検査:アクティブがパートでなければ実行しない
If TypeName(CATIA.ActiveDocument) <> "PartDocument" Then
MsgBox "パートを開いてから実行してください"
Exit Sub
End If
Set oDoc = CATIA.ActiveDocument
Dim oBody As Body
Set oBody = oDoc.Part.Bodies.Item(1)
' 座標リストの読み込み(Excelから配列で受け取り済みとする)
Dim i As Integer
Dim skipped As String
For i = LBound(coords, 1) To UBound(coords, 1)
' 数値でない行が1つでもあれば全体を中止する
If Not IsNumeric(coords(i, 1)) Then
MsgBox i & " 行目が数値ではありません。処理を中止します"
Exit Sub
End If
Next
Dim oShapeFactory As ShapeFactory
Set oShapeFactory = oDoc.Part.ShapeFactory
For i = LBound(coords, 1) To UBound(coords, 1)
' 既存穴と同一座標ならスキップし、行番号を記録
If IsDuplicated(oBody, coords(i, 1), coords(i, 2)) Then
skipped = skipped & i & ", "
End If
Next
oDoc.Part.Update
MsgBox "スキップした行: " & skipped
End Sub冒頭で対象ドキュメントの型を検査し、座標の妥当性を全数チェックしてから初めて造形に入ります。異常時の挙動を依頼文に書いておくと、この構造が自然に出てきます。
依頼文の型——設計現場で使える5行フォーマット
毎回長文を考えるのは大変なので、私たちは社内で5行の型を使っています。目的、入力、対象、異常時、出力。この順に1行ずつ書く。慣れれば2分で書けます。
目的の行では、動詞を1つに絞ります。「作って整理して確認して」ではなく、まず「作る」だけ。1回の依頼に動詞は1つが原則です。複数やらせると、どれも中途半端になります。
入力の行では、実物の一部を貼ります。Excelの3行分、ツリーの構成、命名規約の例。言葉で説明するより、実データを1つ見せるほうが圧倒的に正確に伝わります。これは人間相手でも同じです。
異常時の行を書く習慣は、そのままレビューにも効きます。他人のツールをレビューするとき「異常時どうなりますか」と聞けば、8割のツールでその場では答えが出てきません。そこが弱点です。
AIにコードを書かせない、という選択
ここまでプロンプト設計のコツを書いてきましたが、私たちの本業では少し違うことをしています。AIにコードを生成させていません。特許第7907964号のAIエージェント「Qi」は、検証済みの社内ツールを「選択」するだけです。
理由は品質保証です。AIが生成したコードは、生成のたびに違います。同じ依頼でも次の日には別のコードが出る。それを毎回レビューする体制は、量産設計の現場では回りません。500本を超える検証済みツールから選ばせるほうが、確実で速い。
選択されたツールは、実行前にDSL(私たちが「関所」と呼ぶ層)を通ります。引数の型、対象の状態、権限。ここで弾かれたら実行されません。AIの判断が直接CADに届くことはない設計です。
とはいえ、日常業務でAIにコードや文章を書かせる場面はいくらでもあります。そのとき効くのが、この記事で書いた依頼文の型です。使い分けの基準は、結果を人がレビューできるかどうか。レビューできる規模なら生成させていい。量産に流れるものなら、検証済みのものを選ばせる。
ここまで読んで「うちでもやってみたい」と思われたなら、まずは私たちの無料セミナーをのぞいてみてください。改善を金額で語る考え方を、実例を使って一緒に組み立てます。相談だけでも歓迎です。