> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 이미지 및 PDF 지원

> AI로 이미지와 PDF 첨부 파일을 요약하고, 텍스트를 추출하고, 질문할 수 있습니다.

Craft의 AI 어시스턴트는 문서 내의 **이미지와 PDF**를 직접 이해하고, 요약하고, 설명하는 데 도움을 줍니다. 지원되는 콘텐츠 위에 마우스를 올리면 즉시 상호작용할 수 있는 빠른 실행 버튼이 나타납니다.

<Check title="v3.3.5 신기능">
  이미지 및 PDF OCR 지원이 버전 3.3.5에 추가되어 텍스트 추출, 캡션 생성, 접근성을 위한 대체 텍스트 생성이 간편해졌습니다.
</Check>

## PDF 지원

AI 어시스턴트는 **Max** 모델을 사용하여 문서에 첨부된 PDF 파일을 읽고 해석할 수 있습니다.

**PDF로 할 수 있는 작업:**

* 전체 문서의 요약 생성
* 콘텐츠에 대한 질문
* 핵심 포인트 또는 인사이트 추출
* 특정 정보 가져오기

다음과 같은 경우에 특히 유용합니다:

* 연구 논문 및 기사
* 보고서 및 백서
* 문서 및 매뉴얼
* 회의록 및 프레젠테이션

## 이미지 지원

AI 어시스턴트는 이미지와 특히 잘 작동하며, 시각적 콘텐츠에 대해 빠른 결과를 제공합니다.

### 지원되는 이미지 형식

* PNG
* JPG
* JPEG
* GIF
* WEBP

<Warning title="HEIC 미지원">
  HEIC 이미지는 현재 지원되지 않습니다. 어시스턴트와 함께 사용하기 전에 HEIC 파일을 JPG 또는 PNG로 변환하세요.
</Warning>

### 이미지로 할 수 있는 작업

* **캡션 생성** – 이미지에 대한 설명 캡션 만들기
* **요약 받기** – 이미지가 보여주는 내용 파악
* **상세 설명 만들기** – 자세한 해석 생성
* **접근성 향상** – 스크린 리더용 대체 텍스트 생성
* **텍스트 추출** – 스크린샷이나 문서 사진에서 텍스트 가져오기

**활용 사례:**

* 문서 및 가이드
* 회의 화이트보드 및 다이어그램
* UI 또는 디자인 스크린샷
* 차트 및 그래프
* 접근성 준수 (대체 텍스트 생성)

## OCR 기능 사용하기

<Steps>
  <Step>
    문서에 이미지 또는 PDF를 추가합니다.
  </Step>

  <Step>
    이미지 또는 PDF 블록 위에 마우스를 올립니다.
  </Step>

  <Step>
    나타나는 어시스턴트 빠른 실행 버튼을 클릭합니다.
  </Step>

  <Step>
    원하는 작업을 선택합니다: 캡션 생성, 요약, 텍스트 추출 또는 맞춤 질문.
  </Step>
</Steps>

어시스턴트가 콘텐츠를 처리하고 즉시 결과를 제공합니다.

## 코드 블록

이미지와 PDF 외에도 AI 어시스턴트는 **코드 블록**에서도 도움을 줄 수 있습니다:

* 코드의 동작 설명
* 디버깅 지원
* 로직 또는 구조 설명
* 개선 사항 제안

이를 통해 Craft는 기술 문서 및 개발 노트를 위한 강력한 도구가 됩니다.

## 최상의 결과를 위한 팁

**이미지의 경우:**

* 가능하면 선명하고 고해상도의 이미지를 사용
* 이미지 내 텍스트가 읽기 쉬운지 확인
* 더 정확한 결과를 위해 불필요한 부분을 잘라내기

**PDF의 경우:**

* **Max** 모델을 사용 중인지 확인 (다른 모델은 파일 첨부를 지원하지 않음)
* 작은 PDF일수록 처리가 빠름
* 텍스트가 깔끔하고 잘 포맷된 PDF가 가장 잘 작동
* 매우 큰 PDF는 섹션으로 나누는 것을 고려

**코드의 경우:**

* 코드가 수행해야 할 작업에 대한 맥락 포함
* 프로그래밍 언어가 명확하지 않은 경우 지정
* 더 나은 답변을 위해 구체적인 질문하기

## 관련 문서

<CardGroup cols={2}>
  <Card title="Craft Assistant 사용하기" href="/ko/ai-assistant/using">
    어시스턴트 사용의 기본을 배우기
  </Card>

  <Card title="맞춤 프롬프트" href="/ko/ai-assistant/custom-prompts">
    일관된 이미지 설명을 위한 재사용 가능한 프롬프트 만들기
  </Card>

  <Card title="AI 모델 선택" href="/ko/ai-assistant/models">
    이미지와 PDF 처리에 적합한 모델 선택
  </Card>

  <Card title="문서의 미디어" href="/ko/write-and-edit/media">
    이미지 및 파일 추가와 관리 방법 알아보기
  </Card>

  <Card title="코드 블록" href="/ko/write-and-edit/code">
    코드 분석 및 디버깅에 AI 도움 받기
  </Card>
</CardGroup>