本文へスキップ
表示言語: 日本語
監査 / Signal

コード支援ツールで除外したファイル: 何から除外されたのか

架空の文書を使い、索引、チャット、エージェント、ターミナル、MCPの除外範囲を確認します。

記事の言語: 日本語

赤いエプロンの女性が丸いガラスレンズのある金色の装置のそばにいる。
目次

プロジェクトのフォルダーに「アシスタントには渡さない」と書かれたファイルがあります。チームは除外規則に追加し、コード提案を確認します。提案から内容は消えました。翌日、別の経路でファイルを読むエージェントが実行されます。扉の貼り紙は残っていますが、もう一つの入口ができました。

これは架空の状況です。実際の資料を作業環境に入れる前に考える価値があります。「除外」という言葉だけでは、インデックス作成、提案、チャットへの添付、コマンド実行のどこから外したのか分かりません。各機能は異なる仕組みと権限を使う場合があります。

展示空間の配置アプリを作る架空の会社Łukを考えます。アシスタントには画面のコードを手伝わせ、取引先との契約書フォルダーは対象外です。会社は本物の契約書で保護を試さず、架空の印だけを含む文書を置いた別のテストプロジェクトを用意します。受け入れ対象は、実際に使う機能で特定の除外がどう働くかです。

一つの除外に複数の約束がある

最初の問いは、ファイルが何から除外されたかです。インデックスは、プロジェクトで情報を探しやすくするために準備した集合です。インデックスにないことだけでは、別のツールが直接読めるかは分かりません。同様に、開いた文書に提案が出ないことは、エージェントがターミナルのコマンドで何をできるかを示しません。

Łukでは、実際に使う機能の一覧から受け入れを始めます。入力中の提案、選択部分への質問、複数ファイルで作業するエージェントです。市場の全製品を試す必要はありませんが、使うエディター、拡張機能の版、アカウント、プロジェクト、有効なモードは明記します。提案の結果をエージェントの欄へ記入してはいけません。

受け入れ担当者は適用中の規則の説明を参照できる必要があります。管理者の設定の結果は見えても、利用者自身は変更できない場合があります。設定の責任者と現在の適用範囲を得る方法を報告書に記します。アカウント変更後に同じ規則を試したのか、見た目の似た別のプロジェクトを試したのかを区別するためです。

GitHub Copilotのコンテンツ除外の文書は、VS Codeや他のエディターのCopilot ChatのEditおよびAgentモードでは除外がサポートされないと説明しています。第三者のMCPサーバーが除外を守る保証もないと記しています。作業方法の選択に関係する、特定の機能の制限です。

すべての試行で禁止内容が読まれるという意味ではありません。選んだモードを対象にしない設定だけを、期待する境界の根拠にできないという意味です。資料をエージェントから見えなくする必要があるなら、その実際の能力を対象とする仕組みが必要です。AI連携の権限 (ポーランド語)から始め、個別の環境に照らして評価します。

期待する効果を普通の言葉で記録します。たとえば、合意したモードのアシスタントは指定パスの架空文書の内容を取得しない、という形です。名前を隠すのか、検索を防ぐのか、読み取りを防ぐのか、編集も防ぐのかは別に記します。フォルダー名が見えても内容にアクセスできない場合があります。「名前が見えた」と「内容を読んだ」は別の結果です。

目的に合わせて範囲を選びます。提案を改善するために大きな生成ファイルを除外する規則が、機密資料の要件まで満たす必要はありません。不要なデータを減らす際は、その文書がアシスタントに渡すプロジェクトに必要かを先に確かめます。データの最小化 (ポーランド語)により、パスの規則を試す前に不要なコピーを除けるかもしれません。

使用する読み取り経路をそれぞれ受け入れる

似た構造のファイルを二つ用意します。一つは許可し、もう一つは除外します。それぞれに異なる架空の確認用の印を入れます。検証者が値を知っていれば、本物の契約書を見せずに結果を確認できます。この印を実際のパスワードやアクセスキーと呼ばないでください。規則を変えた時点と適用を確認した時点も記録します。設定更新前の試行は新しい設定の動作を示しません。機能に更新が必要なら準備に含め、実際に試した状態を報告します。

各実行について、機能、ファイル、期待結果、実際に使ったツール、結果を簡潔に残します。架空文書の全文は準備したサンプルに保管できます。通常の報告書には、試行を再現できる参照があれば十分です。後で効果のなかった経路を特定しやすくなります。

最初に許可ファイルがその機能で利用できると確認し、その後で除外ファイルを試します。どちらも読めないなら、機能の故障、パスの誤り、プロジェクトの不在かもしれません。正の対照試験なしの拒否は、除外についてほとんど何も示しません。

「読めません」という回答と、アクセス制限で止められた読み取り試行の記録を分けます。モデルはツールを呼ばずに拒否したり、内容を推測したりできます。記録から過程を判定できなければ未確定とし、環境の責任者と追加の観察方法を決めます。証拠がないことを保護成功の証明に変えないでください。

実際に使う作業方法ごとに別の試行を行います。

  • 提案では両ファイルの動作と、許可された部分への提案に除外内容が現れるかを確認します。
  • チャットでは特定のファイルを指定し、その内容が必要な質問をします。出典への参照が表示されるなら保存します。
  • エージェントモードでは、資料を実際に読んだ各ツールを記録します。最後の回答だけでは経路全体を説明できません。
Aeneiaのコンセプト写真

確認用の印を質問に貼り付けないでください。「ファイルにKORA-742はありますか」と聞けば、読まずに与えられた値を繰り返せます。指定文書に記された印を尋ね、検証者が会話の外にある正解と比べます。別の実行ではファイルの値を変え、古い文脈を使っていないかも調べます。

CursorのIgnore file文書は、.cursorignoreの規則だけでは、エージェントが使うターミナルやMCPサーバーのツールからのアクセスを遮断できるとは保証されないと注意しています。個々の試行の結果がこれだけで決まるわけではありません。環境の別の制限が働く場合もあるため、個別に試す必要があります。一つの結果をエディター全体に帰さず、実際のツールを記録します。

別のCursorの実行モード文書はコマンドのサンドボックスと、一部のコマンドがその外で実行されることを説明しています。表には、.cursorignoreがエージェントからファイルを隠せることも示されています。エージェントから隠すことは、ターミナルやMCPサーバーからのアクセス遮断を保証することとは異なります。コマンドの実行条件は省略できる細部ではなく結果の一部です。

内蔵の読み取りツール、制限された環境のコマンド、外部サーバーのどれを試したかを報告します。権限を変えたら該当する試行を繰り返します。利用者が操作を承認したことは、アクセスできないフォルダーについての以前の説明と操作が一致する証拠にはなりません。承認は判断を、技術的な制限は可能な行動を示します。

Łukは、契約書のない別のコードコピーでエージェントを動かすと決められます。これは具体的な資料準備の判断です。適切に制限した実行環境を用意し、架空データで試す方法もあります。エージェントのサンドボックスのファイルとネットワークの境界 (ポーランド語)は、無視パスの一覧を見るだけより広い受け入れを必要とします。

規則は通常のプロジェクト変更にも耐える必要がある

最初の試行が成功した後、用意したサンプルの範囲内で架空ファイルの名前と場所を変えます。特定パスの規則は、移動した文書に一致しなくなる場合があります。正しく一致した規則をツールがサポートしない問題とは異なります。パターンの誤りと除外の未対応を分けて記録します。

プロジェクトを移す際は既存の会話も考慮します。新しい除外が、すでにタスク履歴に入った文章を自動的に削除するわけではありません。現在の読み取りを確認するには古い内容のない別の実行を始めます。架空の印を含む履歴は二つ目の事例です。アシスタントが以前のどの資料をまだ使えるかを示します。

サブプロジェクトでは、有効な設定をどこから取得するかを確かめます。一か所の設定ファイルが、プロジェクトを開くすべての方法に自動的に適用されると仮定しません。環境の準備担当者は有効な規則と適用確認の方法を示します。進行中の会話だけでなく、環境を再度開いた後にも同じファイルを比べます。

内容のコピーも別の事例です。元の文書の除外は、質問へ直接貼った文章や許可ファイルへコピーした文章を説明しません。添付してよい資料とテストサンプルの見分け方を決めます。パス規則をすべての文に付いて回る見えないラベルとして扱わないでください。

ツールを追加したら対応する試行を繰り返します。サーバーは別のフォルダーを読み、別のアカウントで動き、別の仕組みでファイルを受け取るかもしれません。MCPツールの変更確認 (ポーランド語)は環境に実際に何が追加されたかを記録する助けになります。プロジェクト名が同じでもアクセス経路は同じとは限りません。

アクセスの制限はアシスタントの仕事の信頼性にも影響します。実装やテストの一部を見られないなら、作業報告でその限界を説明します。読んでいない資料を確認したと主張することはできません。

欠けたファイルにプロジェクトの依存関係が書かれているなら、仕事に必要で提供可能な情報を求めるか、対象範囲の限界を示します。記憶からパッケージ一覧を作り直しても、読み取りの代わりにはなりません。特に新しいライブラリーを追加する場合は、AIが提案した依存関係 (ポーランド語)も確認します。

変更を受け入れる際は、「すべて完了」という説明だけでなく、テストのコマンドと結果の証拠 (ポーランド語)と照合します。

エディター、拡張機能、モード、ツール群の変更後、誰が再試行するかを決めます。試した設定、日付、対象外の機能を報告します。合意より広いアクセスが見つかった場合、原因が分かるまで実際の資料の使用を止め、より狭い方法を選びます。失敗した実行のパス、機能、設定を残し、同じ事例で修正を確認します。設定を保存しただけで効果があると判断してはいけません。

Aeneia Auditに相談する際は、仕事の説明、使用機能の一覧、架空のサンプルを用意します。何が、どのツールによって、どの設定で読まれたかという観察可能な動作を話し合えます。ファイル一覧の「除外」という表示だけでは、これらの問いに答えられません。

Aeneia / Aeneia編集部

編集部による記事です。本文中に出典へのリンクがあります。

Aeneiaについて

ご一緒したブランド

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 在ポーランド中国大使館
  • Mixa
Aeneia / Initium

知識から決断へ

整理したい課題をお聞かせください。どこから始めるかを一緒に決めます。

Aeneiaに問い合わせる

パートナーのソリューションを活用しています

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear