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

# 프롬프트

> 재사용 가능한 프롬프트 템플릿 생성, 변수 치환, 팀 공유

프롬프트는 자주 사용하는 질문 형식이나 지시사항을 **템플릿으로 저장**하고, `/` 명령어로 빠르게 호출할 수 있는 기능입니다.
검증된 프롬프트를 팀과 공유하면 일관된 품질의 AI 응답을 얻을 수 있습니다.

```mermaid theme={null}
flowchart LR
    A["/ 명령어 입력"] --> B[프롬프트 선택]
    B --> C[변수 값 입력]
    C --> D[템플릿 확장]
    D --> E[AI 처리]
    E --> F[응답 생성]
```

***

## 프롬프트란?

일반 채팅에서는 원하는 결과를 얻으려면 매번 긴 지시사항을 처음부터 입력해야 합니다. 프롬프트는 이 지시사항을 한 번 템플릿으로 만들어 두고, `{{변수}}` 부분의 값만 바꿔 **반복 사용**하는 기능입니다. 잘 만든 프롬프트는 팀 전체가 공유해 **누구나 같은 품질**의 결과를 재현할 수 있습니다.

### 왜 프롬프트를 사용하나요?

| 장점        | 설명                   |
| --------- | -------------------- |
| **시간 절약** | 긴 지시사항을 매번 입력할 필요 없음 |
| **일관성**   | 동일한 형식의 결과물을 반복 생성   |
| **팀 협업**  | 효과적인 프롬프트를 팀원과 공유    |
| **품질 향상** | 검증된 프롬프트로 더 나은 응답 유도 |

***

## 프롬프트 목록

**워크스페이스 > 프롬프트**에서 모든 프롬프트를 확인합니다.

<Frame caption="워크스페이스 > 프롬프트에서 등록된 프롬프트 템플릿을 관리합니다">
  <img src="https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/prompts-list.png?fit=max&auto=format&n=NKTn2BIqecyNib8M&q=85&s=f338e8fe0f9e4c9f5bd681e70787ae97" alt="프롬프트 목록" width="2000" height="947" data-path="images/workspace/prompts-list.png" />
</Frame>

| 항목      | 설명             | 예시             |
| ------- | -------------- | -------------- |
| **제목**  | 프롬프트 이름        | "비즈니스 이메일 작성"  |
| **명령어** | 호출할 때 사용하는 단축키 | `/email-draft` |
| **작성자** | 프롬프트를 생성한 사용자  | "Admin 작성"     |

***

## 프롬프트 생성

<Steps>
  <Step title="새 프롬프트 만들기">
    **워크스페이스 > 프롬프트**에서 우측 상단의 **+ 새 프롬프트** 버튼을 클릭합니다.

    <Frame caption="제목, 명령어, 프롬프트 내용을 입력합니다">
      <img src="https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/prompts-create-top.png?fit=max&auto=format&n=NKTn2BIqecyNib8M&q=85&s=bdda64010044ac1a055a9a6093b27fc8" alt="프롬프트 생성 폼" width="1912" height="905" data-path="images/workspace/prompts-create-top.png" />
    </Frame>

    | 필드      | 설명              | 예시            |
    | ------- | --------------- | ------------- |
    | **제목**  | 프롬프트 표시 이름      | "비즈니스 이메일 작성" |
    | **명령어** | `/`로 시작하는 단축 명령 | `email-draft` |

    <Warning>
      명령어에는 **영문 소문자, 숫자, 하이픈(`-`)만** 사용할 수 있습니다. 한글, 공백, 특수문자는 허용되지 않습니다.
    </Warning>
  </Step>

  <Step title="프롬프트 내용 작성">
    프롬프트 템플릿을 작성합니다. Markdown 문법을 사용할 수 있습니다.

    ```markdown theme={null}
    다음 내용으로 전문적인 비즈니스 이메일을 작성해주세요.

    ## 작성 규칙
    - 공손하고 전문적인 톤
    - 명확하고 간결한 문장
    - 적절한 인사말과 맺음말 포함

    ## 이메일 내용
    {{content}}
    ```
  </Step>

  <Step title="변수 설정 (선택)">
    `{{변수명}}` 구문을 사용하여 동적 값을 입력받을 수 있습니다.
    프롬프트 사용 시 변수 위치에 실제 값이 대입됩니다.

    ```markdown theme={null}
    {{recipient}}님께 보내는 {{purpose}}에 관한 이메일을 작성해주세요.

    내용: {{content}}
    ```

    <Tip>
      변수명은 한글도 가능합니다. 예: `{{받는사람}}`, `{{주제}}`
    </Tip>

    #### 시스템 변수

    다음 내장 변수를 사용하면 자동으로 값이 채워집니다.

    | 변수                     | 설명        |
    | ---------------------- | --------- |
    | `{{CLIPBOARD}}`        | 클립보드 내용   |
    | `{{USER_NAME}}`        | 현재 사용자 이름 |
    | `{{USER_LANGUAGE}}`    | 사용자 언어 설정 |
    | `{{USER_LOCATION}}`    | 사용자 위치    |
    | `{{CURRENT_DATE}}`     | 오늘 날짜     |
    | `{{CURRENT_TIME}}`     | 현재 시간     |
    | `{{CURRENT_DATETIME}}` | 현재 날짜와 시간 |
    | `{{CURRENT_TIMEZONE}}` | 현재 시간대    |
    | `{{CURRENT_WEEKDAY}}`  | 현재 요일     |
  </Step>

  <Step title="접근 권한 설정">
    프롬프트를 공개할 범위를 선택합니다.

    | 옵션                | 설명                                                                     |
    | ----------------- | ---------------------------------------------------------------------- |
    | **공개 (Public)**   | 모든 사용자가 `/` 명령어로 사용 가능                                                 |
    | **비공개 (Private)** | 권한이 있는 사용자와 그룹만 접근 가능. 아래 **그룹**·**조직 단위**로 대상을 지정하며, 지정하지 않으면 생성자만 접근 |
    | **그룹**            | 관리자 패널에서 생성된 그룹 중 선택해 해당 구성원에게 접근 권한을 부여                               |
    | **조직 단위**         | 관리자 패널에서 생성된 조직 단위 중 선택해 해당 구성원에게 접근 권한을 부여                            |

    <Note>
      공개 옵션은 관리자 또는 프롬프트 공개 권한(`sharing.public_prompts`)이 부여된 사용자만 선택할 수 있습니다.
    </Note>
  </Step>

  <Step title="저장">
    **저장 및 생성** 버튼을 클릭합니다.
  </Step>
</Steps>

***

## 프롬프트 사용

### `/` 명령어로 호출

채팅창에 `/`를 입력하면 사용 가능한 프롬프트 목록이 자동완성으로 나타납니다. 목록에서 프롬프트를 선택하면 **템플릿 전체가 입력창에 펼쳐지고**, 커서가 `{{변수}}` 자리로 이동합니다.

1. 강조된 변수 자리에 값을 입력합니다.
2. **Tab** 키를 누르면 다음 변수로 이동합니다.
3. 모든 변수를 채운 뒤 메시지를 전송합니다.

<Frame caption="프롬프트를 선택하면 변수 자리가 있는 템플릿이 펼쳐집니다">
  <img src="https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/prompts-use-expand.png?fit=max&auto=format&n=NKTn2BIqecyNib8M&q=85&s=042eb8b817af5c10c4f611779ff1b5cf" alt="템플릿 전개 상태" width="879" height="535" data-path="images/workspace/prompts-use-expand.png" />
</Frame>

#### 명령어를 직접 입력해 바로 요청하기

자동완성 목록에서 선택하는 대신 `/email-draft`처럼 명령어를 끝까지 직접 입력하고 공백을 둔 뒤 요청 내용을 이어 쓰면, 템플릿을 펼치지 않고 이어 쓴 내용을 반영해 프롬프트를 바로 실행합니다. 변수를 하나씩 채우지 않고 한 문장으로 빠르게 요청할 때 유용합니다.

```
/email-draft 클라이언트에게 미팅 일정 조율 요청
```

<Frame caption="명령어를 직접 입력하면 이어 쓴 내용으로 바로 실행됩니다">
  <img src="https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/prompts-use-inline.png?fit=max&auto=format&n=NKTn2BIqecyNib8M&q=85&s=e90c3a29736b989c84eaa80a4b74f3d0" alt="명령어 직접 입력 실행" width="931" height="816" data-path="images/workspace/prompts-use-inline.png" />
</Frame>

***

## 프롬프트 예시

아래 예시는 기본 프롬프트를 선택했을 때 입력창에 펼쳐지는 템플릿입니다.

<Tabs>
  <Tab title="이메일 작성">
    **명령어:** `/email-draft`

    ```markdown theme={null}
    다음 조건에 맞는 비즈니스 이메일을 작성해주세요.

    - 수신자: {{수신자 (예: 고객사 담당자, 팀장님)}}
    - 목적: {{목적 (예: 미팅 요청, 프로젝트 진행 공유, 감사 인사)}}
    - 핵심 내용: {{전달할 내용}}
    - 톤: {{톤 (예: 격식체, 친근한 비즈니스)}}

    ---
    다음 형식으로 작성해주세요:
    - 제목 (Subject)
    - 본문 (인사 → 목적 → 상세 내용 → 요청/다음 단계 → 마무리)
    - 한국어 비즈니스 메일 관례를 따라주세요.
    ```
  </Tab>

  <Tab title="보고서 작성">
    **명령어:** `/report-summary`

    ```markdown theme={null}
    다음 보고서/문서를 경영진 보고용으로 요약해주세요.

    {{보고서 내용을 붙여넣거나 파일을 첨부하세요}}

    ---
    다음 형식으로 요약해주세요:
    1. 핵심 요약 (3줄 이내, 경영진이 30초 안에 파악 가능)
    2. 주요 수치/데이터 (테이블 형식)
    3. 시사점 및 제안 (2~3개)
    4. 리스크/주의사항 (있을 경우)
    ```
  </Tab>

  <Tab title="코드 리뷰">
    **명령어:** `/code-review`

    ```markdown theme={null}
    다음 코드를 리뷰해주세요.

    언어: {{언어 (예: Python, TypeScript, Java)}}
    목적: {{기능 설명}}

    {{코드를 붙여넣으세요}}

    다음 관점에서 리뷰해주세요:
    1. 버그/논리 오류 — 잠재적 문제
    2. 보안 — SQL Injection, XSS 등 취약점
    3. 성능 — 불필요한 연산, N+1 쿼리 등
    4. 가독성 — 네이밍, 구조, 주석
    5. 개선 제안 — 수정된 코드 예시 포함

    심각도를 ●(Critical) ◐(Warning) ○(Suggestion)로 표시해주세요.
    ```
  </Tab>

  <Tab title="회의록 정리">
    **명령어:** `/meeting-minutes`

    ```markdown theme={null}
    다음 회의 내용을 바탕으로 회의록을 작성해주세요.

    ## 회의 정보
    - 일시: {{날짜}}
    - 참석자: {{참석자}}
    - 안건: {{안건}}

    ## 회의 내용
    {{회의 내용을 입력하세요}}

    ---
    위 내용을 바탕으로 다음 형식의 회의록을 작성해주세요:
    1. 핵심 논의 사항 (3~5개 bullet)
    2. 결정 사항 (확정된 내용)
    3. Action Items (담당자, 마감일 포함 테이블)
    4. 다음 회의 안건 (있을 경우)
    ```
  </Tab>

  <Tab title="번역">
    **명령어:** `/translate`

    ```markdown theme={null}
    다음 텍스트를 번역해주세요.

    - 번역 방향: {{한국어→영어 / 영어→한국어}}
    - 문서 유형: {{기술 문서 / 비즈니스 이메일 / 마케팅 자료 / 계약서}}

    {{번역할 텍스트를 입력하세요}}

    ---
    번역 시 다음 원칙을 따라주세요:
    - 전문 용어는 업계 표준 번역을 사용
    - 문맥에 맞는 자연스러운 표현 사용
    - 원문의 톤과 격식 수준 유지
    - 애매한 표현은 [원문: xxx] 형태로 원문 병기
    ```
  </Tab>
</Tabs>

***

## 프롬프트 관리

### 편집 및 복제

* **편집**: 프롬프트 목록에서 **프롬프트 카드**를 클릭하여 편집 페이지로 이동합니다
* **복제**: 프롬프트 메뉴(⋮)에서 **복제**를 선택하여 새 버전을 만듭니다

<Note>
  쓰기 권한이 있거나 관리자인 경우 다른 사용자의 프롬프트도 편집할 수 있습니다. 권한이 없는 경우 **복제**하여 자신만의 버전을 만든 후 수정하세요.
</Note>

### 내보내기 / 가져오기

프롬프트를 JSON 파일로 내보내고 가져올 수 있습니다.

* 팀원과 프롬프트 공유
* 백업 및 복원
* 다른 환경으로 이동

<Note>
  일괄 내보내기/가져오기는 **관리자만** 사용할 수 있습니다. 개별 프롬프트 내보내기는 프롬프트 메뉴(⋮)에서 모든 사용자가 사용 가능합니다.
</Note>

### 삭제

더 이상 필요 없는 프롬프트는 삭제할 수 있습니다. 생성자, 쓰기 권한이 있는 사용자, 또는 관리자가 삭제할 수 있습니다.

***

## 효과적인 프롬프트 작성 팁

<Accordion title="1. 역할 정의">
  AI에게 명확한 역할을 부여하면 더 전문적인 답변을 얻을 수 있습니다.

  ```markdown theme={null}
  당신은 10년 경력의 마케팅 전문가입니다.
  ```
</Accordion>

<Accordion title="2. 구체적인 지시">
  원하는 결과물을 구체적으로 설명하세요. 분량, 톤, 포함할 내용을 명시합니다.

  ```markdown theme={null}
  ## 요구사항
  - 500자 내외로 작성
  - 전문적이지만 친근한 톤
  - 3개의 핵심 메시지 포함
  ```
</Accordion>

<Accordion title="3. 출력 형식 지정">
  원하는 형식(표, 목록, 마크다운 등)을 명시하면 일관된 결과를 얻을 수 있습니다.

  ```markdown theme={null}
  ## 출력 형식
  | 항목 | 내용 |
  |------|------|
  | 제목 | ... |
  | 본문 | ... |
  ```
</Accordion>

<Accordion title="4. 예시 제공">
  원하는 결과의 예시를 보여주면 AI가 형식과 스타일을 정확히 파악합니다.

  ```markdown theme={null}
  ## 예시
  입력: "프로젝트 미팅"
  출력: "프로젝트 A 2차 진행 현황 공유 미팅"
  ```
</Accordion>

<Accordion title="5. 제약 조건 명시">
  피해야 할 것을 알려주면 원치 않는 결과를 방지할 수 있습니다.

  ```markdown theme={null}
  ## 제한사항
  - 전문 용어 최소화
  - 비속어 사용 금지
  - 개인정보 포함 금지
  ```
</Accordion>

***

## 팀 프롬프트 공유

### 접근 권한

프롬프트 생성 시 접근 권한을 설정하여 공유 범위를 지정합니다.

| 옵션                | 설명                                                               |
| ----------------- | ---------------------------------------------------------------- |
| **공개 (Public)**   | 모든 사용자가 `/` 명령어로 사용 가능                                           |
| **비공개 (Private)** | 권한이 있는 사용자와 그룹만 접근 가능. **그룹**·**조직 단위**로 대상을 지정하며, 미지정 시 생성자만 접근 |
| **그룹**            | 관리자 패널에서 생성된 그룹 중 선택해 해당 구성원에게 접근 권한을 부여                         |
| **조직 단위**         | 관리자 패널에서 생성된 조직 단위 중 선택해 해당 구성원에게 접근 권한을 부여                      |

***

## FAQ

<AccordionGroup>
  <Accordion title="프롬프트 명령어에 한글을 사용할 수 있나요?" icon="circle-question">
    아니요. 명령어에는 **영문 소문자, 숫자, 하이픈(`-`)만** 사용할 수 있습니다. 예: `/email-draft`, `/code-review`, `/meeting-minutes`
  </Accordion>

  <Accordion title="프롬프트에 파일을 포함할 수 있나요?" icon="circle-question">
    프롬프트 템플릿 자체에는 파일을 포함할 수 없지만, 프롬프트 사용 시 파일을 함께 첨부할 수 있습니다.
  </Accordion>

  <Accordion title="다른 사람의 프롬프트를 수정할 수 있나요?" icon="circle-question">
    쓰기 권한이 부여된 경우 또는 관리자만 수정할 수 있습니다. 권한이 없으면 **복제**하여 자신만의 버전을 만든 후 수정하세요.
  </Accordion>

  <Accordion title="변수에 긴 텍스트를 넣을 수 있나요?" icon="circle-question">
    네, 변수에 입력할 수 있는 텍스트 길이에 제한은 없습니다. 문서 전체 내용도 변수로 전달할 수 있습니다.
  </Accordion>
</AccordionGroup>

***

## 다음 단계

<Columns cols={2}>
  <Card title="에이전트에 프롬프트 활용" icon="robot" href="/ko/workspace/agents">
    에이전트의 시스템 프롬프트에 검증된 지시사항을 적용합니다
  </Card>

  <Card title="채팅 고급 기능" icon="comments" href="/ko/chat/capabilities">
    웹검색, 파일 첨부 등 채팅 고급 기능을 활용합니다
  </Card>
</Columns>