# 첨부와 이미지

> 메시지에 이미지·파일을 붙입니다 — 에이전트가 실제로 무엇을 읽는지, 그리고 그것을 고른 모델이 정하는 이유.

메시지에 이미지와 파일을 붙일 수 있습니다. 에이전트는 그것을 [실행](/ko/docs/work/runs/)의 일부로, 사용자의 텍스트를 읽듯이 읽습니다.

## 붙이기

<Steps>

1. **컴포저에서 파일을 추가하거나 붙여넣습니다.** 클립보드의 스크린샷도, 복사한 텍스트 덩어리도 모두 첨부로 들어갑니다.

2. **미리보기를 확인합니다.** 이미지는 썸네일로, 텍스트류 파일은 앞부분 몇 줄이 보입니다. 그 밖의 파일은 이름 칩으로 나오는데, 잘못된 파일을 보내기 전에 알아채기에는 충분합니다.

3. **함께 보낼 메시지를 씁니다.** 스크린샷에 *"여기 뭐가 잘못됐지?"* 를 붙이면 완결된 요청입니다. 파일만 보내는 것은 아닙니다.

</Steps>

붙여넣은 텍스트는 컴포저에 쏟아지지 않고 첨부로 들어갑니다. 긴 붙여넣기가 정작 쓴 문장을 묻어버리지 않게 하기 위해서입니다.

## 에이전트가 보는 것

첨부는 요청이 나가기 직전에 모델용으로 준비되고, 무엇이 되는지는 파일에 따라 다릅니다.

- **이미지**는 모델이 받아들이면 이미지 그대로 전달됩니다.
- **텍스트류 파일** — 일반 텍스트, Markdown, CSV, JSON, YAML, 소스 코드 — 은 텍스트로 읽힙니다.
- **그 밖의 파일**은 이름과 형식으로 식별됩니다. 그 형식을 열 수 없는 모델에게는 파일이 생략됐다는 사실과 이유가 전달됩니다.

<Aside type="caution" title="첨부의 값어치는 모델이 정합니다">
  모든 모델이 이미지를 읽지는 않습니다. 텍스트 전용 모델이 선택된 상태에서 스크린샷을 붙이면
  업로드는 성공하고 에이전트도 답합니다 — 다만 이미지를 보지 못한 채 답하고, 그렇다고 말합니다.
  에이전트가 그림을 무시하는 것 같으면 [모델](/ko/docs/build/models/)부터 확인하세요.
</Aside>

## 대화 안에서

첨부는 그것을 실어 보낸 메시지에 남습니다. 거슬러 올라가면 무엇을 언제 보냈는지 보입니다. [컨텍스트 창](/ko/docs/work/context-window/) 패널의 리소스 목록에도 나타나고, 거기서 고르면 해당 메시지로 이동합니다.

## 한계

- 파일당 50MB 까지.
- 모델이 무엇을 쓸 수 있는지는 모델에 달렸습니다 — 위 주의를 보세요.
- SVG 파일은 저장·전달되지만 대화 안에서 그림으로 그려지지는 않습니다.
- 첨부는 함께 보낸 메시지에 속합니다. 대화별 파일 관리자는 따로 없습니다. 오래 둘 산출물의 자리는 [아티팩트](/ko/docs/capabilities/artifacts/)입니다.
- 에이전트는 사용자가 보낸 첨부를 읽습니다. [데스크톱 앱의 로컬 런타임](/ko/docs/get-started/surfaces/)에서 돌리지 않는 한 사용자 컴퓨터의 파일에는 닿지 못합니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="컨텍스트 창"
    href="/ko/docs/work/context-window/"
    description="첨부가 얼마를 차지하는지, 어디서 보는지."
  />
  <LinkCard
    title="모델 고르기"
    href="/ko/docs/build/models/"
    description="어떤 모델이 이미지를 읽는지, 그것이 어디에 표시되는지."
  />
  <LinkCard
    title="아티팩트"
    href="/ko/docs/capabilities/artifacts/"
    description="에이전트가 만든 파일이 남는 곳."
  />
</CardGrid>