# 컨텍스트 창

> 모델마다 담을 수 있는 양이 정해져 있습니다. 표시기는 이 대화가 얼마를 쓰고 있는지, 패널은 무엇이 그 자리를 차지하는지 보여줍니다.

모델은 요청 하나당 정해진 분량만 읽습니다 — 그것이 **컨텍스트 창**입니다. 에이전트에게 필요한 것이 전부 그 안에 들어가야 합니다. 지침, 기억, 부를 수 있는 도구, 대화, 그리고 첨부까지요.

컴포저는 그 창이 얼마나 찼는지 보여주고, 컨텍스트 패널은 무엇이 채우고 있는지 보여줍니다.

## 왜 중요한가

창이 차면 두 가지가 나빠집니다.

- **오래된 메시지가 잘려 나갑니다.** 긴 실의 앞부분이 에이전트에게 보이지 않게 됩니다.
- **매 스텝이 비싸집니다.** [실행](/ko/docs/work/runs/)의 단계마다 컨텍스트 전체가 다시 전송되므로, 무거운 대화는 느리고 비싼 대화입니다.

"처음에 한 얘기를 잊어버린" 에이전트는 기억이 고장 난 게 아니라 거의 항상 창이 가득 찬 것입니다.

## 무엇이 자리를 차지하는가

패널은 창을 구간으로 나눠 보여줍니다.

| 구간 | 내용 |
| --- | --- |
| **시스템 지침** | Endue 가 모든 실행에 두르는 틀 |
| **정체성** | 에이전트의 이름·성격·프로필 |
| **에이전트 지침** | 현재 리비전의 [시스템 프롬프트](/ko/docs/build/system-prompt/) |
| **지침 스킬** | 커맨드가 아니라 상시 지침으로 실리는 스킬 |
| **기억** | 이 대화에 관련된 [메모리](/ko/docs/capabilities/memory/) |
| **도구 정의** | 에이전트가 부를 수 있는 모든 도구의 스키마 |
| **대화 메시지** | 사용자와 에이전트가 주고받은 것 |
| **첨부 미디어** | [첨부](/ko/docs/work/attachments/) — 메시지와 따로 셉니다 |

도구는 한 단계 더 쪼개집니다. 스킬·커넥터·기본 도구 그룹·워크스페이스 각각이 정의를 광고하는 데 드는 양과, 직전 실행에서 몇 번 불렸고 그 결과가 얼마나 무거웠는지를 보여줍니다. *"이 도구는 제공하는 것 자체가 비싸다"* 와 *"이 도구가 많이 돌려줬다"* 를 가르는 정보입니다.

## 실측과 예상

첫 [실행](/ko/docs/work/runs/) 전에는 잴 것이 없으므로 다음 요청이 실을 양의 **예상치**입니다. 실행 뒤에는 그 요청이 실제로 담았던 값입니다.

패널이 지금 보는 것이 어느 쪽인지 알려줍니다. 예상과 실측이 다른 것은 정상입니다 — 에이전트가 미리 알 수 없던 메모리나 도구 결과를 끌어올 수 있으니까요.

## 리소스

패널은 이 대화에 실린 첨부 목록도 보여줍니다. 하나를 고르면 그것이 딸려온 메시지로 스크롤합니다. 긴 실에서 *"아까 그 스크린샷"* 을 찾는 가장 빠른 방법입니다.

## 창이 가득 찼을 때

효과가 큰 순서로 대략 이렇습니다.

1. **새 [대화](/ko/docs/work/conversations/)를 시작하세요.** 가장 확실한 한 수입니다. 새 실은 옛 메시지를 하나도 안고 가지 않습니다.
2. 그전에 **오래 쓸 사실을 [메모리](/ko/docs/capabilities/memory/)나 [프로젝트](/ko/docs/capabilities/projects/)로 옮기세요.** 다음 실에서 다시 설명하지 않아도 됩니다.
3. **쓰지 않는 도구의 바인딩을 푸세요.** 정의는 부르든 안 부르든 매 스텝 다시 실립니다.
4. **창이 더 큰 모델을 고르세요** — 선택기가 모델별 크기를 보여줍니다. 자리는 벌지만, 흐트러진 실을 집중시키지는 못합니다.

<Aside type="tip" title="들어간다고 해서 긴 실이 공짜는 아닙니다">
  한 스텝의 비용은 새로 쓴 문장이 아니라 컨텍스트 전체입니다. 초점이 잡힌 대화 둘이, 주제 셋을
  오간 대화 하나보다 대개 싸고 답도 낫습니다.
</Aside>

## 한계

- 창 크기는 모델이 정합니다. 모델을 바꾸면 천장이 바뀝니다.
- 잘라내기는 오래된 메시지부터 버립니다. 요약해서 남기지 않습니다.
- 분해는 직전 실행 기준입니다. 그 뒤에 한 변경 — 도구 바인딩, 프롬프트 수정 — 은 다음 실행에 반영됩니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="대화"
    href="/ko/docs/work/conversations/"
    description="이어가는 대신 새 실을 시작해야 할 때."
  />
  <LinkCard
    title="메모리"
    href="/ko/docs/capabilities/memory/"
    description="대화 안이 아니라 대화를 건너 사실을 나르기."
  />
  <LinkCard
    title="모델 고르기"
    href="/ko/docs/build/models/"
    description="창 크기, 그리고 모델별 토큰 비용."
  />
</CardGrid>
