> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Desktop Agentの仕組み

> Windows 版デスクトップエージェントがブラウザとアプリのトラフィックを取り込み、割当てられた Control Profile と Guard Policy を適用する仕組みです (Starfort v1.4 版)

<Note>
  **Windows 専用。** 製品内での操作体験を示す注釈付きスクリーンショットは現在最終調整中です。
</Note>

登録が完了しプロジェクトに割り当てられると、Desktop Agent は**透過的に**動作します。AI ツール（Web チャットアシスタント、デスクトップアプリ、CLI ツールなど）を通常どおり使い続けることができ、その間 Agent が送信内容を検査し、会社の [Guard Policy](/ja/v1.4/concepts/guard-policy) を適用します。統合すべき SDK はなく、有効化するものもありません。

## どのリクエストが検査されるか

Agent は、会社が統制する AI サービス — プロジェクトの [Control Profile](/ja/v1.4/admin/control-profiles) で定義されたキャプチャ対象 — へのトラフィックのみを傍受します。PC 上のその他のリクエストはすべてそのまま通過し、検査されることも、Starfort に送信されることもありません。

## 検査されたリクエストに何が起こるか

検査された各リクエストには、3 つの[アクション](/ja/v1.4/concepts/actions-pass-mask-block)のいずれかが適用されます。

* **PASS** — 入力は変更されずに送信され、通知はありません。
* **MASK** — 機微な箇所（例えば電話番号やメール）は、**リクエストがマシンから離れる前に** `[PHONE_NUMBER_1]` のようなプレースホルダートークンに置き換えられます。AI サービスが目にするのは、常にマスクされたバージョンのみです。
* **BLOCK** — リクエストが停止され、AI サービスには**何も送信されません**。通知で理由が説明されます。[ブロックおよびマスクの通知](/ja/v1.4/desktop/block-mask-notifications)を参照してください。

<Note>
  Topic チェック（主題をレビュー対象としてフラグ付けできるポリシータイプ）は、Desktop Agent では**記録されますが適用されません** — PASS として扱われるため、リクエストを変更したり停止したりすることはありません。送信内容に影響するのは PASS、MASK、BLOCK のみです。
</Note>

## Agent が Starfort に接続できない場合

ネットワーク障害時の動作は、会社の **Network Fail-Safe** 設定に従います — *fail-open*（傍受したすべてのリクエストを許可、デフォルト）または *fail-closed*（傍受したすべてのリクエストをブロック）のいずれかであり、接続が回復すると自動的に復旧します。[Desktop Agent 設定](/ja/v1.4/admin/desktop-agent-settings)を参照してください。

これは、Agent が本当に Starfort に接続できない場合にのみ適用されます。接続は問題ないものの解析自体を完了できない場合、会社が fail-open を選択していても、リクエストは常にブロックされます。

これとは別に、プロジェクトは検査されたすべてのリクエストが**監査記録を残した後にのみ通過**するよう要求できます（**Opticon フェイルセーフ** 設定の *Fail-Closed*）。この場合、解析自体は成功しても監査記録を書き込めなければリクエストはブロックされます。まれにしか発生せず、記録が復旧すれば自動的に通常動作へ戻ります。