Zepメモリの使い方：AI Flowi Workflowでの連携
Zepメモリの使い方では、会話の保存に使うAI Flowi WorkflowのZep Chat Memoryがエンドポイント、認証情報、APIパス、セッションの4つの設定を公開しています。返すのは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の4つの設定
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"の2つだけです。これらはコンポーネントの選択項目を示すもので、現在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レコードのスキーマはありません。また、名前の付いたグラフクエリ、削除、セッション一覧の操作も公開していません。プロバイダーがほかで提供する機能に関係なく、これらの欠落によって、このコンポーネントリファレンスが約束できる範囲は限定されます。
利用権限のあるテスト用セッションを1つ確認する
設定例であり、記録されたテストではありません
サービスが対応する方法で、架空の引き継ぎメモを含む、利用権限のあるテスト用セッションを用意します。セッションの準備はこの取得グラフの外で行います。Zep Chat Memoryの4フィールドのインターフェースには作成操作がありません。
- 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値を記録します。値が異なる場合、メモがあるだけでは、どちらの識別子がそれを選んだか分かりません。用意した2つのセッションに似たテキストが入っている可能性があります。グラフを再利用可能と判断する前に、受け取り側の選択ルールを確認してください。Message Historyの表示設定を変えても、バックエンドの選択に関する問いには答えられません。引き継ぎメモを準備記録と結び付けて保存し、テキストの欠落を推測で説明せず、意図した接続先へたどれるようにします。
どの境界でZepが失敗したかをどう診断しますか？
| 境界 | 固定するもの | 確認するもの |
|---|---|---|
| エンドポイントの選択 | 承認済みのサービスURLと認証情報。 | 選んだAPIパスを実際のエンドポイントが受け付けるか。 |
| セッションの選択 | URL、パス、認証情報。 | 取得したメッセージの元となる、利用権限のあるテスト用セッション。 |
| Memoryの利用 | 確認済みのMemory接続。 | 互換性のある受け取り側が、意図した会話テキストを受け取るか。 |
| 後の段階の回答 | 取得したテキストと実際のプロンプト。 | 回答が渡されたテキストを使うか。保存だけでは想起できることは確認できません。 |
認証やAPI経路が失敗した場合は、取得順序を調整する前にURL、パス、キーを調べてください。サービスに到達できても会話がない場合は、モデルを追加する前にセッションの準備と識別子の対応付けを確認します。モデルでは、欠けているセッションが作成されたことは確認できません。
エージェントメモリの範囲とライフサイクルの確認は、一般的な分離の演習と保存期間の確認を扱います。
Zepのエンドポイントを変える場合は、サービスが提供したURL形式と対応するAPIパスを、1つの設定記録として保存します。新しいエンドポイントに別のパスが必要な場合は、用意したセッション識別子を再利用する前に、その組み合わせを検証してください。以前のエンドポイントへのリクエスト成功は、新しい接続先でのセッションの利用可否を示しません。両方の選択値を試し、テキストが返されたように見える方を対応バージョンの仕様として扱うことは避けてください。対応するURLとパスの組み合わせを取得し、その接続先で用意したメモを検証します。これによって、エンドポイントの移行と受け取り側の順序の問題を区別できます。
このセッションインターフェースが適する場合
既存のZepエンドポイントとセッションの仕様が、この4つの設定に合う場合にこのノードを使ってください。エージェントメモリ用語集は、保存期間とコンテキストの概念を説明しています。ユーザーとメタデータのフィールドを持つ、別の名前の取り込み・検索インターフェースについては、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とモデルの利用料金は含まれません。