Cara guna Zep untuk memori chatbot dalam AI Flowi Workflow
Cara guna Zep untuk memori chatbot dalam AI Flowi Workflow melibatkan Zep Chat Memory untuk storan perbualan berasaskan Zep dengan empat tetapan: titik akhir, kelayakan akses, laluan API dan sesi. Ia mengembalikan objek Memory, jadi pengambilan teks untuk paparan memerlukan komponen penerima yang serasi dan bukannya menganggap output sebagai respons carian JSON.
Zep Chat Memory dan laluan pengambilan/paparan Message History yang dicadangkan di bawah didokumenkan dalam katalog; belum diuji dalam persekitaran pengeluaran oleh Ai Flowi. Eksport AI Flowi Workflow 1.9.2 bertarikh 9 Oktober 2026 mengenal pasti zep.ZepChatMemory dan menerangkannya sebagai Mengambil dan menyimpan mesej sembang daripada Zep.
Rujuk entri katalog Zep bersama rujukan konfigurasi ini.
Empat tetapan Zep Chat Memory
Jadual tetapan Zep mempunyai tatal mendatar supaya nota titik akhir dan sesi kekal tersedia pada skrin sempit.
| Input | Jenis medan | Wajib | Jenis sambungan | Batas konfigurasi |
|---|---|---|---|---|
api_base_path | str | Pilihan | Tidak dinyatakan | Pilihan yang dieksport: "api/v1", "api/v2". Tiada nilai lalai atau matriks keserasian diberikan. |
api_key | str | Pilihan | Senarai kosong | Tetapan kelayakan akses perkhidmatan; sahkan keperluan pengesahan titik akhir secara berasingan daripada penanda medan ini. |
session_id | str | Pilihan | Message | Memilih perbualan yang disediakan; tingkah laku penetapan dan pemberian kebenaran tidak dinyatakan. |
url | str | Pilihan | Message | Tetapan URL titik akhir yang menerima Message. Pembentukan dan kebolehcapaian URL tidak diterangkan. |
Setiap medan ditandakan sebagai pilihan dalam petikan ini. Metadata itu tidak membuktikan konfigurasi kosong yang berfungsi atau menentukan keperluan pengesahan sebenar titik akhir. Pada api_key, “Senarai kosong” merujuk kepada metadata sambungan yang dinyatakan secara jelas; medan laluan API pula langsung tidak mempunyai senarai sambungan yang diterima.
URL perkhidmatan dan laluan asas API
url mempunyai jenis medan str dan menerima Message. api_base_path juga ialah rentetan, dengan tepat dua pilihan yang dieksport: "api/v1" dan "api/v2". Pilihan itu menerangkan pemilih komponen, bukannya semua versi yang diterima oleh perkhidmatan Zep pada masa ini.
Cara menggabungkan URL/laluan tidak dinyatakan untuk komponen Zep ini. Dapatkan format titik akhir yang diperlukan oleh perkhidmatan sebenar anda sebelum mengisi kedua-dua medan; jangan teka sama ada URL sudah mengandungi akhiran API. Pemilih v2 sahaja tidak dapat membuktikan keserasian dengan perkhidmatan destinasi anda.
Anggap kebolehcapaian titik akhir, sokongan laluan dan pengesahan sebagai persoalan persediaan yang berasingan. Mengubah laluan tidak dapat menyelesaikan hos yang tidak diluluskan atau akses yang tiada. Walaupun kelayakan akses diterima oleh perkhidmatan, ketersediaan laluan API pilihan masih perlu disahkan.
Pengecam sesi dan skop kelayakan akses
session_id ialah rentetan yang menerima Message, tetapi ia mewakili pemilihan sesi dan bukannya teks sembang semasa. Gunakan pengecam stabil yang ditetapkan oleh aplikasi anda untuk sesi yang dibenarkan. Jangan sambungkan soalan pengguna ke medan itu hanya kerana jenis sambungan yang diterima sepadan.
Tiada user_id, kamus metadata atau pertanyaan carian yang dieksport secara berasingan pada nod Zep ini. Oleh itu, pemilihan sesi perlu diperiksa berdasarkan kontraknya sendiri. Medan sesi tidak memberikan bukti pengasingan pengguna atau penciptaan automatik bagi pengecam yang belum pernah digunakan.
Bekalkan kunci API perkhidmatan yang dikeluarkan kepada akaun Zep anda sendiri melalui panduan pengendalian kelayakan akses dan bayar caj Zep secara berasingan.
Objek Memory ialah satu-satunya output yang dieksport
| Label paparan | Nama port | Jenis | Batas penggunaan |
|---|---|---|---|
| Memory | memory | Memory | Sambungkan kepada input yang menerima Memory; ini bukan port Message, Table atau JSON. |
Message History menerima Memory dan mendokumenkan laluan pengambilan serta paparan mesej. Ikuti rujukan itu untuk mod dan output komponen penerima; persoalan khusus Zep di sini berkaitan dengan pemilihan titik akhir dan sesi yang dihantar kepada komponen penerima itu.
Output Zep tidak mengandungi port hasil carian yang dieksport atau skema rekod JSON yang didokumenkan. Ia juga tidak menyediakan operasi pertanyaan graf, pemadaman atau senarai sesi yang dinamakan. Ketiadaan itu mengehadkan perkara yang boleh dijanjikan oleh rujukan komponen ini, tanpa mengira keupayaan yang ditawarkan penyedia di tempat lain.
Periksa satu sesi sintetik yang dibenarkan
contoh konfigurasi, bukannya ujian yang direkodkan
Sediakan sesi sintetik yang dibenarkan dan mengandungi nota serah tugas rekaan melalui kaedah yang disokong perkhidmatan. Penyediaan sesi kekal di luar graf pengambilan ini: antara muka empat medan Zep Chat Memory tidak menyertakan operasi penciptaan.
- Tambah Zep Chat Memory. Tetapkan
urlkepada titik akhir yang dibekalkan untuk perkhidmatan anda danapi_keymenggunakan kelayakan akses anda. Tiada titik akhir universal atau nilai rahsia diberikan di sini. - Pilih
api_base_pathsebagai"api/v1"atau"api/v2"hanya selepas mengesahkan laluan yang disokong oleh titik akhir anda. Tetapkansession_idkepada pengecam sebenar sesi sintetik yang disediakan. - Gunakan konfigurasi pengambilan dan paparan Message History untuk menerima
memoryZep, sambil memastikan pengecam sesi komponen penerima sepadan dengan tetapan Zep. - Periksa keutamaan pengecam pada sambungan Memory: Zep dan Message History masing-masing menyediakan
session_id, tanpa peraturan yang dieksport untuk memilih salah satu apabila nilainya berbeza. - Periksa teks yang diambil dengan membandingkannya dengan nota serah tugas yang disediakan. Rekodkan pengambilan kosong, ketidakpadanan sesi dan kegagalan perkhidmatan secara berasingan daripada pengambilan teks yang selesai.
Output yang dimaksudkan ialah teks perbualan daripada sesi sintetik yang dibenarkan dan dipaparkan dalam Playground. Tiada nota yang dikembalikan atau permintaan berjaya yang didakwa. Pemeriksaan ini hanya meminta teks perbualan; konfigurasi dan pengebilan untuk peringkat model berikutnya diterangkan dalam rujukan Language Model.
Untuk pemeriksaan serah tugas, rekodkan kedua-dua nilai session_id yang dikonfigurasikan sebelum menyemak teks yang diambil. Jika nilainya berbeza, kewujudan nota tidak dapat memberitahu anda pengecam yang memilihnya: dua sesi yang disediakan boleh mengandungi teks serupa. Tentukan peraturan pemilihan komponen penerima sebelum menerima graf untuk digunakan semula. Mengubah tetapan paparan Message History tidak akan menjawab persoalan pemilihan pada bahagian belakang itu. Simpan nota serah tugas bersama rekod penyediaannya supaya teks yang tiada boleh dijejaki ke destinasi yang dimaksudkan dan bukannya dijelaskan melalui tekaan.
Bagaimana mengenal pasti batas Zep yang gagal?
| Batas | Kekalkan | Perkara yang perlu diperiksa |
|---|---|---|
| Pemilihan titik akhir | URL perkhidmatan dan kelayakan akses yang diluluskan. | Sama ada laluan API pilihan diterima oleh titik akhir sebenar. |
| Pemilihan sesi | URL, laluan dan kelayakan akses. | Sesi sintetik yang dibenarkan yang membekalkan mesej yang diambil. |
| Penggunaan Memory | Sambungan Memory yang telah disemak. | Sama ada komponen penerima yang serasi menerima teks perbualan yang dimaksudkan. |
| Jawapan kemudian | Teks yang diambil dan prompt sebenar. | Sama ada jawapan menggunakan teks yang dibekalkan kepadanya; storan sahaja tidak membuktikan keupayaan mengingat semula. |
Jika pengesahan atau laluan API gagal, siasat URL, laluan dan kunci sebelum melaraskan urutan pengambilan. Jika perkhidmatan boleh dicapai tetapi perbualan tiada, periksa penyediaan sesi dan pemetaan pengecam sebelum menambah model. Model tidak dapat membuktikan bahawa sesi yang tiada telah dicipta.
Semakan skop dan kitar hayat memori ejen merangkumi latihan pengasingan umum dan semakan pengekalan.
Untuk perubahan titik akhir Zep, simpan format URL yang dibekalkan perkhidmatan dan laluan API yang disokong bersama-sama sebagai rekod konfigurasi. Jika titik akhir baharu memerlukan laluan berbeza, sahkan pasangan itu sebelum menggunakan semula pengecam sesi yang disediakan; permintaan yang berjaya ke titik akhir lama tidak membuktikan ketersediaan sesi pada penggantinya. Elakkan mencuba kedua-dua nilai pemilih sehingga salah satunya kelihatan mengembalikan teks lalu menganggapnya sebagai kontrak versi. Dapatkan gabungan URL/laluan yang disokong dan sahkan nota yang disediakan pada destinasi itu. Ini membezakan pemindahan titik akhir daripada isu urutan komponen penerima.
Bila antara muka sesi ini sesuai
Gunakan nod ini apabila kontrak titik akhir dan sesi Zep sedia ada anda sepadan dengan empat tetapan ini. Glosari memori ejen menerangkan konsep pengekalan dan konteks. Untuk antara muka pemasukan dan carian yang dinamakan secara berasingan dengan medan pengguna serta metadata, periksa integrasi Mem0; output carian JSONnya ialah kontrak berbeza, bukannya ciri nod Zep.
Pilih antara muka lain yang disahkan apabila pengambilan JSON langsung, operasi graf atau pemadaman diwajibkan. Dapatkan bukti keserasian versi penyedia sebelum menggunakan petikan ini untuk titik akhir baharu. Direktori integrasi memautkan kategori sedia ada dan skop konfigurasinya.
Oleh Ai Flowi · Diterbitkan
Sumber rasmi: dokumentasi Zep
Penggunaan aliran kerja
Pelan: Go dari USD8/bulan dengan bil tahunan (USD10 bulanan), Plus dari USD16 (USD20 bulanan), Pro 100 dari USD80 (USD100 bulanan), Pro 200 dari USD160 (USD200 bulanan) dan Pro 500 dari USD400 (USD500 bulanan), dengan 5,000 hingga 250,000 Flowi Tokens sebulan dan pilihan tambah nilai; 1 token bagi setiap pelaksanaan nod; penggunaan API dan model pihak ketiga tidak termasuk.