Zep 컨텍스트 템플릿 — 컨텍스트 블록 커스터마이징
Zep 컨텍스트 템플릿
기본 컨텍스트 블록이 마음에 들지 않을 때, 템플릿을 만들어 컨텍스트 블록의 형식과 양을 조절할 수 있어요. 템플릿은 프로젝트에서 한 번 정의해 두면 모든 스레드와 사용자에 재사용할 수 있어요. Zep이 관련성 탐지와 검색을 자동 처리하므로, 우리는 '무엇을 얼마나 넣을지'만 정하면 돼요.
왜 쓸까요
- 기본 Context Block보다 더 많은 제어(형식·구조 커스터마이징)
- 그래프 검색을 직접 다루는 것보다는 간단하지만, 자동 관련성 탐지를 유지
- 일관된 커스텀 포맷이 필요하면서 자동 관련성 탐지를 원할 때 가장 적합
사용 가능한 변수
템플릿은 변수로 어떤 데이터를 넣을지 지정해요.
%{edges}— 그래프 엣지(사실/관계)%{entities}— 그래프 엔티티(노드)%{episodes}— 에피소드 데이터%{user_summary}— 사용자 요약 정보
변수(단 user_summary 제외)는 선택 파라미터를 받아요.
limit=N— 결과 수 제한 (최대 1000)types=[type1,type2]— 엔티티/엣지 타입 필터include_attributes=true/false— 속성 포함 여부
템플릿 만들기·쓰기
고유한 template_id와 템플릿 내용으로 템플릿을 만들어요. 생성 시 검증이 이뤄져서 잘못된 변수명, 괄호 균형, 파라미터 문법, 범위를 벗어난 limit 값이 있으면 바로 잡아 줘요.
컨텍스트를 가져올 때 template_id 파라미터를 넘겨 사용하고, 템플릿 내용을 수정하거나 ID로 조회·삭제할 수 있어요.