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

# 지식 베이스

> FAQ, 정책, 제품 자료 등 문서를 한 번 업로드하면 에이전트가 통화 중에 검색할 수 있습니다.

**지식** 페이지(`/dashboard/knowledge`)는 조직의 문서 저장소입니다. 파일을 한 번 업로드한 다음 각 에이전트가 검색할 정확한 문서를 선택합니다. 통화 중 에이전트는 추측하는 대신 연결된 문서에서 답변을 찾습니다.

## 지원 파일 및 제한

| 유형   | 확장자                   | 크기 제한          |
| ---- | --------------------- | -------------- |
| 텍스트  | `.txt`, `.md`, `.csv` | 파일당 1MB(UTF-8) |
| 바이너리 | `.pdf`, `.docx`       | 파일당 15MB       |

## 문서 업로드

**파일 업로드**를 클릭하거나 페이지 어디에나 파일을 끌어다 놓으세요. 여러 파일을 한 번에 놓을 수 있습니다. 각 문서는 업로드 후 검색용으로 처리되며, 상태 배지에서 진행 상황을 확인할 수 있습니다. 처리에 실패한 항목에는 **재시도** 작업이 표시되고, 여러 항목이 실패한 경우 **모두 재시도** 배너가 표시됩니다.

파일 콘텐츠가 이미 조직에 있는 문서와 동일한 경우에도 업로드되지만, 정리할 수 있도록 중복 경고가 표시됩니다.

<Note>
  문서 추가, 편집, 교체 및 삭제에는 **관리자** 또는 **소유자** 역할이 필요합니다. 모든 구성원은 문서를 찾아보고 검색할 수 있습니다.
</Note>

## Google Drive에서 가져오기

**Google Drive에서 가져오기**를 클릭하면 Google 파일 선택기가 열립니다. 동일한 크기 제한 내에서 Google Docs(자동으로 텍스트로 변환됨) 및 지원되는 모든 파일 형식을 가져올 수 있습니다. 지원되지 않는 파일은 파일별 설명과 함께 건너뜁니다. 버튼이 비활성화되어 있고 "Google Drive 가져오기가 구성되지 않았습니다"라고 표시되면 해당 환경에서 Drive 가져오기가 활성화되지 않은 것입니다. 일반 업로드는 관계없이 사용할 수 있습니다.

## 문서 찾기 및 관리

* **검색** — 검색창은 문서 이름과 내용을 모두 검색합니다.
* **문서 열기** — 행을 클릭하여 추출된 내용을 확인하고, 원본 파일을 다운로드하거나, 새 업로드로 **교체**(자동으로 다시 처리됨)하거나, 처리를 재시도하거나, 삭제할 수 있습니다.
* **일괄 작업** — 여러 행을 선택하여 함께 재시도하거나 삭제할 수 있습니다.

<Warning>
  문서를 삭제하면 해당 문서를 사용하는 모든 에이전트에서 제거됩니다.
</Warning>

## 에이전트에 액세스 권한 부여

문서는 에이전트에 자동으로 적용되지 않습니다. 에이전트 빌더의 지식 섹션([에이전트 만들기](/ko/guides/build-an-agent))에서 해당 에이전트가 검색할 정확한 문서를 선택하세요. 에이전트별 범위를 지정하면 지원 에이전트가 영업 플레이북에 접근하지 못하게 하고, 그 반대의 경우도 방지할 수 있습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="에이전트 만들기" icon="robot" href="/ko/guides/build-an-agent">
    빌더의 지식 섹션에서 문서를 연결하세요.
  </Card>

  <Card title="통화 시뮬레이션" icon="flask" href="/ko/guides/test-agents">
    배포하기 전에 에이전트가 실제로 지식을 사용하는지 확인하세요.
  </Card>
</CardGroup>