> ## 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 Desktop Agent가 일상적인 AI 사용을 보호하는 방식.

<Note>
  **Windows 전용.** 제품 내 경험에 대한 주석이 달린 스크린샷은 마무리 작업 중입니다.
</Note>

등록되어 프로젝트에 할당되면 Desktop Agent는 **투명하게** 작동합니다. 평소처럼 AI 도구(예: 웹 채팅 어시스턴트, 데스크톱 앱, CLI 도구)를 계속 사용하면, Agent가 보내는 내용을 검사하고 회사의 [Guard Policy](/ko/v1.2/concepts/guard-policy)를 적용합니다. 연동할 SDK도, 켜야 할 것도 없습니다.

## 어떤 요청이 검사되는지

Agent는 회사가 거버넌스하는 AI 서비스로 가는 트래픽 — 프로젝트의 [Control Profile](/ko/v1.2/admin/control-profiles)로 정의된 캡처 대상 — 만 가로챕니다. PC의 다른 모든 요청은 그대로 통과하며 절대 검사되거나 Starfort로 전송되지 않습니다.

## 검사된 요청에 일어나는 일

검사된 각 요청은 세 가지 [액션](/ko/v1.2/concepts/actions-pass-mask-block) 중 하나를 받습니다.

* **PASS** — 입력이 변경 없이, 알림 없이 전송됩니다.
* **MASK** — 민감한 부분(예: 전화번호나 이메일)이 `[PHONE_NUMBER_1]` 같은 플레이스홀더 토큰으로 **요청이 기기를 떠나기 전에** 대체됩니다. AI 서비스는 마스킹된 버전만 보게 됩니다.
* **BLOCK** — 요청이 중단되고 AI 서비스로 **아무것도 전송되지 않습니다**. 알림이 그 이유를 설명합니다. [차단 및 마스킹 알림](/ko/v1.2/desktop/block-mask-notifications)을 참고하세요.

<Note>
  Topic 검사(주제를 검토 대상으로 표시할 수 있는 정책 유형)는 Desktop Agent에서 **기록되지만 집행되지는 않습니다** — PASS로 취급되므로 요청을 변경하거나 중단하지 않습니다. 보내는 내용에 영향을 주는 것은 PASS, MASK, BLOCK뿐입니다.
</Note>

## Agent가 Starfort에 연결할 수 없는 경우

네트워크 장애 중의 동작은 회사의 **Network Fail-Safe** 설정을 따릅니다 — *fail-open*(가로챈 모든 요청 허용, 기본값) 또는 *fail-closed*(가로챈 모든 요청 차단) 중 하나이며 — 연결이 복구되면 자동으로 회복됩니다. [Desktop Agent 설정](/ko/v1.2/admin/desktop-agent-settings)을 참고하세요.

이는 Agent가 실제로 Starfort에 연결할 수 없을 때만 적용됩니다. 연결은 정상이지만 분석 자체를 완료할 수 없는 경우에는, 회사가 fail-open을 선택했더라도 요청이 항상 차단됩니다.