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

# 분석 · 시책 제언

> 자연어로 매장 데이터를 분석하고, 답변을 실행 가능한 시책으로 등록하는 화면입니다.

## 분석 · 시책 제언

**분석 · 시책 제언**은 매장 데이터를 자연어로 질문하고, AI가 원인 분석과 함께 실행 가능한 시책을 제언하는 대화형 화면입니다.
화면 상단에는 **"제언형 L2 · 승인 후 실행"** 배지가 표시됩니다. 즉, AI는 시책을 제안만 하며 실제 실행은 담당자의 승인 후에 이루어집니다.

> [!NOTE]
>
> 이 페이지는 조직의 모든 구성원(최고 관리자 · 관리자 · 일반 사용자)이 열람할 수 있습니다.

## 분석 흐름

**1. Skill 선택**

분석에 사용할 원체크 Skill을 고릅니다. 기본값은 \*\*"매출방정식 분석"\*\*이며,
**＋스토어** 버튼으로 [Skill Store](/console/agent/skill-store)에서 새로운 Skill을 설치할 수 있습니다.

**2. AI 플랫폼(BYOK) 선택**

분석을 수행할 AI 플랫폼을 선택합니다. Claude / GPT / Gemini 중에서 고르며,
각 플랫폼에는 키 상태 배지(**키 연결됨 / 서버 키 / 키 없음**)가 표시됩니다.
키가 없으면 비활성화되며, [설정](/console/agent/llm-models)에서 키를 관리합니다.

**3. 질문 입력**

분석하고 싶은 내용을 자연어로 입력합니다. 파일은 **최대 5개**까지 첨부할 수 있으며,
텍스트 파일은 내용이 분석에 반영되고 그 외 파일은 파일명만 참고됩니다.

**4. 시책 등록**

답변을 바탕으로 시책을 등록합니다(아래 참조).

> [!NOTE]
>
> BYOK 키를 연결하지 않은 상태에서 받은 응답에는 **"샘플 응답"** 배지가 붙습니다.

## 답변 → 시책 등록

AI 답변에서 곧바로 두 가지 유형의 시책을 등록할 수 있습니다.

| 유형 | 대상 | 동작 |
| - | - | - |
| 🏢 B2B 점장 시책 | 매장 운영 개선 | 액션 에이전트에 등록 → 룰 확인 |
| 📱 B2C 고객앱 시책 | 페르소나별 개인화 | 고객 앱(SDK) 제공 → "스마트폰 제공"으로 등록 |

페르소나 예시: 10대 / 2030 여성 / 재방문 / 신규 등.

## 이벤트존에 시책 실행

> 콘솔 메뉴: **자연어 질의** → **시책 관리** → **공간 관리**

답변과 함께 우측에 표시되는 **제언 카드**에서 **\[시책관리에 추가하기]** 를 누르면 시책 관리 목록에 등록됩니다.
등록한 시책을 **실행(활성화)** 하면, 대상이 되는 **이벤트존이 함께 생성되어 [공간 관리](/console/areas)에 자동으로 매핑**됩니다.

**1. 질의 · 제언 확인**

콘솔 좌측 **자연어 질의** 메뉴에서 자연어로 질문하면 답변과 함께 우측에 제언 카드(대상·예상 효과)가 표시됩니다.

**2. 시책 관리에 추가**

**\[시책관리에 추가하기]** 를 누르면 좌측 **시책 관리** 메뉴의 목록에 등록됩니다. ([상세](/console/agent/action-agents))

**3. 실행 → 공간에 적용**

**시책 관리**에서 해당 항목을 실행(활성화)하면, 이벤트존이 생성되어 좌측 **공간 관리** 메뉴의 도면에 자동 매핑됩니다.
도면에서 직접 그리지 않아도 존이 만들어집니다.

> [!TIP]
>
> 이렇게 생성된 존은 SDK가 연동된 앱에서도 **몇 초 안에 감지**됩니다.

## 제언 → 실행 (우측 패널)

화면 우측의 **"제언 → 실행"** 패널에서 제언된 시책을 처리합니다.

> **승인하고 실행**
>
> 제언을 승인하면 시책이 실행 단계로 넘어갑니다.

> **수정**
>
> 제언 내용을 수정한 뒤 등록합니다.

시책 상태: **proposed(제안됨) / approved(승인됨) / dismissed(보류)**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.