ИИ Ресурсы — Фабио Де ЛукаИИ Ресурсы — Фабио Де Лука
Python TypeScript Go Apache License 2.0

Zep Cloud: примеры и интеграции для памяти агентов (Zep Cloud: Examples & Integrations)

Полнофункциональное собрание примеров кода, интеграций с популярными фреймворками и инструментов для разработки агентов с управляемой памятью. Репозиторий содержит готовые решения для работы с Zep Cloud — платформой управления памятью ИИ-агентов, включая поддержку Python, TypeScript и Go.

⭐ Звёзд: 4,862 🔀 Форков: 651 📅 Обновлено: 24 августа 2026
Источник: https://github.com/getzep/zep

О репозитории

Репозиторий Zep Cloud содержит примеры кода, интеграции фреймворков и утилиты для работы с управляемой платформой памяти агентов. Это не основной продукт Zep, а сборка практических решений для разработчиков, которые хотят интегрировать память агентов в свои приложения.

Zep Cloud — это управляемый сервис, предоставляющий надёжное хранилище памяти для ИИ-агентов, с поддержкой различных типов данных, автоматической индексацией и быстрым поиском релевантной информации из истории взаимодействий.

Официальная документация Zep Cloud доступна на help.getzep.com, а для регистрации нужно перейти на www.getzep.com.

Официальные SDK и установка

Zep предоставляет официальные SDK для трёх основных языков программирования. Выберите нужный язык и используйте соответствующий менеджер пакетов:

Python

Для проектов на Python установите SDK через pip:

pip install zep-cloud

Python SDK обеспечивает полную поддержку всех возможностей Zep Cloud и используется в примерах и интеграциях этого репозитория.

TypeScript / JavaScript

Для Node.js проектов установите SDK через npm:

npm install @getzep/zep-cloud

TypeScript SDK позволяет работать с Zep Cloud в приложениях на Node.js, в том числе в среде браузера.

Go

Для проектов на Go используйте стандартную команду:

go get github.com/getzep/zep-go/v3

Go SDK предоставляет высокопроизводительный доступ к Zep Cloud для приложений на Go.

Структура проекта

Репозиторий организован по функциональности и содержит следующие основные директории и проекты:

Примеры кода

Директория examples/ содержит готовые примеры приложений и фрагменты кода на Python, TypeScript и Go. Эти примеры демонстрируют основные сценарии использования Zep Cloud, от простого сохранения сообщений до сложных операций с памятью и семантическим поиском.

Интеграции фреймворков

Директория integrations/ содержит пакеты интеграции для популярных фреймворков разработки агентов. Каждый пакет организован по схеме integrations/<фреймворк>/<язык>/ и разрабатывается, тестируется и выпускается независимо.

Конвейер приёма данных

Директория ingestion/ содержит инструмент zep-ingest — пакетный конвейер для импорта больших объёмов данных в Zep Cloud. Поддерживаются следующие источники данных:

  • Сообщения из Slack
  • Документы (PDF, Word, текстовые файлы)
  • Письма электронной почты
  • Данные из JSON и CSV файлов
  • Тройки фактов (subject-predicate-object)

Инструмент позволяет быстро загружать исторические данные и начинать работу с памятью агентов.

Онтология по умолчанию

Директория ontology/ содержит определения онтологии по умолчанию, которая используется для структурирования и категоризации знаний в Zep Cloud.

Плагины для IDE

Отдельные репозитории содержат плагины для популярных сред разработки:

  • Build with Zep — плагин для Claude Code, Codex и Cursor, позволяющий встраивать Zep Cloud прямо в процесс разработки кода.
  • Zep Memory — плагин для Claude Desktop/Cowork и ChatGPT Work, обеспечивающий контекстное использование памяти агентов в диалогах.

Бенчмарки

Директория benchmarks/ содержит результаты тестирования памяти агентов с использованием стандартных наборов данных:

  • LoCoMo — локальные контекстные показатели памяти
  • LongMemEval — оценка эффективности долгосрочной памяти

Оценочный стенд

Директория zep-eval-harness/ содержит инструмент оценки качества приёма и поиска данных в Zep Cloud. Стенд используется для тестирования и валидации работы конвейера приёма и операций поиска.

Наследие

Директория legacy/ содержит код устаревшей Zep Community Edition, которая больше не поддерживается. Весь код был перемещён сюда при переходе на новую открытую исходную стратегию Zep.

Интеграции с фреймворками

Репозиторий содержит готовые интеграции Zep Cloud с популярными фреймворками разработки агентов. Все пакеты находятся в директории integrations/ и организованы по фреймворкам и языкам.

Поддерживаемые фреймворки Python

На Python доступны интеграции со следующими фреймворками:

  • Google ADK (Agent Development Kit) — фреймворк от Google для разработки многоагентных систем с поддержкой различных инструментов и плагинов.
  • Microsoft Agent Framework — фреймворк Microsoft для создания агентов с поддержкой кооперации между агентами.
  • Microsoft AutoGen — система для разработки приложений с互диалогом между несколькими агентами, управляемыми искусственным интеллектом.
  • AG2 — развитие AutoGen с улучшенной архитектурой и производительностью.
  • CrewAI — фреймворк для организации команд агентов, где каждый агент имеет роль, цель и инструменты.
  • LangGraph — часть экосистемы LangChain, позволяющая строить управляемые граф-вычисления для сложных логик агентов.
  • LiveKit — фреймворк для разработки приложений реального времени с голосом и видео, поддерживающий интеграцию агентов.
  • Pydantic AI — фреймворк для валидации данных и разработки типобезопасных приложений с ИИ.
  • Strands Agents — фреймворк для разработки агентов с фокусом на надёжность и масштабируемость.

Поддерживаемые фреймворки TypeScript

На TypeScript / JavaScript доступны интеграции со следующими фреймворками:

  • Google ADK — версия Google Agent Development Kit для TypeScript, с полной поддержкой типов и асинхронных операций.
  • Mastra — TypeScript фреймворк для разработки ИИ-приложений с встроенной поддержкой Zep Cloud.
  • Vercel AI SDK — фреймворк Vercel для построения приложений с ИИ, включая поддержку потоковой передачи и сессионного управления.

Поддерживаемые фреймворки Go

На Go доступна интеграция со следующим фреймворком:

  • Google ADK — версия Google Agent Development Kit для Go, обеспечивающая высокопроизводительную разработку агентов.

Дополнительная информация о пакетах, статусе выпуска и ссылках доступна в файле integrations/README.md, а соглашения по разработке интеграций описаны в integrations/CLAUDE.md.

Начало работы с Zep Cloud

Регистрация и получение ключа API

Для использования Zep Cloud необходимо выполнить следующие шаги:

  1. Перейти на сайт www.getzep.com
  2. Зарегистрировать аккаунт или войти в существующий
  3. Создать проект в панели управления
  4. Получить API ключ для аутентификации
  5. Установить соответствующий SDK для вашего языка программирования

Установка SDK и зависимостей

После регистрации установите нужный SDK:

Для Python:

pip install zep-cloud

Для TypeScript/JavaScript:

npm install @getzep/zep-cloud

Для Go:

go get github.com/getzep/zep-go/v3

Базовая конфигурация

Создайте файл конфигурации или установите переменные окружения с вашим API ключом:

export ZEP_API_KEY="your_api_key_here"
export ZEP_API_URL="https://api.getzep.com"

Клонирование репозитория

Для работы с примерами и интеграциями клонируйте репозиторий:

git clone https://github.com/getzep/zep.git
cd zep

После клонирования можно изучить примеры в директории examples/ и интеграции в integrations/.

Применение Zep Cloud

Управление памятью чат-ботов

Zep Cloud идеально подходит для хранения и управления историей разговоров в чат-ботах и виртуальных ассистентах. Система автоматически индексирует сообщения, позволяя быстро извлекать релевантный контекст при ответах на новые вопросы пользователя.

Разработка многоагентных систем

При разработке систем, где несколько агентов работают совместно, Zep Cloud предоставляет централизованное хранилище общего контекста, позволяя агентам обмениваться информацией и синхронизировать своё состояние.

Персонализация пользовательского опыта

Благодаря долгосрочной памяти, Zep Cloud позволяет агентам запоминать предпочтения пользователя, предыдущие взаимодействия и контекст, обеспечивая более персонализированный и контекстный ответ.

Анализ и обработка больших объёмов диалогов

Инструмент zep-ingest позволяет быстро загружать и индексировать большие наборы исторических данных — из Slack, документов, писем и других источников. Это полезно для обучения агентов на исторических данных или построения семантических графов знаний.

Интеграция с платформами разработки

Плагины для Claude Code, Cursor и ChatGPT позволяют использовать Zep Cloud прямо в процессе разработки, облегчая создание агентов и тестирование логики памяти.

Оценка и бенчмаркинг

Директория benchmarks/ и оценочный стенд позволяют разработчикам тестировать и оптимизировать производительность системы памяти, используя стандартные наборы данных.

Часто задаваемые вопросы

Что такое Zep Cloud и чем он отличается от Zep Community Edition?

Zep Cloud — это управляемый сервис для хранения и управления памятью ИИ-агентов. Он предоставляется как облачный сервис с гарантией доступности, масштабируемостью и поддержкой. Zep Community Edition был локальной версией, но больше не поддерживается. Его код находится в директории legacy/ и используется исключительно в образовательных целях.

Нужно ли использовать официальный SDK или можно работать с REST API напрямую?

Хотя Zep Cloud предоставляет REST API, рекомендуется использовать официальные SDK, так как они обеспечивают типизацию, обработку ошибок и удобный интерфейс. Официальные SDK доступны для Python, TypeScript/JavaScript и Go.

Какие фреймворки разработки агентов поддерживаются Zep Cloud?

Zep Cloud имеет готовые интеграции со следующими фреймворками: Google ADK, Microsoft Agent Framework, AutoGen, AG2, CrewAI, LangGraph, LiveKit, Pydantic AI, Strands Agents (для Python), Mastra и Vercel AI SDK (для TypeScript), а также Google ADK для Go. Полный список интеграций находится в integrations/README.md.

Как загружать исторические данные в Zep Cloud?

Для загрузки больших объёмов данных используйте инструмент zep-ingest из директории ingestion/. Он поддерживает данные из Slack, документов, писем и файлов JSON/CSV. Инструмент предоставляет пакетный конвейер для быстрого и эффективного импорта.

Где найти примеры кода для начала работы?

Примеры кода находятся в директории examples/ репозитория. Там вы найдёте готовые приложения и фрагменты кода на Python, TypeScript и Go, демонстрирующие основные сценарии использования Zep Cloud.

Как внести свой вклад в развитие Zep Cloud?

Подробные рекомендации по внесению вклада, включая разработку кода, документации, отправку отчётов об ошибках и примеров сообщества, находятся в файле CONTRIBUTING.md репозитория.

Полезные ссылки

Esc