# 메모리

> 에이전트가 대화 사이에 간직하는 것, 무엇을 남길지 정하는 방식, 그리고 저장된 것을 확인·수정·삭제하는 법.

**메모리**는 에이전트가 [대화](/ko/docs/work/conversations/) 사이로 들고 다니는 것입니다. 사용자에 대한 사실, 선호, 일을 어떻게 처리하기를 원하는지 같은 것들이죠. 의도적으로 저장되고, 모든 항목을 읽어볼 수 있습니다.

## 언제 쓰는가

메모리는 되풀이해 말하지 않아도 될, 오래 가는 사실을 위한 것입니다. 어느 시간대에서 일하는지, 팀이 누구인지, 숫자를 반올림해 달라는 것, "그 보고서" 가 특정 폴더의 그것을 뜻한다는 것 같은 것들입니다.

서류함이 아닙니다. 내용물은 [아티팩트](/ko/docs/capabilities/artifacts/)에, 특정 업무의 배경은 [프로젝트](/ko/docs/capabilities/projects/)에 둡니다.

## 에이전트가 쓰는 방식

무엇을 남길 만한지는 에이전트가 판단해 적어둡니다. 사용자가 정정해 주거나 선호를 말한 뒤에 적는 경우가 많습니다. 대화가 시작될 때는 아는 것의 색인을 싣고, 저장한 것 전부가 아니라 지금 작업에 관련된 항목만 끌어옵니다.

그냥 말해도 됩니다. *"금요일에는 회의를 안 잡는다는 걸 기억해줘"* 는 평범한 지시이고, 에이전트는 그것을 저장합니다.

## 확인하고 바로잡기

메모리는 [에이전트 빌더](/ko/docs/build/agent-builder/)의 정체성 섹션에 나열됩니다. 모든 항목을 읽을 수 있고, 남으면 안 될 것은 지울 수 있습니다.

가끔은 꼭 확인하세요. 에이전트는 추론한 것도 적어둡니다. 한 번 조급하게 답한 것을 보고 *"짧은 답을 선호함"* 이라고 사실처럼 적어두면, 그것이 몇 주 동안 조용히 답을 좌우합니다.

<Aside type="caution" title="메모리는 에이전트별입니다">
  에이전트마다 따로 기억합니다. 한 에이전트에게 선호를 가르쳤다고 다른 에이전트가 알게 되지
  않습니다. 모든 에이전트가 알아야 할 것은 각 에이전트의 [시스템 프롬프트](/ko/docs/build/system-prompt/)
  에 두는 편이 낫습니다.
</Aside>

<Screenshot
  name="studio-memory"
  alt="약속·지식·로그로 묶인 메모리 섹션 — 나중에 확인할 환불 건, 청구 담당이 누구인지에 대한 사실, 주간 요약을 언제 보내는지에 대한 규칙, 그리고 접혀 있는 지난 기록 하나."
/>

## 끄기

메모리는 [내장 툴 그룹](/ko/docs/capabilities/built-in-tools/) 중 하나입니다. 에이전트에서 끄면 저장과 회상이 멈추고, 대화가 시작될 때 메모리 색인을 싣는 것도 멈춥니다. 기존 항목은 남고, 에이전트가 그것을 쓰지 않게 됩니다.

다른 사람의 데이터를 다루는 에이전트, 또는 상태 없이 예측 가능하게 두고 싶은 에이전트에 맞는 설정입니다.

## 한계

- 메모리는 계정별이 아니라 에이전트별입니다.
- 무엇을 저장할지는 에이전트가 정합니다. 메모리 목록을 미리 써넣을 수는 없지만, 무엇을 기억하라고 말할 수 있고 잘못 적은 것은 지울 수 있습니다.
- 항목을 지우면 이후 실행에서 회상되지 않습니다. 이미 그것을 쓴 대화가 고쳐지지는 않습니다.
- 메모리는 검색 가능한 콘텐츠 저장소가 아닙니다. 큰 문서는 아티팩트에 두세요.

## 관련 문서

<CardGrid>
  <LinkCard
    title="프로젝트"
    href="/ko/docs/capabilities/projects/"
    description="에이전트가 아니라 하나의 업무를 위한 공유 맥락."
  />
  <LinkCard
    title="시스템 프롬프트"
    href="/ko/docs/build/system-prompt/"
    description="잊히거나 추측돼서는 안 되는 상시 규칙."
  />
  <LinkCard
    title="내장 툴"
    href="/ko/docs/capabilities/built-in-tools/"
    description="메모리를 켜고 끄는 곳."
  />
</CardGrid>