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

# 지식 문서 (Knowledge)

> 모든 페이지가 참고하는 브랜드 문서(Brand.md)와 콘텐츠 가이드라인(Content.md), 그리고 이미지 라이브러리를 관리합니다

Knowledge는 워크스페이스가 만드는 모든 페이지의 원천입니다. 무엇이 사실인지는 **Brand.md**(브랜드 문서)가, 그것을 어떻게 써야 하는지는 **Content.md**(콘텐츠 가이드라인)가 정합니다. 생성된 글에서 잘못된 사실이나 쓰면 안 되는 표현을 발견했을 때 여는 화면입니다.

<Frame>
  <img src="https://mintcdn.com/opactor/-HUSJ-w8V9mhcbD_/images/knowledge/knowledge-brand.png?fit=max&auto=format&n=-HUSJ-w8V9mhcbD_&q=85&s=8c3f97a9fbd1e8dcf3c96eb92565caf1" alt="Knowledge 화면의 Brand 탭" width="1600" height="1000" data-path="images/knowledge/knowledge-brand.png" />
</Frame>

1. **Edit with AI**(AI로 편집) — 두 문서를 AI와 함께 고치는 전체 화면 편집기를 엽니다.
2. 탭 전환 — **Brand**, **Content**, **Asset** 사이를 이동합니다. 쇼핑몰 워크스페이스라면 **Catalog**(제품 목록) 탭이 하나 더 붙습니다.
3. 파일 칩과 설명 — 지금 보고 있는 문서가 **Brand.md**인지 **Content.md**인지, 그리고 그 문서가 무엇을 담당하는지 알려 줍니다.
4. 저장 상태와 **Version \[n]**(버전) — 왼쪽에 **Auto-saved to version \[n]** 같은 저장 상태가 뜨고, 오른쪽 **Version \[n]** 버튼은 **History**(변경 이력) 열을 열고 닫습니다.
5. **Publish version**(버전 게시) — 지금 문서를 번호가 붙은 저장된 버전으로 남깁니다.

## 두 문서 모델

Anymorph의 글쓰기 규칙은 문서 두 개로 나뉩니다. 이 구분만 이해하면 나머지는 쉽습니다.

**Brand.md는 사실입니다.** 페이지는 여기 적힌 사실만 가져다 씁니다. 여기 없는 내용은 지어내지 않습니다. 화면의 설명도 같은 말을 합니다. "The brand and product knowledge every page is grounded in."

여기에 들어가는 것: 브랜드 정체성과 포지셔닝, 카테고리, 핵심 고객, 우리가 약속하는 것, 제품이 하지 **못하는** 범위, 근거가 되는 수치와 사례, 승인된 표현, 실제 제품 사양과 요금제.

**Content.md는 쓰는 방식입니다.** 초안이 지켜야 하는 편집 규칙이 여기 모입니다. "The content guidelines that keep every draft consistently good."

여기에 들어가는 것: 글의 목표, 필수 구조(답부터 제시하고, 기준, 근거, 한계, 다음 단계 순), 제목 표기 방식, 전문 용어를 처음 쓸 때 정의하기, 최상급 표현 대신 확인 가능한 사실 쓰기, 지표나 고객사를 임의로 만들지 않기. 여기에 사내에서 금지한 표현과 매번 반복하고 싶은 형식을 더하세요.

| 초안에서 발견한 것                          | 고칠 문서          |
| ----------------------------------- | -------------- |
| 서술된 사실이 틀림                          | **Brand.md**   |
| 꼭 들어가야 할 정보가 빠짐                     | **Brand.md**   |
| 우리가 쓰지 않는 표현이나 주장                   | **Content.md** |
| 매번 반복하고 싶은 형식(CTA 문구, 통화 표기, 제목 형태) | **Content.md** |

<Note>
  Content.md는 온사이트 글쓰기와 오프사이트 검수에는 적용되지만, 오프사이트 글쓰기 자체에는 적용되지 않습니다. 오프사이트 원고는 다른 사이트의 편집 규칙을 따르기 때문에 **Brand.md**만 읽습니다.
</Note>

## 이 문서는 어디서 왔나요

두 문서는 워크스페이스를 만들 때 자동으로 조사되어 채워집니다. 빈 문서에서 시작하지 않습니다.

* **Brand.md**는 고객사 자신의 웹사이트를 읽어서 작성됩니다. 사이트 구조를 훑고 가격, 제품, 기능, 회사 소개처럼 정보가 있는 페이지를 최대 8개까지 읽습니다. 첫 버전의 변경 메모는 "Initial Brand.md researched from the brand's own site"로 남습니다.
* **Content.md**는 고객사 사이트가 아니라 해당 분야에서 가장 잘 쓰는 에디토리얼 블로그들을 읽어서 작성됩니다. 자사 사이트에는 문체 규칙이 드러나 있지 않은 경우가 대부분이기 때문입니다. 첫 버전 메모는 "Initial Content.md researched from the field's best editorial blogs"입니다.

여러분이 할 일은 백지에서 쓰는 것이 아니라, 이 초안을 고치고 보태는 것입니다.

## 저장과 버전

이 화면에는 저장 버튼이 없습니다. 오른쪽 위 상태 표시가 저장 상태를 알려 줍니다.

| 표시                             | 의미                                                     |
| ------------------------------ | ------------------------------------------------------ |
| **Auto-saved to version \[n]** | 입력한 내용이 현재 문서에 저장되었습니다. 타이핑을 멈추고 약 1.5초 뒤에 저장됩니다.      |
| **Saving…**                    | 저장 중입니다.                                               |
| **Unsaved changes**            | 저장이 실패했습니다. 대부분 네트워크 문제입니다. 탭을 열어 둔 채로 다시 입력하면 재시도합니다. |

<Warning>
  가장 많이 오해하는 부분입니다. **자동 저장된 수정은 이미 반영됩니다.** 글을 쓰는 쪽은 현재 문서의 최신 내용을 읽기 때문에, 사실을 고치고 \*\*Auto-saved to version \[n]\*\*이 뜬 순간부터 다음 생성분에 그 수정이 적용됩니다. **Publish version**은 "켜는" 버튼이 아닙니다.
</Warning>

**Publish version**은 지금 내용을 번호가 붙은 버전으로 굳혀 두는 이정표입니다. 생성된 페이지는 어떤 버전을 보고 쓰였는지 그 번호를 근거로 남기고, 나중에 이 버전으로 되돌릴 수 있습니다. 수정이 한 덩어리로 정리되었을 때 누르세요. 문서 아래 **Change summary**(변경 메모, "Optional note about this version")에 한 줄을 적어 두면 이력에서 알아보기 쉽습니다. 성공하면 **Published version \[n]** 토스트가 뜹니다.

**Publish version**은 게시할 변경이 없을 때, 게시가 진행 중일 때, 과거 버전을 보고 있을 때 비활성화됩니다. 팀원이 동시에 게시하면 나중 요청이 거부되므로, 새로고침한 뒤 다시 적용하세요. 빈 문서는 게시되지 않습니다.

## 변경 이력과 되돌리기

<Frame>
  <img src="https://mintcdn.com/opactor/-HUSJ-w8V9mhcbD_/images/knowledge/knowledge-history.png?fit=max&auto=format&n=-HUSJ-w8V9mhcbD_&q=85&s=d951a619be116bf5937b099381f058c0" alt="Knowledge 화면 오른쪽의 History 열" width="1600" height="1000" data-path="images/knowledge/knowledge-history.png" />
</Frame>

**Version \[n]** 버튼을 누르면 오른쪽에 **History** 열이 열립니다. 최신 버전이 위에 오고, 각 줄에 버전 번호, 현재 불러온 버전을 뜻하는 **CURRENT** 칩, 상대 시간, 변경 메모가 표시됩니다. 메모가 없으면 그 버전이 만들어진 방식(자동 조사된 첫 버전은 `extraction`, 사람이 게시한 버전은 `manual`, 되돌린 버전은 `restore`)이 대신 보입니다.

줄을 클릭하면 그 버전의 내용이 문서 자리에 읽기 전용으로 표시됩니다. **Restore**(복원)를 누르면 그 내용이 새 버전으로 다시 올라옵니다. 번호가 뒤로 가지 않으므로 이력은 사라지지 않습니다. 열을 닫으면 현재 문서로 돌아옵니다.

## Content 탭과 Voice pack

<Frame>
  <img src="https://mintcdn.com/opactor/-HUSJ-w8V9mhcbD_/images/knowledge/knowledge-content.png?fit=max&auto=format&n=-HUSJ-w8V9mhcbD_&q=85&s=9b8aca6b46d32aed3854231662deafcb" alt="Voice pack 카드가 있는 Content 탭" width="1600" height="1000" data-path="images/knowledge/knowledge-content.png" />
</Frame>

Content 탭에는 문서 위에 **Voice pack** 카드가 하나 더 있습니다. Anymorph가 관리하는 문체 프리셋 목록이며 첫 항목은 **None**(사용 안 함)입니다. 선택은 필수가 아니고, 지금은 골라 두어도 페이지가 쓰이는 방식이 바뀌지 않으므로 그대로 두셔도 됩니다.

## Asset 탭

<Frame>
  <img src="https://mintcdn.com/opactor/-HUSJ-w8V9mhcbD_/images/knowledge/knowledge-asset.png?fit=max&auto=format&n=-HUSJ-w8V9mhcbD_&q=85&s=3e2cf52065203f30fdee8c8202909bc2" alt="Knowledge 화면의 Asset 탭" width="1600" height="1000" data-path="images/knowledge/knowledge-asset.png" />
</Frame>

페이지 편집기와 에이전트에서 이미지를 넣어 달라고 할 때 찾아보는 이미지 라이브러리입니다. 자동 생성되는 페이지의 대표 이미지는 별도로 만들어지므로, 초안이 나오기 전에 이 라이브러리를 채워 둘 필요는 없습니다.

* **Upload**(업로드): 파일을 고르거나 패널 위로 끌어다 놓습니다.
* **Sync**(사이트에서 수집): 사이트를 읽어서 아직 없는 이미지를 가져옵니다. 주소 칸은 기본으로 워크스페이스 도메인이 채워져 있습니다. **Replace synced images**를 켜면 사이트에서 수집한 이미지를 전부 지우고 새로 모읍니다. 직접 업로드한 이미지는 유지됩니다. 수집은 백그라운드에서 계속되며 버튼은 **Syncing**으로 바뀝니다.
* 필터: **Source**(Upload / Crawl)와 **Type**(logo, icon, people, product, scene, graphic, background, card, ui).
* **Select**(선택): 여러 장을 골라 \*\*Delete (\[n])\*\*로 한 번에 지웁니다.

새로 들어온 이미지는 자동으로 종류가 분류되고 설명이 붙습니다. 분류가 끝나기 전에는 **Type**을 바꿀 수 없고, 끝난 뒤에는 언제든 카드의 **Type** 드롭다운에서 고칠 수 있습니다. 카드를 클릭하면 파일명, 종류, 출처, 설명, 상태를 담은 상세 패널이 열립니다. 로고와 아이콘으로 분류된 이미지는 본문 삽입 후보에서 제외됩니다.

## Edit with AI

<Frame>
  <img src="https://mintcdn.com/opactor/-HUSJ-w8V9mhcbD_/images/knowledge/knowledge-ai-editor.png?fit=max&auto=format&n=-HUSJ-w8V9mhcbD_&q=85&s=b979b1a69c0919fd5eb13757fa44aeca" alt="Edit with AI 전체 화면 편집기" width="1600" height="1000" data-path="images/knowledge/knowledge-ai-editor.png" />
</Frame>

**Edit with AI**를 누르면 전체 화면 편집기가 열립니다. 가운데에 **Brand.md**와 **Content.md**가 탭으로 함께 있고, 오른쪽에 AI 패널이 있습니다.

원하는 수정을 문장으로 요청하세요. 예를 들어 "환불 정책을 브랜드 사실에 추가해 줘"처럼 적으면 됩니다. **Attach source files**(소스 파일 첨부)로 자료를 붙일 수도 있습니다. AI는 **Proposed changes**(제안된 변경) 블록에 파일별 변경 내용을 보여 주고, **Open**으로 해당 위치로 이동할 수 있습니다. **Apply**(적용)를 누르면 편집기 안 문서에 반영되고 변경 메모가 자동으로 채워집니다. 마음에 들지 않으면 **Discard**(버리기)를 누르세요.

적용된 내용도 다른 수정과 똑같이 자동 저장됩니다. 정리가 끝나면 **Publish version**을 누르세요. **New chat**으로 새 대화를 시작하고, **Chat history**로 이전 대화를 다시 엽니다.

## 이렇게 사용하세요

<Steps>
  <Step title="틀린 사실 고치기">
    **Brand** 탭에서 해당 문장을 직접 고칩니다. 상태 표시가 \*\*Auto-saved to version \[n]\*\*으로 바뀌면 다음 생성분부터 반영됩니다.
  </Step>

  <Step title="편집 규칙 추가하기">
    **Content** 탭에 규칙을 한 줄로 적습니다. 금지 표현, CTA 문구, 통화 표기처럼 매번 반복되어야 하는 것들입니다.
  </Step>

  <Step title="버전으로 남기기">
    **Change summary**에 무엇을 왜 고쳤는지 한 줄 적고 **Publish version**을 누릅니다.
  </Step>

  <Step title="필요하면 되돌리기">
    **Version \[n]** → **History**에서 예전 버전을 눌러 내용을 확인하고 **Restore**를 누릅니다.
  </Step>
</Steps>

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="저장하려면 뭘 눌러야 하나요?">
    아무것도 누르지 않아도 됩니다. 타이핑을 멈추고 약 1.5초 뒤에 자동으로 저장되며, 상태 표시가 \*\*Auto-saved to version \[n]\*\*으로 바뀝니다.
  </Accordion>

  <Accordion title="그럼 Publish version은 왜 누르나요?">
    수정이 적용되게 하려고 누르는 것이 아닙니다. 글을 쓰는 쪽은 현재 문서를 읽기 때문에 자동 저장 시점부터 이미 적용됩니다. **Publish version**은 번호가 붙은 저장된 버전을 만들어 두는 것입니다. 생성된 페이지가 근거로 인용하는 번호이고, 나중에 되돌릴 수 있는 지점입니다.
  </Accordion>

  <Accordion title="문서를 고치면 이미 만들어진 페이지도 바뀌나요?">
    아니요. Knowledge 수정은 다음 생성분부터 적용됩니다. 기존 페이지는 각자 쓰일 때 참고한 버전에 고정되어 있습니다.
  </Accordion>

  <Accordion title="제가 쓴 적 없는데 문서에 내용이 이미 있어요.">
    워크스페이스를 만들 때 자동으로 조사되어 채워집니다. Brand.md는 여러분의 웹사이트를, Content.md는 같은 분야의 잘 쓴 에디토리얼 블로그를 읽고 작성됩니다.
  </Accordion>

  <Accordion title="PDF나 자료를 그대로 넣을 수 있나요?">
    **Edit with AI** 편집기의 **Attach source files**로 첨부하세요. pdf, docx, pptx, xls, xlsx, epub, 이미지, txt, md, csv 등을 파일당 최대 25MB까지 받습니다. AI가 내용을 읽어 수정안을 제안하며, 첨부한 파일 자체가 문서로 남지는 않습니다.
  </Accordion>

  <Accordion title="팀에서 누가 수정할 수 있나요?">
    워크스페이스에 들어올 수 있는 사람은 모두 수정, 게시, 복원을 할 수 있습니다. 승인 단계는 없습니다. 자동 저장만으로 다음 생성분에 반영되므로, 이 두 문서의 담당자를 팀 내부에서 정해 두시길 권합니다.
  </Accordion>

  <Accordion title="이미지는 어떻게 채우나요?">
    **Asset** 탭에서 **Upload**로 직접 올리거나 **Sync**로 사이트에서 수집합니다. 각 이미지는 자동으로 종류가 분류되고 설명이 붙어, 편집기에서 이미지를 요청할 때 상황에 맞는 것을 찾기 쉬워집니다. 종류가 잘못되었으면 카드의 **Type**에서 고치세요.
  </Accordion>

  <Accordion title="문서가 비어 있고 계속 준비 중이라고 나옵니다.">
    새로 만든 워크스페이스는 자동 조사가 끝나기 전에도 화면을 열 수 있습니다. 1분쯤 뒤에 새로고침하세요.
  </Accordion>
</AccordionGroup>

## 함께 보면 좋은 페이지

<CardGroup cols={2}>
  <Card title="수정이 계속 적용되게 만들기" href="/ko/guides/knowledge-feedback-loop">
    초안에서 찾은 문제를 두 문서 중 어디에 옮겨 적을지 정하는 방법입니다.
  </Card>

  <Card title="콘텐츠 리뷰하기" href="/ko/guides/reviewing-content">
    초안에서 무엇을 집중해서 봐야 하는지 정리했습니다.
  </Card>

  <Card title="온사이트" href="/ko/dashboard/on-site">
    두 문서를 읽어 자사 사이트용 페이지를 만드는 화면입니다.
  </Card>

  <Card title="오프사이트" href="/ko/dashboard/off-site">
    Brand.md만 읽는 외부 매체용 원고입니다.
  </Card>
</CardGroup>