Dify — агенты и базы знаний на холсте

Dify — открытая платформа для сборки ИИ-приложений: агентные воркфлоу, базы знаний и подключение моделей собираются визуально в общем рабочем пространстве. Разворачивается на своём сервере через Docker Compose (нужна версия 2.24.0 и новее), а готовое приложение публикуется как веб-страница, API или MCP-сервер для Claude и Cursor. Самостоятельный хостинг бесплатен, облачный Sandbox тоже. Проверено по документации 21 августа 2026 года.

Часть 1 · Знакомство

Что такое Dify и кому он нужен

Между «поговорить с моделью в чате» и «выкатить рабочее ИИ-приложение» лежит слой скучной работы: подключить провайдера, разложить документы по базе знаний, описать ветвления, приделать API, дать доступ коллегам и увидеть логи. Dify закрывает именно этот слой. На холсте собирается последовательность узлов, рядом лежат подключённые модели и инструменты, а результат публикуется наружу без отдельного бэкенда.

Репозиторий langgenius/dify собрал 153 111 звёзд; стабильный тег на момент проверки — 1.16.1 от 28 июля 2026 года, в потоке тегов уже лежат беты 2.0. Ближайший родственник по задаче — фреймворк LangGraph, и разница между ними ровно в способе описания графа: там его пишут на Python и держат в репозитории, здесь — рисуют на холсте и держат в рабочем пространстве. Отсюда и разные команды-пользователи: код — разработчикам, холст — тем, кто собирает процессы.

Часть 2 · Установка

Как развернуть Dify через Docker Compose

Требования отличаются по системам. Общее для всех — Docker Compose 2.24.0 или новее (проверяется командой docker compose version). На macOS нужен Docker Desktop, а его виртуальной машине выделяют минимум 2 виртуальных процессора и 8 ГиБ памяти. На Linux достаточно Docker 19.03 и новее. На Windows — Docker Desktop с включённым WSL 2, и документация просит держать исходники и данные в файловой системе Linux, а не Windows.

# клон на теге последнего релиза (нужны git, curl и jq)
git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git

cd dify/docker
cp .env.example .env

docker compose up -d
docker compose ps

Поднимается заметно больше, чем один контейнер: семь основных сервисов (api, api_websocket, worker, worker_beat, web, plugin_daemon, agent_backend), восемь зависимых компонентов (weaviate, db_postgres, redis, nginx, ssrf_proxy, agent_ssrf_proxy, sandbox, local_sandbox) и одна разовая задача init_permissions, которая выставляет права на файлы хранилища и завершается.

Первый заход — на страницу инициализации администратора http://localhost/install (или адрес сервера вместо localhost). После создания аккаунта Dify открывается на корне. Настройки живут в двух местах: основные переменные — в docker/.env, который вы создали из примера, дополнительные шаблоны — в docker/envs/, откуда нужный файл копируют без суффикса .example и правят. Значения из docker/.env перебивают всё, что лежит в docker/envs/. После правки — docker compose down и снова up -d.

Про обновление документация честно предупреждает, что порядок шагов меняется от релиза к релизу и смотреть надо инструкцию конкретной версии на странице релизов. Полезная привычка после каждого апгрейда — сверить свой .env с новым .env.example: переменные добавляются и переименовываются.

Часть 3 · Сборка

Узлы, база знаний и плагины

Приложение в Dify — это Workflow или Chatflow, собранный из узлов. В документации перечислены узлы старта и пользовательского ввода, триггер от интеграции, вывод результата, узел агента (модель сама распоряжается инструментами), классификатор вопроса для маршрутизации, условие if-else, узел ожидания человеческого ввода, итерация по массиву, цикл с постепенным уточнением и агрегатор переменных, который сводит расходящиеся ветки обратно в один выход. Группы узлов сохраняются сниппетами и переиспользуются в других воркфлоу.

Узел ожидания человека стоит отметить отдельно: он позволяет остановить процесс на согласовании и продолжить после ответа — то, что в самописных сценариях обычно делают руками через очередь и вебхук. Логика «дальше решает человек» встречается и в сценариях n8n, только там она собирается вокруг веб-хуков, а здесь встроена в холст.

База знаний вынесена в отдельную сущность — Knowledge Pipeline: её создают, собирают из узлов и публикуют тремя последовательными шагами. Модели, инструменты, источники данных и внешние сервисы подключаются через интеграции и плагины, а собственные приложения можно выложить в Dify Marketplace. Что делать с этим дальше на уровне бизнеса — разобрано в гайде про ИИ-агентов в бизнес-процессах.

Часть 4 · MCP

Приложение Dify как MCP-сервер для Claude

Собранное приложение можно не только опубликовать веб-страницей, но и выставить как MCP-сервер. Модуль лежит в настройках приложения и по умолчанию выключен; при включении Dify генерирует уникальный адрес сервера. Для Claude его вставляют в профиле через Settings → Integrations → Add integration. Для Cursor — в файл .cursor/mcp.json в корне проекта; несколько приложений добавляются несколькими записями. Что такое MCP вообще и какие ещё серверы бывают — в обзоре MCP-серверов для Claude Code.

{
  "mcpServers": {
    "имя-сервера": {
      "url": "адрес-из-настроек-приложения"
    }
  }
}

Две практические оговорки из документации стоят того, чтобы прочитать их до подключения. Первая про описания: их читает не человек, а модель, и от точности формулировки зависит, вызовет ли агент инструмент правильно. Вместо «входные данные» документация советует писать «JSON-объект с профилем пользователя, обязательные поля name, email, preferences». Вторая про задержку: протокол отвечает за транспорт, но не ускоряет ваше приложение — если воркфлоу думает тридцать секунд, ровно столько же ждёт и агент на другом конце. Лечится дроблением тяжёлого воркфлоу на несколько быстрых.

Обратное направление тоже работает: MCP-инструменты подключаются внутрь воркфлоу и агентов Dify, то есть платформа выступает и сервером, и клиентом. Если нужен свой сервер с нуля, а не обёртка над готовым приложением, это отдельная история — как написать собственный MCP-сервер.

Часть 5 · Деньги

Тарифы Dify Cloud и бесплатные варианты

Цены и лимиты сверены по странице тарифов 21 августа 2026 года. Enterprise идёт по договорной цене и добавляет коммерческую лицензию, несколько пространств, SSO и SLA.

Кредиты сообщений — не валюта платформы, а пробный ресурс на модели, которые Dify подключил у себя: OpenAI, Anthropic, Gemini, xAI, Tongyi. Кончились кредиты — подставляется собственный ключ провайдера, и работа продолжается уже за счёт вашего счёта у модели. То есть двести кредитов Sandbox нужны, чтобы платформу пощупать; жить на них не выйдет. Годовая оплата, по бейджу на странице тарифов, экономит 17 %.

Вопросы

Частые вопросы

Читать дальше

Соседние гайды