Zep 사용법: AI Flowi Workflow 메모리 연동
Zep 사용법에서는 Zep 기반 대화 저장을 위해 AI Flowi Workflow가 제공하는 Zep Chat Memory를 다룹니다. 설정은 엔드포인트, 인증 정보, API 경로, 세션의 네 가지입니다. Memory 객체를 반환하므로 표시할 텍스트를 검색하려면 호환되는 수신 컴포넌트가 필요합니다. 출력을 JSON 검색 응답으로 취급해서는 안 됩니다.
Zep Chat Memory와 아래에서 제안하는 Message History 검색·표시 경로는 카탈로그에 문서화되어 있습니다. Ai Flowi가 운영 환경에서 테스트하지 않았습니다. 2026년 10월 9일자 AI Flowi Workflow 1.9.2 내보내기는 zep.ZepChatMemory를 식별하며 Zep에서 채팅 메시지를 검색하고 저장한다
고 설명합니다. 이 구성 참조 문서와 함께 Zep 카탈로그 항목을 참고합니다.
Zep Chat Memory의 네 가지 설정
Zep 설정 표는 가로로 스크롤할 수 있어 좁은 화면에서도 엔드포인트와 세션 설명을 확인할 수 있습니다.
| 입력 | 필드 유형 | 필수 여부 | 연결 유형 | 구성 경계 |
|---|---|---|---|---|
api_base_path | str | 선택 사항 | 명시되지 않음 | 내보낸 선택지: "api/v1", "api/v2". 기본값이나 호환성 매트릭스는 제공되지 않습니다. |
api_key | str | 선택 사항 | 빈 목록 | 서비스 인증 정보 설정입니다. 이 필드 표시와 별개로 엔드포인트의 인증 요구사항을 확인합니다. |
session_id | str | 선택 사항 | Message | 준비한 대화를 선택합니다. 할당 및 권한 부여 동작은 명시되지 않았습니다. |
url | str | 선택 사항 | Message | Message를 받는 엔드포인트 URL 설정입니다. URL 조합 방식과 접근 가능 여부는 설명되어 있지 않습니다. |
이 스냅샷에서는 모든 필드가 선택 사항으로 표시되어 있습니다. 이 메타데이터만으로 빈 구성이 작동하거나 엔드포인트의 실제 인증 요구사항이 충족된다고 판단할 수는 없습니다. api_key의 ‘빈 목록’은 명시적인 연결 메타데이터를 뜻합니다. API 경로 필드에는 허용 연결 목록 자체가 없습니다.
서비스 URL과 API 기본 경로
url의 필드 유형은 str이며 Message를 받습니다. api_base_path도 문자열이고 내보낸 선택지는 정확히 두 개, "api/v1"과 "api/v2"입니다. 이 옵션은 컴포넌트 선택기를 설명하며 현재 Zep 서비스에서 허용하는 모든 버전을 뜻하지 않습니다.
이 Zep 컴포넌트의 URL과 경로 조합 방식은 명시되어 있지 않습니다. 두 필드를 입력하기 전에 실제 서비스가 요구하는 엔드포인트 형식을 확인합니다. URL에 이미 API 접미사가 포함되어 있는지 추측하지 않습니다. v2 선택기만으로 대상 서비스와의 호환성을 입증할 수는 없습니다.
엔드포인트 접근 가능 여부, 경로 지원, 인증은 각각 확인합니다. 경로를 바꿔도 승인되지 않은 호스트나 접근 권한 부재를 해결할 수는 없습니다. 서비스에서 인증 정보를 받아들여도 선택한 API 경로를 사용할 수 있는지는 별도로 확인해야 합니다.
세션 식별자와 인증 정보 범위
session_id는 Message를 받는 문자열이지만 현재 채팅 텍스트가 아니라 세션 선택을 나타냅니다. 권한이 있는 세션에 대해 애플리케이션에서 부여한 안정적인 식별자를 사용합니다. 허용 연결 유형이 맞는다는 이유만으로 사용자의 질문을 해당 필드에 연결하지 않습니다.
이 Zep 노드에는 별도로 내보낸 user_id, 메타데이터 사전, 검색 질의가 없습니다. 따라서 세션 선택은 자체 규약을 기준으로 검토해야 합니다. 세션 필드는 사용자 격리나 이전에 사용하지 않은 식별자의 자동 생성을 입증하지 않습니다.
본인의 Zep 계정에 발급된 서비스 API 키를 인증 정보 처리 안내에 따라 제공하고 Zep 요금은 별도로 결제합니다.
내보낸 출력은 Memory 객체 하나뿐입니다
| 표시 이름 | 포트 이름 | 유형 | 사용 범위 |
|---|---|---|---|
| Memory | memory | Memory | Memory를 받는 입력에 연결합니다. Message, Table, JSON 포트가 아닙니다. |
Message History는 Memory를 받으며 검색과 메시지 표시 경로가 문서화되어 있습니다. 수신 컴포넌트의 모드와 출력은 해당 참조 문서를 따릅니다. 여기서 다루는 Zep 고유의 확인 사항은 엔드포인트 선택과 수신 컴포넌트에 전달되는 세션입니다.
Zep 출력에는 내보낸 검색 결과 포트나 문서화된 JSON 레코드 스키마가 없습니다. 명명된 그래프 질의, 삭제, 세션 목록 작업도 제공하지 않습니다. 제공업체가 다른 곳에서 제공하는 기능과 관계없이 이러한 누락은 이 컴포넌트 참조 문서가 보장할 수 있는 범위를 제한합니다.
권한이 있는 합성 세션 하나를 검토합니다
예시 구성입니다. 기록된 테스트가 아닙니다
서비스가 지원하는 방법으로 가상의 인수인계 메모가 담긴, 사용 권한이 있는 합성 세션을 준비합니다. 세션 준비는 이 검색 그래프 밖에서 수행합니다. Zep Chat Memory의 네 필드 인터페이스에는 생성 작업이 없습니다.
- Zep Chat Memory를 추가합니다.
url은 서비스에서 제공한 엔드포인트로 설정하고 본인의 인증 정보로api_key를 설정합니다. 여기서는 범용 엔드포인트나 비밀 값을 제공하지 않습니다. - 엔드포인트가 지원하는 경로를 확인한 뒤에만
api_base_path를"api/v1"또는"api/v2"로 선택합니다.session_id는 준비한 합성 세션의 실제 식별자로 설정합니다. - Message History 검색·표시 구성으로 Zep의 메모리(
memory)를 사용하고, 수신 컴포넌트의 세션 식별자를 Zep 설정과 일치시킵니다. - Memory 연결에서 식별자 우선순위를 검토합니다. Zep와 Message History는 각각
session_id를 제공하지만 값이 다를 때 어느 것을 선택하는지에 대한 규칙은 내보낸 정보에 없습니다. - 검색된 텍스트를 준비한 인수인계 메모와 비교합니다. 빈 검색 결과, 세션 불일치, 서비스 실패를 완료된 텍스트 검색과 구분하여 기록합니다.
의도한 출력은 권한이 있는 합성 세션의 대화 텍스트를 Playground에 표시하는 것입니다. 메모가 반환되었거나 요청이 성공했다고 주장하지 않습니다. 이 검토는 대화 텍스트만 요청합니다. 이후 모델 단계의 구성과 요금은 Language Model 참조 문서에서 다룹니다.
인수인계 검토에서는 검색된 텍스트를 살펴보기 전에 두 곳에 설정된 session_id 값을 모두 기록합니다. 값이 다르면 메모가 있다는 사실만으로 어떤 식별자가 선택에 사용되었는지 알 수 없습니다. 준비한 두 세션에 비슷한 텍스트가 들어 있을 수도 있습니다. 그래프를 재사용하기 전에 수신 컴포넌트의 선택 규칙을 확인합니다. Message History 표시 설정을 변경해도 이 백엔드 선택 문제는 해결되지 않습니다. 인수인계 메모를 준비 기록과 함께 보관하여 텍스트가 누락되었을 때 추측이 아니라 의도한 대상까지 추적할 수 있도록 합니다.
Zep에서 어느 경계에서 문제가 발생했는지 어떻게 진단하나요?
| 경계 | 고정할 항목 | 검토할 사항 |
|---|---|---|
| 엔드포인트 선택 | 승인된 서비스 URL과 인증 정보입니다. | 실제 엔드포인트에서 선택한 API 경로를 허용하는지 확인합니다. |
| 세션 선택 | URL, 경로, 인증 정보입니다. | 검색된 메시지가 권한이 있는 어느 합성 세션에서 제공되는지 확인합니다. |
| Memory 사용 | 검토한 Memory 연결입니다. | 호환되는 수신 컴포넌트가 의도한 대화 텍스트를 받는지 확인합니다. |
| 후속 답변 | 검색된 텍스트와 실제 프롬프트입니다. | 답변이 제공된 텍스트를 사용하는지 확인합니다. 저장했다는 사실만으로 해당 내용을 다시 불러와 활용할 수 있는지는 알 수 없습니다. |
인증이나 API 경로가 실패하면 검색 순서를 조정하기 전에 URL, 경로, 키를 조사합니다. 서비스에는 접근할 수 있지만 대화가 없으면 모델을 추가하기 전에 세션 준비와 식별자 매핑을 확인합니다. 모델만으로 누락된 세션이 생성되었다고 입증할 수는 없습니다.
에이전트 메모리 범위와 수명주기 확인에서는 일반적인 격리 검토와 보존 검토를 다룹니다.
Zep 엔드포인트를 변경할 때는 서비스가 제공한 URL 형식과 지원 API 경로를 하나의 구성 기록으로 보관합니다. 새 엔드포인트에 다른 경로가 필요하면 준비한 세션 식별자를 재사용하기 전에 해당 조합을 검증합니다. 이전 엔드포인트에 대한 요청이 성공해도 대체 엔드포인트에서 세션을 사용할 수 있다는 뜻은 아닙니다. 두 선택기 값을 번갈아 시도하다가 텍스트가 나오는 것을 버전 규약으로 취급하지 않습니다. 지원되는 URL·경로 조합을 확보하고 해당 대상에서 준비한 메모를 확인합니다. 이렇게 하면 엔드포인트 이전과 수신 컴포넌트 순서 문제를 구분할 수 있습니다.
이 세션 인터페이스가 적합한 경우
기존 Zep 엔드포인트와 세션 규약이 이 네 설정에 맞을 때 이 노드를 사용합니다. 에이전트 메모리 용어집에서는 보존과 컨텍스트 개념을 설명합니다. 사용자·메타데이터 필드와 별도로 명명된 수집·검색 인터페이스가 필요하면 Mem0 연동을 검토합니다. 해당 JSON 검색 출력은 다른 규약이며 Zep 노드의 기능이 아닙니다.
직접 JSON 검색, 그래프 작업, 삭제가 필수라면 다른 검증된 인터페이스를 선택합니다. 새 엔드포인트에 이 스냅샷을 적용하기 전에 제공업체 버전 호환성 근거를 확보합니다. 연동 목록에서 기존 범주와 각 구성 범위를 확인할 수 있습니다.
작성: Ai Flowi · 게시일
공식 출처: Zep 문서
워크플로우 사용량
요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.