初級者編 / ドキュメントタイプを作る
プロンプトのコツ
クレジットを知るまでで、発注書を読み取るためのドキュメントタイプが完成しました。
ここまでの流れを振り返ると、解析結果を意図どおりにするために何度かプロンプトを書き換えてきました。ドキュメントフォースの精度は、このプロンプトの書き方でほとんど決まります。
このページでは、これから自社の書類でドキュメントタイプを作るときに役立つよう、プロンプトの基本とコツを整理します。
このページで進めることlink
- 1helpプロンプトとは何か、どこに書くものかを確認する
- 2lightbulbプロンプトを書くときの3つのコツ(シンプル・具体的・構造的)を知る
- 3table_rows単項目と表項目それぞれの書き方の違いを確認する
- 4block避けたほうがよい書き方(NG例)を確認する
プロンプトとはlink
プロンプトとは、生成AIに対して出す指示のことです。
ドキュメントフォースでは、解析項目ごとにあらかじめプロンプトを登録しておきます。そのため、ドキュメントをアップロードするたびに指示を書く必要がなく、同じ読み取りを何度でも自動で繰り返せるようになっています。
| 内容 | |
|---|---|
| どこに書くか | 解析項目の編集画面のプロンプト欄 |
| いくつ書くか | 解析項目1つにつき1つ |
| いつ実行されるか | ドキュメントが解析されるたび(再解析時も同じプロンプトが使われる) |
ドキュメントタイプビルダーで作成したドキュメントタイプにも、選んだ項目ごとにプロンプトが自動で入っていました。プロンプトとモデルでおこなったのは、そのプロンプトを業務のルールに合わせて書き直す作業です。
Tips:プロンプトは「新しく入った担当者への指示書」
プロンプトは、書類の読み取り方を知らない人に渡す作業指示書だと考えるとわかりやすくなります。
社内では当たり前に通じる呼び方も、初めてその書類を見る人には伝わりません。「どの書類の」「どこに書かれている」「何を」「どんな形で」取り出してほしいのかを、言葉にして渡す必要があります。AIに対しても同じことが言えます。
プロンプトのコツlink
プロンプトを書くときに意識したいのは、次の3つです。
シンプル
必要なことだけを端的にまとめて指示する
回りくどく書かない
具体的
書類に書かれている言葉で、形式まで指定する
解釈の余地を残さない
構造的
見出しで指示を分け、構造が見える形で書く
箇条書きで整理する
シンプルに書くlink
プロンプトは、長く書けば精度が上がるものではありません。やってほしいことを端的に書くのが基本です。
| 例 | |
|---|---|
| 回りくどい書き方 | 発注書をよく読んで、その中から日付に関する情報を探し、いちばんそれらしいものを答えてください |
| 端的な書き方 | 発注日を抽出してください。 |
どちらも求めている結果は同じですが、端的に書いたほうが何を取得したいのかが明確になります。
端的に書くことには、もう1つ大きな利点があります。あとから読み返したときに、何を指示しているのかがすぐにわかることです。プロンプトは一度書いて終わりではなく、運用しながら少しずつ直していくものです。回りくどい言い回しや不要な前置きが残っていると、どこを直せばよいのかがわからなくなり、修正そのものが難しくなります。
Tips:「1つのプロンプトに1つの指示」である必要はありません
複雑な条件を扱う書類では、どうしても複数の指示を1つのプロンプトに書かなければならないことがあります。生成AIの性能は向上しており、複数の指示を正しく処理できるようになってきているため、無理に指示を1つに絞る必要はありません。
大切なのは、指示の数を減らすことではなく、ひとつひとつの指示を端的に書き、整理された状態に保つことです。指示が増えてきたときは、このあとの構造的に書くで紹介する見出しや箇条書きを使って整理してください。
具体的に書くlink
AIは、書類に書かれている内容からしか判断できません。そのため、書類の上で使われている言葉で指示するのが基本です。
プロンプトとモデルで「取引先名を抽出してください。」がうまく動かなかったのは、まさにこの点が理由でした。「取引先名」は社内での呼び方であり、発注書のどこにも書かれていない言葉だったため、「注文者名を抽出してください。」に変えることで意図どおりに取得できるようになりました。
具体的に書くためのポイントは次のとおりです。
| ポイント | 例 |
|---|---|
| 書類に書かれている言葉を使う | 「取引先名」ではなく「注文者名」 |
| 回答の形式を指定する | 「YYYY/MM/DD形式で回答してください。」 |
| 回答例を添える | 「2025/11/26」 |
| 似た情報との違いを書く | 「請求日と発行日は異なります。」 |
| 取ってはいけないものを書く | 「宛先(発注先)は抽出しないでください。」 |
| 記載がない場合の扱いを決める | 「記載がない場合は『記載なし(要確認)』と回答してください。」 |
Tips:「こう取る」だけでなく「こうは取らない」も書く
似た情報が複数書かれている書類では、禁止事項を一文添えるだけで精度が安定します。
発注書には「宛名(自社)」と「発行元(取引先)」という2つの会社名が書かれていました。このように紛らわしい情報があるときは、取得したいものを指定するだけでなく、取得してほしくないものもあわせて伝えてください。
構造的に書くlink
指示が増えてきたら、見出しで区切って整理します。
プロンプトの書式に決まりはありませんが、構造的に書くための手段としてマークダウン形式が非常に有効なため、ドキュメントフォースではこの書き方を推奨しています。
マークダウン形式とは、記号を使って文章に構造をつけるための、シンプルな書き方のルールです。行の先頭に#をつけると見出しになり、-をつけると箇条書きになります。覚えることはほとんどなく、プロンプトで使うのは見出しと箇条書きの2つだけでも十分です。
見出しで区切ることで、AIが「どこが指示で、どこが条件で、どこが例なのか」を正確に読み取れるようになります。長いプロンプトほど効果が大きく、指示の取りこぼしが減ります。あわせて、あとから自分で見返して一部だけ直したり、ほかの解析項目に使い回したりしやすくなるという利点もあります。
Tips:マークダウン形式は必須ではありません
マークダウン形式で書かなければ解析できない、ということはありません。普通の文章で書いたプロンプトでも動作します。
それでも推奨しているのは、構造的に書くための手段として非常に有効だからです。記号を1つ加えるだけで指示の区切りがはっきりし、プロンプトを書き慣れていない人でも一定の品質に近づけられます。すべての記法を覚える必要はありませんので、まずは見出しと箇条書きの2つから使ってみてください。
マークダウン形式の代表的な書き方の例
| 書きたいもの | 記号 | 例 |
|---|---|---|
| 見出し | # | # 大見出し ## 中見出し |
| 箇条書き | - | - りんご |
| 番号付きリスト | 1. | 1. 最初に |
| 強調(太字) | ** | **重要** |
| 区切り線 | --- | (横線が引かれる) |
#の数を増やすと見出しのレベルが下がっていく(#→##→###)のがポイントです。
プロンプトの書き方link
実際の書き方を見てみましょう。請求書から請求日を取得する、もっとも代表的なプロンプトは次のように書きます。
請求日を抽出してください。 # 回答形式 YYYY年M月D日 # 回答例 2025年1月1日 # 注意事項 - 和暦は西暦に変換してください。
このプロンプトは、次の3種類の命令から組み立てられています。
書く順番は、まず冒頭に基本命令です。そのあとに、回答形式・回答例・注意事項といった追加命令・補足命令を足してプロンプトを補強していきます。
いきなり完成形を目指す必要はありません。基本命令だけで解析してみて、結果を見ながら必要な指示を足していくのが、もっとも確実な進め方です。
単項目のプロンプトlink
発注日・取引先名・納期・納品先のような単項目(1つの値だけを取る項目)では、プロンプト欄にそのまま文章を書きます。
チュートリアルで設定した「発注日」であれば、次のような形です。
発注日を抽出してください。 # 回答形式 YYYY/MM/DD # 回答例 2025/11/26 # 注意事項 - 和暦は西暦に変換してください。
表項目のプロンプトlink
一方、発注明細のような表項目(表(CSV)形式の解析項目)では、プロンプトの入力形式そのものが変わります。
表項目では、商品名・数量・単位・備考といった列ごとに指示が必要になるため、1つの文章にまとめて書こうとするとプロンプトが長くなり、どこを直せばよいのかわからなくなってしまいます。
そのため、表項目のプロンプトは入力補助のある専用の画面で作成します。
| 入力欄 | 内容 |
|---|---|
| 個別入力 | 表項目(列)ごとにプロンプトを設定する欄。列単位で指示を書き分けられる |
| プロンプト見出し | 「回答例」「回答形式」「注意事項」などの見出しを、ボタンで追加できる。任意の見出し(禁止事項・ルールなど)も追加できる |
| 全体指示 | 表全体に対する指示。明細全体の抽出ルールや注意事項を書く |
| プレビュー | 個別入力と全体指示を1つのプロンプトに統合した結果。直接編集はできず、個別入力を直すと自動的に更新される |
チュートリアルで作成した「発注明細」であれば、次のように列ごとに指示を分けて設定します。
| 表項目 | 設定する指示の例 |
|---|---|
| 商品名 | 型番・型式も含めて正確に抽出してください。 |
| 数量 | 数値形式で回答してください。 |
| 単位 | 書類に記載がない場合は空欄にしてください。 |
| 備考 | 納期や取り扱いに関する指示が書かれている場合に抽出してください。 |
Tips:「列への指示」と「表全体への指示」は分けて書く
「金額が0円の行は除外する」「小計・合計の行は明細に含めない」といった指示は、特定の列ではなく明細全体に対するルールです。こうした指示は個別入力ではなく、全体指示に書いてください。
列への指示と全体への指示が混ざると、AIがどの範囲に適用すべきか判断しにくくなります。
表項目のプロンプト作成画面の詳しい使い方は、マニュアルの表形式で作成を参照してください。
以前の方法で作成した表項目のプロンプト(1つの長い文章にまとめて書かれたもの)は、AIアシスタントのCSV変換モードを使うと、表項目ごとに整理された形へ変換できます。変換後は、元の指示と変わっている箇所がないかを必ず確認してください。
こんなプロンプトは避けるlink
最後に、うまくいかないプロンプトによくあるパターンをまとめます。解析結果が安定しないときは、まずこの表に当てはまっていないかを確認してください。
| 避けたい書き方 | 何が起こるか | 直し方 |
|---|---|---|
| 社内用語だけで書く (例:取引先名を抽出してください。) | 書類に書かれていない言葉のため、AIがどれを指すのか判断できない | 書類の上で使われている言葉に置き換える(注文者名) |
| 1つの解析項目で複数の値を取ろうとする (例:発注日と納期を抽出してください。) | 2つの値が1つの欄に混在し、アウトプットでそのまま使えない | プロンプトを工夫するのではなく、解析項目を分ける |
| 前置きや言い回しが長い (例:お手数ですが、可能な範囲で読み取っていただけると助かります。) | 指示の本体が埋もれ、あとから見返したときに何を求めているのかわからなくなる | 必要なことだけを端的に書く |
| 曖昧な修飾を使う (例:なるべく正確に、適切な形式で回答してください。) | 「適切」の基準がないため、書類ごとに結果が変わる | 形式・単位・桁数を具体的に指定する |
| 回答形式を決めない | 「令和7年11月26日」「2025.11.26」など表記がばらつき、アウトプットでそのまま使えない | 「# 回答形式」でYYYY/MM/DDのように明示する |
| 記載がない場合の扱いを書かない | 空欄になる、別の値で埋められる | 「記載がない場合は〇〇と回答してください。」と決めておく |
| 紛らわしい情報があるのに禁止事項を書かない | 似た情報を取り違える(宛名と発行元など) | 「〜は抽出しないでください。」を添える |
| 注意事項を1つの段落に詰め込む | 指示の一部が読み飛ばされる | 見出しと箇条書きに分けて構造化する |
| 書類に書かれていない情報を取らせようとする (例:商品コードを抽出してください。) | 書類上に存在しないため、推測した値が返る | プロンプトではなく外部ファイルでマスタを参照して補う |
プロンプトを直したら、必ず複数の様式の書類で試してください。1通でうまくいった書き方が、ほかの取引先の書類でも通用するとは限りません。
また、解析はAIがおこなうため、同じファイル・同じプロンプトでも毎回まったく同じ結果になるとは限りません。プロンプトを変更したあとは、自分の目で解析結果を確認することを習慣にしてください。
Tips:書き方に迷ったらAIアシスタントに相談する
どう直せばよいか手がかりがないときは、解析項目の編集画面からAIアシスタントに相談できます。
- プロンプト診断モード:いま設定されているプロンプトの問題点を指摘し、改善案を提案してもらう
- プロンプト提案モード:取得したい内容を伝えて、新しいプロンプトを提案してもらう
提案されたプロンプトには、なぜその書き方がよいのかという解説も添えられます。自分で書く前に型を知るという意味でも、プロンプトに慣れないうちは積極的に活用してください。
ここまでで準備できていることlink
- プロンプトが「解析項目ごとに登録しておく指示」であることを理解できている
- シンプル・具体的・構造的という、プロンプトを書くときの3つのコツを把握できている
- 基本命令・追加命令・補足命令の組み立て方と、マークダウン形式を使って構造的に書く方法がわかっている
- 単項目と表項目で、プロンプトの入力形式が異なることを理解できている
- 解析結果が安定しないときに、プロンプトのどこを見直せばよいかがわかっている
ここまでで、発注書を読み取るためのドキュメントタイプと、その精度を調整するための考え方がそろいました。次のページエクスポートからは、読み取った結果を2つのアウトプット(基幹システム取込データ・発注指示書)として出力できるように、ファイル出力の設定を進めます。
