에이전트
메모리와 채팅 기록
AI 에이전트가 기억하는 내용을 제어하는 방법: 한 대화 안에서의 채팅 기록과 대화 간의 메모리.
에이전트는 두 가지 방식으로 기억할 수 있습니다. **채팅 기록(Chat history)**은 에이전트가 현재 대화에서 보는 내용입니다. **메모리(Memory)**는 대화를 넘나들며 쓸 수 있고 읽을 수 있는 메모 저장소입니다. 이 둘은 별개의 설정이며, 둘 중 하나만, 둘 다, 또는 둘 다 사용하지 않을 수 있습니다.
채팅 기록#
채팅 기록은 새 질문마다 에이전트가 대화의 이전 메시지 중 몇 개를 함께 받을지 결정합니다. 이것이 없으면 에이전트는 모든 메시지를 첫 메시지인 것처럼 답변합니다.
고급(Advanced) 탭의 채팅 기록 섹션에서 찾을 수 있습니다. 섹션 헤더의 스위치로 켜거나 끌 수 있습니다. 새 에이전트에서는 켜져 있습니다. 섹션 헤더에는 설정이 요약되어 표시됩니다. 예를 들어 “Last 10 messages · 8000 tokens"와 같습니다.
스위치를 켜면 다음을 설정할 수 있습니다.
- 기록 메시지 수(History Message Count). 포함할 최근 메시지 수입니다. 기본값은 10이며 1에서 50까지 선택할 수 있습니다.
- 기록 최대 토큰(History Max Tokens). 기록에서 보낼 텍스트의 최대량입니다. 기본값은 8000이며 100에서 8000까지 100 단위로 선택할 수 있습니다.
- 메시지 유형(Message Types). 어떤 종류의 메시지를 포함할지 지정합니다: 사용자 메시지(User Messages), AI 메시지(AI Messages), 도구 호출(Tool Calls). 기본적으로 에이전트는 사용자 메시지와 AI 메시지를 봅니다.
기록이 길수록 에이전트는 더 많은 맥락을 얻지만, 매 메시지마다 모델로 전송되는 텍스트도 많아집니다.
메모리#
메모리를 사용하면 에이전트가 한 대화를 넘어서 정보를 보관할 수 있습니다. 예를 들어 고객의 선호나 학습한 사실 등입니다. 새 에이전트에서는 꺼져 있습니다.
환경 설정(Preferences) 탭의 메모리 섹션에서 찾을 수 있습니다. 섹션 헤더의 스위치를 켠 다음 다음을 설정합니다.
- 메모리 카테고리(Memory Category). 에이전트가 읽고 쓰는 메모리 항목의 그룹입니다. 반드시 하나를 선택해야 합니다. 메모리가 켜져 있는데 카테고리를 선택하지 않으면 빌더는 “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked.“라고 경고합니다. 카테고리는 memory에서 만들고 관리합니다.
- 접근 모드(Access Mode). **읽기 전용(Read Only)**은 에이전트가 메모리를 검색할 수 있게 합니다. **읽기/쓰기(Read/Write)**는 항목을 추가하고 갱신하는 것도 허용합니다.
- 메모리 읽기 프롬프트(Read Memory Prompt). 읽기 도구를 언제 어떻게 사용할지 에이전트에게 알려주는 지침입니다.
- 메모리 쓰기 프롬프트(Write Memory Prompt). 쓰기 도구를 언제 어떻게 사용할지에 대한 지침입니다. 읽기/쓰기 모드에서 중요합니다.
- 흐름 입력 오프로드(Offload Flow Input). 켜면 실행의 입력이 저장되고 에이전트가 나중에
get_offloaded_memory라는 도구로 가져올 수 있습니다. 기본값은 꺼짐입니다.
두 프롬프트는 대부분의 에이전트에 적합한 기본값으로 시작합니다. 에이전트가 너무 많이, 너무 적게 또는 잘못된 내용을 쓸 때 수정하세요.
메모리는 카테고리에 속합니다
에이전트는 선택한 카테고리를 통해 항목을 저장하고 검색합니다. 같은 카테고리를 사용하는 에이전트는 같은 메모리에서 작업하므로, 두 에이전트가 메모를 공유하지 않아야 한다면 별도의 카테고리를 사용하세요.
무엇을 사용할까#
| 원하는 것 | 사용할 것 |
|---|---|
| 에이전트가 주고받는 대화를 따라가길 원함 | 채팅 기록 |
| 어제 대화에서 알게 된 내용을 에이전트가 알길 원함 | 메모리 |
| 문서를 기반으로 한 답변 | 리트리버 도구, 에이전트 도구 참고 |
문제가 생겼을 때#
- 메모리를 켠 뒤 에이전트가 답변을 멈추면 카테고리가 선택되었는지 확인하세요.
- 두 메시지 전에 한 말을 잊으면 채팅 기록 스위치가 켜져 있고 사용자 메시지가 선택되었는지 확인하세요.
- 메모리에 아무것도 쓰지 않으면 접근 모드가 읽기/쓰기인지 확인하세요.