> ## 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.
# Control Profile
> 회사 수준의 Control Profile로 Desktop Agent가 어떤 AI 서비스를 어떻게 거버넌스할지 정의합니다.
**Control Profile**은 [Desktop Agent](/ko/v1.2/desktop/how-it-works)에게 어떤 AI 서비스를 어떻게 거버넌스할지 알려줍니다. Control Profile은 **회사** 수준에서 정의되며 Desktop Agent 프로젝트에 적용됩니다.
**Desktop Agent › Control Profile**을 열어 회사의 프로필을 확인합니다. 회사가 Desktop Agent 기능을 처음 활성화하면, Starfort는 일반적인 AI 서비스(ChatGPT, Claude, Copilot, Gemini, Perplexity, Cursor, DeepSeek, Grok, GitHub Copilot 등)에 대한 시작용 프로필 세트를 \*\*시딩(seed)\*\*합니다. 그 이후부터 회사가 이 세트를 **완전히 소유**합니다: 어느 프로필의 이름, 설명, 활성화 상태, 규칙도 편집할 수 있고, 프로필을 추가하고 삭제할 수 있으며, 환경 간에 정책을 옮기기 위해 **전체 세트를 JSON으로 가져오기/내보내기**까지 할 수 있습니다.
## 프로필의 구성 요소
각 프로필은 최대 세 가지 메커니즘을 결합합니다:
| 메커니즘 | 목적 |
| ------------------------------ | --------------------------------------------- |
| **Guardian targets** (capture) | Agent가 가로채어 평가를 위해 Guardian으로 전송하는 URL/요청입니다. |
| **Matching whitelist** | 명시적으로 통과가 허용되는 요청입니다. |
| **URL blacklist** | 완전히 차단되는 URL입니다(평가 없음). |
프로필은 Guardian targets가 있을 때(Guardian을 호출할 수 있음) **Dynamic**이며, 필터링만 수행할 때(whitelist/blacklist, Guardian 호출 없음) **Static**입니다. 이 Static/Dynamic 유형은 `guardianTargetList`에 항목이 있는지 여부에 따라 **생성 시 고정**되며, 이후에는 **변경할 수 없습니다** — 전환하려면 새 프로필을 생성하세요. **Dynamic** 프로필만 Guardian에 매핑할 수 있으며, Static 프로필은 whitelist/blacklist 필터링만 수행합니다.
각 프로필에는 **Enabled** 토글이 있습니다. **off**일 때 프로필은 런타임에 완전히 건너뛰어집니다 — 세 단계 중 어느 것도 실행되지 않으며 **Opticon 트레이스도 생성되지 않습니다**. 규칙은 유지되며 비활성 상태일 뿐입니다.
## 편집
**Add**로 프로필을 생성하고, 행 작업으로 편집/비활성화/삭제하며, **JSON** 보기로 메커니즘을 직접 편집할 수 있습니다. JSON 보기에서는 전체 프로필, 규칙만(세 메커니즘 전부), 또는 단일 메커니즘을 교체할 수 있습니다. 저장 시 JSON의 유효성을 검사하고, 각 항목의 `id`가 해당 메커니즘 내에서 고유한지 확인하며, 변경 불가능한 Static/Dynamic 유형을 강제합니다. **서로 다른** Guardian으로 라우팅되는 두 Guardian-target 항목이 겹치면, Starfort는 **경고**합니다(저장을 차단하지는 않습니다).
## 변경 사항은 자동으로 전파됩니다
프로필에 대해 가한 모든 변경 — 규칙, 메타데이터, 활성화 상태, 또는 삭제 — 은 그것을 사용하는 모든 프로젝트와 Guardian으로 \*\*자동으로 캐스케이드(cascade)\*\*됩니다. 재할당 단계는 없습니다. 프로필을 삭제하면 모든 프로젝트와 Guardian 매핑에서 분리됩니다.
## 레시피