コンテキストエンジニアリング
AI活用のためのデータ整備チェックリスト
AIが答えの材料にできるのは、検索や指示でAIに渡した社内の文書とデータだけです。コンテキストエンジニアリングでは、利用者や開発者が、AIに渡す情報を選んで組み立てます。社内のデータが部署ごとに散らばり、古い版も混ざっていると、正しい情報を選べません。どの企業にも共通するデータを、AIを使う3つの段階に分けて85項目にしました。
使い方
- 自社がいま使っているAIの段階を、3つの段階から選んでください。
- その段階までの項目のそれぞれで、「ある」「一部ある」「ない」のどれかを選んでください。
- 「一部ある」と「ない」を選んだ項目から、取り組む3項目を選んでください。
- 選んだ3項目に、担当者と期限を書いてください。
「ある」は、「どんなデータか」に書いた中身がそろっているときだけ選んでください。
3つの段階
段階2と段階3では、前の段階のデータもそのまま使います。
4つの作業
着手の順番
最初に、生成AIの利用ガイドラインと機密区分の定義を決めてください。 社員は、AIに貼ってよい資料かどうかを、この2つを見て判断します。2つが決まっていないと、慎重な社員は規程や顧客の資料をAIに貼りません。その結果、段階1の対話型AIからも、一般論の答えしか返ってきません。判断を社員に任せたままにすると、顧客の個人情報を個人契約のAIサービスに貼る社員も出ます。ガイドラインには、使ってよいAIサービスの名前と、機密区分ごとの入力の可否を表で書いてください。
段階2に進む前に、規程の古い版と広すぎる閲覧権限を直してください。Microsoft Copilotが答えの材料にするのは、利用者が表示の権限を持つ社内の文書とメールです。共有フォルダに、2024年版と2026年版の返品規程が並んでいるとします。エージェントは質問のたびに、どちらかの版を引くことがあります。
段階3に進む前に、リポジトリにAGENTS.mdかCLAUDE.mdと、テストを実行するコマンドを置いてください。コーディングエージェントは、テストの結果を見て自分の変更が正しいかを確かめます。
段階1ブラウザの対話型AIでも効果が出るデータ
社員は、ブラウザでChatGPTやClaude、Microsoft Copilot Chatを開いて使います。この段階のデータは、社員が会話に貼るか添付して渡すものです。1テーマ1ファイルにまとめておくと、社員は必要な分だけ選んで貼れます。
ルールと安全
生成AIの利用ガイドライン
- どんなデータか
- 使ってよいAIサービスの名前、入力してよい情報と禁止する情報、出力を確かめる手順を定めた社内ルール
- いつ使うか
- 社員がAIを使い始めるとき、使い方に迷ったとき
情報セキュリティ規程
- どんなデータか
- 社外秘の扱い、持ち出し、社外のサービスを使ってよい条件を定めた規程
- いつ使うか
- 社員が、資料をAIに貼ってよいかを判断するとき
機密区分の定義
- どんなデータか
- 「公開」「社内限」「社外秘」「極秘」のような区分と、区分ごとの文書の例と扱い方
- いつ使うか
- 社員が、文書をAIに入力してよいかを区分で決めるとき
個人情報の取り扱いルール
- どんなデータか
- 個人情報にあたる項目の一覧と、AIに渡す前に伏せる方法
- いつ使うか
- 顧客や社員の情報を含む資料を、AIで扱う前
著作権と引用のルール
- どんなデータか
- 社外の記事や画像をAIに渡すときと、AIの出力を社外に出すときの決まり
- いつ使うか
- 社外向けの資料や記事をAIで作るとき
顧客との契約上の制約
- どんなデータか
- 顧客の資料を社外のサービスに渡すことや、再委託を禁じる契約の条項をまとめた一覧
- いつ使うか
- 顧客から預かった資料をAIで扱う前
業界の規制とガイドラインの要点
- どんなデータか
- 業界の法令、監督官庁のガイドライン、業界団体の基準のうち、自社に関係する箇所をまとめた資料
- いつ使うか
- AIに契約書や広告文を確認させるとき
言葉と表記
業界用語集
- どんなデータか
- 業界の専門用語、略語、法令上の定義を1語1行で並べた一覧
- いつ使うか
- AIに業界の資料を読ませるとき、業界向けの文書を書かせるとき
社内用語集
- どんなデータか
- 社内の略語、部署の通称、社内でだけ通じる呼び名と、その意味の一覧
- いつ使うか
- AIに社内の議事録や報告書を読ませるとき
表記ルール
- どんなデータか
- 社名と製品名の正式な書き方、送り仮名、数字と日付の書き方、文体の決まり
- いつ使うか
- AIに社外向けの文書を書かせるとき
製品名と型番の一覧
- どんなデータか
- 製品の正式名、略称、型番、販売の状態を並べた表
- いつ使うか
- AIに見積や問い合わせの回答を書かせるとき
会社と商品
会社概要
- どんなデータか
- 事業内容、拠点、沿革、組織の大まかな構成をまとめた資料
- いつ使うか
- AIに提案書や挨拶文の下書きを頼むとき
事業目標とKPI
- どんなデータか
- 今期の事業目標、部署ごとのKPI、重点施策
- いつ使うか
- AIに企画書や報告書の論点を整理させるとき
組織図と役割
- どんなデータか
- 部署の構成、部署ごとの担当業務、問い合わせ窓口
- いつ使うか
- AIに、社内の誰に相談すればよいかを調べさせるとき
商品とサービスの説明資料
- どんなデータか
- 商品ごとの特長、対象の顧客、価格の考え方、他社との違い
- いつ使うか
- AIに提案書や営業メールを書かせるとき
顧客像
- どんなデータか
- 主な顧客の業種、規模、担当者の役職、よくある悩みをまとめた資料
- いつ使うか
- AIに顧客向けの文面や提案の切り口を考えさせるとき
競合の比較表
- どんなデータか
- 主な競合の商品、価格帯、強みと弱みを並べた表
- いつ使うか
- AIに提案書の比較の節や想定問答を作らせるとき
ブランドと文章の調子
- どんなデータか
- 社外向けの文章の言い回し、避ける言葉、ロゴと色の使い方
- いつ使うか
- AIに広報文やWebサイトの文章を書かせるとき
文書の型
文書のテンプレート
- どんなデータか
- 報告書、議事録、提案書、メールの決まった構成と見出し
- いつ使うか
- AIに文書の下書きを頼むとき
成果物の見本
- どんなデータか
- 社内で良い出来とされた提案書や報告書と、良いと判断した理由
- いつ使うか
- AIに自社の水準に合わせた下書きを書かせるとき
依頼文の例
- どんなデータか
- 業務ごとに、AIへの頼み方と一緒に貼る資料を書いた例文
- いつ使うか
- 社員が同じ種類の作業をAIに頼むとき
業務の知識
業務の手順書
- どんなデータか
- 1つの業務を手順に分け、手順ごとの入力、出力、担当者を書いた文書
- いつ使うか
- AIに手順の抜けを確かめさせるとき、新人向けの説明を作らせるとき
業務の判断基準
- どんなデータか
- 「値引き率10%までは担当者が決め、超えたら課長が承認」のような条件と結論の表
- いつ使うか
- AIに申請や見積の可否を下調べさせるとき
社内規程
- どんなデータか
- 就業規則、経費精算、出張、購買などの規程の最新版
- いつ使うか
- 社員がAIに規程の該当箇所を探させるとき
よくある質問と回答
- どんなデータか
- 社内外からよく来る質問と回答に、根拠の文書名を付けた一覧
- いつ使うか
- AIに問い合わせへの返信を下書きさせるとき
過去の提案書と報告書
- どんなデータか
- 過去の案件で作った提案書、見積書、報告書
- いつ使うか
- AIに似た案件の文書を下書きさせるとき
会議の録音と文字起こし
- どんなデータか
- 会議や商談の録音と、話した人の名前が付いた文字起こし
- いつ使うか
- AIに議事録や顧客の要望の一覧を作らせるとき
紙の書類と画像だけのPDF
- どんなデータか
- 紙の申込書や契約書、スキャンしたPDFを、文字を選択できる形にしたもの
- いつ使うか
- AIに過去の契約書や申込書を読ませるとき
人が見るための表
- どんなデータか
- 色や結合セルで意味を表した表を、1行1件にして意味を列の値にした表
- いつ使うか
- AIに表を集計させるとき、条件で絞り込ませるとき
段階2AIエージェントで効果が出るデータ
Copilot Studioで作るエージェントは、社内の文書を自分で検索し、メールの送信や表の更新まで行います。この段階のデータは、エージェントが自分で探して使うものです。エージェントは置き場所にある文書をすべて検索の候補にするため、古い版や広すぎる権限がそのまま答えに出ます。
置き場所と権限
ナレッジの置き場所
- どんなデータか
- エージェントが検索する社内文書を、テーマごとに集めた共有フォルダかサイト
- いつ使うか
- エージェントに社内文書を登録するとき
閲覧権限の設計
- どんなデータか
- フォルダやサイトごとに、誰が閲覧と編集をできるかを決めた表
- いつ使うか
- エージェントを全社に公開する前
機密ラベル
- どんなデータか
- Microsoft Purviewの秘密度ラベルのように、文書ごとに付けた機密区分の印
- いつ使うか
- エージェントが答えに使う文書を、区分で絞るとき
文書の版と施行日
- どんなデータか
- 文書ごとに有効な版が1つに決まり、本文に版と施行日が書かれた状態
- いつ使うか
- エージェントが規程を根拠に答えるとき
更新日と管理者
- どんなデータか
- 文書ごとの最終更新日と、内容に責任を持つ管理者の名前
- いつ使うか
- エージェントの答えの根拠が古くないかを確かめるとき
AIサービスの契約とデータの扱い
- どんなデータか
- 使うAIサービスごとに、入力したデータを学習に使うかと、データを保存する国と期間をまとめた表
- いつ使うか
- エージェントに社外秘の文書を読ませる前
マスタデータ
顧客マスタ
- どんなデータか
- 顧客ID、正式名、担当者、取引の状態を、全システムで同じIDにそろえた一覧
- いつ使うか
- エージェントが顧客ごとの取引や問い合わせをまとめるとき
商品マスタ
- どんなデータか
- 商品コード、正式名、価格、適用開始日、販売の状態の一覧
- いつ使うか
- エージェントが見積や在庫を確かめるとき
社員と組織のマスタ
- どんなデータか
- 社員の所属、役職、連絡先、上長の一覧
- いつ使うか
- エージェントが承認者や担当者に連絡を回すとき
取引先マスタ
- どんなデータか
- 仕入先や外注先の名前、取引条件、契約の期限
- いつ使うか
- エージェントが発注や支払いを確かめるとき
業務の流れ
業務フロー図
- どんなデータか
- 業務の手順と、手順ごとの担当、使うシステム、受け渡す書類を描いた図
- いつ使うか
- エージェントに任せる手順を決めるとき
決裁権限の表
- どんなデータか
- 金額や内容ごとに、誰が承認できるかを定めた表
- いつ使うか
- エージェントが申請を承認者に回すとき
人へ引き継ぐ基準
- どんなデータか
- 金額の上限、クレーム、契約の変更のように、エージェントが処理を止めて人に回す条件の一覧
- いつ使うか
- エージェントが自分で処理してよいかを判断するとき
担当の割り振りルール
- どんなデータか
- 問い合わせや依頼の種類ごとに、受け持つ部署と担当者を決めた表
- いつ使うか
- エージェントが依頼を担当者へ振り分けるとき
メールの文例
- どんなデータか
- 受付、督促、お詫びなど、状況ごとの社外向けメールの文例
- いつ使うか
- エージェントがメールを下書きして送るとき
履歴と記録
問い合わせとチケットの履歴
- どんなデータか
- 問い合わせの内容、分類、回答、対応結果を1件1行で残した記録
- いつ使うか
- エージェントが過去の回答例を探すとき
案件ごとの記録
- どんなデータか
- 提案書、見積書、議事録、振り返りを案件ごとにまとめたフォルダ
- いつ使うか
- エージェントが似た過去の案件を探すとき
意思決定の記録
- どんなデータか
- 日付、決めた内容、理由、却下した案、決めた人の記録
- いつ使うか
- エージェントが方針の理由を説明するとき
つなぐ先と操作の範囲
データの所在の一覧
- どんなデータか
- データ名、保存しているシステム、取り出し方、管理する部署の表
- いつ使うか
- エージェントをどのシステムにつなぐかを決めるとき
APIとコネクタの一覧
- どんなデータか
- 業務システムごとに、外から読み書きできる口と認証の方法をまとめた一覧
- いつ使うか
- 開発者がエージェントを業務システムにつなぐとき
エージェントに許す操作の一覧
- どんなデータか
- 読むだけ、下書きまで、送信や更新までの3段階で、操作ごとに許す範囲を決めた表
- いつ使うか
- エージェントにメールの送信やデータの更新をさせる前
エージェントの操作ログ
- どんなデータか
- エージェントがいつ、誰の依頼で、何を読み、何を変えたかの記録
- いつ使うか
- 担当者が誤った操作の原因を調べるとき
評価と改善
想定質問と正解のセット
- どんなデータか
- よく来る質問と、正しい答えと根拠の文書を対にした30〜50件の一覧
- いつ使うか
- エージェントを公開する前と、文書を差し替えたあと
答えの採点基準
- どんなデータか
- 正しさ、根拠の示し方、言ってはいけないことの3つで答えを採点する基準
- いつ使うか
- 担当者がエージェントの答えを点検するとき
誤答と直した記録
- どんなデータか
- エージェントが間違えた質問、原因、直した文書の記録
- いつ使うか
- 同じ間違いが繰り返されていないかを確かめるとき
段階3AIによる自律開発に必須のデータ
Claude CodeやCodexのようなコーディングエージェントは、リポジトリを読んでコードを書きます。さらにテストを実行し、失敗したコードを自分で直します。エージェントは人に聞かずに作業を進めるため、規約とテストがそろっていないと、自分の変更が正しいかを判断できません。
指示と規約
AGENTS.mdとCLAUDE.md
- どんなデータか
- リポジトリの直下に置くエージェント向けの指示書で、概要、ビルドとテストのコマンド、守る規約、触ってはいけない場所を書く
- いつ使うか
- エージェントが作業を始めるとき。エージェントは毎回最初に読む
コーディング規約
- どんなデータか
- 命名、ディレクトリ構成、エラー処理、ログの出し方の決まり
- いつ使うか
- エージェントがコードを書くとき
LinterとFormatterの設定ファイル
- どんなデータか
- ESLintやPrettier、Ruffのような検査と整形の道具の、設定ファイルの実物
- いつ使うか
- エージェントが、書いたコードが規約どおりかを自分で確かめるとき
セキュアコーディング規約
- どんなデータか
- 入力の検証、認証と認可、秘密情報の扱いなど、脆弱性を防ぐ書き方の決まり
- いつ使うか
- エージェントがログインや外部からの入力を扱うコードを書くとき
Gitの運用ルール
- どんなデータか
- ブランチの切り方、コミットメッセージの書き方、プルリクエストのテンプレート
- いつ使うか
- エージェントがコミットし、プルリクエストを作るとき
レビューの観点
- どんなデータか
- レビューで必ず確かめる項目の一覧
- いつ使うか
- エージェントが自分の変更を見直すとき、人がレビューするとき
採用技術とバージョン
- どんなデータか
- 使う言語、フレームワーク、ランタイムとそのバージョン、使ってよいクラウドのサービスの一覧
- いつ使うか
- エージェントが技術やライブラリを選ぶとき
仕様
要件定義書
- どんなデータか
- 作るものの目的、利用者、機能の一覧、対象外にするもの
- いつ使うか
- エージェントに機能の実装を任せるとき
受け入れ条件
- どんなデータか
- 機能ごとに「この入力ならこの結果」と確かめられる条件
- いつ使うか
- エージェントが実装の完了を判断するとき
画面仕様とデザインシステム
- どんなデータか
- 画面の構成、部品、色と文字の決まり
- いつ使うか
- エージェントが画面を作るとき
API仕様書
- どんなデータか
- エンドポイント、入力、出力、エラーを、OpenAPIのような機械が読める形式で書いたもの
- いつ使うか
- エージェントがAPIを作るとき、呼び出すとき
データベースの設計
- どんなデータか
- テーブル、列、型、関係を書いたスキーマとER図
- いつ使うか
- エージェントがデータを読み書きするコードを書くとき
ドメインの用語とモデル
- どんなデータか
- 業務の用語と、コード上のクラス名や列名の対応表
- いつ使うか
- エージェントが業務の言葉をコードに置き換えるとき
設計
システム構成図
- どんなデータか
- システム、外部サービス、データの流れ、接続点を、Mermaidのような文字の形式で書いた図と説明文
- いつ使うか
- エージェントが変更の影響範囲を調べるとき
設計判断の記録
- どんなデータか
- 技術の選定や設計の方針を選んだ理由と却下した案を、1件ずつ残した文書で、ADRとも呼ぶ
- いつ使うか
- エージェントが既存の設計に沿って変更するとき
非機能要件
- どんなデータか
- 応答時間、同時に使う人数、稼働率、データの保存期間、バックアップと復旧の目標値
- いつ使うか
- エージェントが性能や負荷に関わるコードを書くとき
外部連携の仕様
- どんなデータか
- つなぐ外部サービスの仕様書、認証の方法、呼び出しの回数の上限
- いつ使うか
- エージェントが外部サービスとつなぐコードを書くとき
インフラの構成とIaC
- どんなデータか
- サーバーやネットワークの構成を、TerraformやCDKのようなコードで書いたもの
- いつ使うか
- エージェントが環境を作るとき、設定を変えるとき
検証
テスト方針
- どんなデータか
- 単体テスト、結合テスト、E2Eテストの分け方と、必ずテストを書く範囲
- いつ使うか
- エージェントがテストを書くとき
自動テスト
- どんなデータか
- コマンド1つで実行でき、成功と失敗がはっきり出るテストコード
- いつ使うか
- エージェントが変更のたびに正しさを確かめるとき
テストデータ
- どんなデータか
- 実在の顧客や社員の情報を含まない、架空の値で作ったデータ
- いつ使うか
- エージェントがテストを実行し、画面を確かめるとき
開発環境の構築手順
- どんなデータか
- 必要なツールとバージョン、インストールと起動のコマンド
- いつ使うか
- エージェントが新しい環境で作業を始めるとき
ビルドと実行のコマンド
- どんなデータか
- ビルド、起動、テスト、Lintのコマンドを1か所にまとめた一覧
- いつ使うか
- エージェントが変更を試すとき
CI/CDの設定
- どんなデータか
- プルリクエストごとに、ビルドとテストとデプロイを自動で動かす設定ファイル
- いつ使うか
- エージェントの変更をマージする前に、自動で確かめるとき
運用と安全
依存ライブラリとOSSライセンスの方針
- どんなデータか
- 使ってよいライブラリ、使ってはいけないライセンス、バージョンの決め方
- いつ使うか
- エージェントがライブラリを追加するとき
環境変数の一覧
- どんなデータか
- 必要な環境変数の名前と意味の一覧で、値は書かずに置き場所だけを書く
- いつ使うか
- エージェントが設定を読むコードを書くとき
秘密情報の管理方針
- どんなデータか
- APIキーやパスワードの保管場所と、エージェントに読ませないファイルの一覧
- いつ使うか
- エージェントに作業を任せる前、権限を設定するとき
リリースと変更管理の手順
- どんなデータか
- 本番に出す前の承認、リリースの手順、元に戻す手順
- いつ使うか
- エージェントの変更を本番に出すとき
障害対応の手順と過去の障害記録
- どんなデータか
- 障害の調べ方、連絡先、過去の障害の原因と直し方
- いつ使うか
- エージェントに障害の原因を調べさせるとき
ログと監視の方針
- どんなデータか
- ログに出す項目、出してはいけない項目、監視する指標
- いつ使うか
- エージェントがログを出すコードを書くとき、障害を調べるとき
課題とタスクの一覧
- どんなデータか
- Issueやチケットに背景、やること、完了の条件を書いたもの
- いつ使うか
- エージェントに次の作業を割り当てるとき
取り組む3項目と担当
チェックリストで「一部ある」か「ない」を選んだ項目が、段階の順に下に並びます。取り組む項目を3つまで押して選び、担当者と期限を書いてください。
| 順 | 項目 | 担当者 | 期限 |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 |
出典
- Microsoft Copilotが表示する組織データは、利用者が表示の権限を持つものに限られます。出典はMicrosoft Learn「Microsoft Copilot のデータ、プライバシー、セキュリティ」です。2026年10月22日に内容を確認しました。
- AGENTS.mdは、コーディングエージェントへの指示を書くための公開の形式です。OpenAI CodexやGitHub Copilot、Cursorが対応しています。出典はagents.mdで、2026年10月22日に確認しました。
- 返品規程の期限は、説明のために作った例です。