ММООЗЗГГ.ru

Инструкция

Как собрать ИИ-агента в Dify

8 мин16 источников

Агента в Dify собирают в веб-интерфейсе: модель, инструкция, инструменты и база знаний настраиваются без кода. Для установки на свой сервер хватит машины с 2 ядрами процессора и 4 ГиБ памяти. Коммерческое использование разрешено, но с двумя условиями лицензии, их разберем в конце.

На странице · 5 разделов

Соберете сами за неделю

Что умеет Dify

Dify это платформа для ИИ-приложений с открытым кодом. В одном интерфейсе в ней собирают агентов, чат-ботов и рабочие процессы, подключают документы и смотрят журнал ответов.

Рабочий процесс здесь значит цепочку шагов, которую вы задаете заранее. Агент работает иначе: модель сама решает, какой шаг сделать и какой инструмент вызвать.

При создании приложения Dify предлагает тип. Два основных типа, «Workflow» и «Chatflow», рисуются на схеме из блоков. Еще три простых типа, «Chatbot», «Agent» и «Text Generator», настраиваются формой без схемы.

Приложение типа «Agent» это чат, где модель рассуждает и сама вызывает инструменты: поиск в интернете, запросы к сервисам и базам данных. Схему шагов для него рисовать не нужно, достаточно инструкции и списка инструментов.

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

В бета-версии у Dify появился агент нового типа со своей песочницей: он сам запускает команды и работает с файлами. В инструкции ниже мы собираем стабильное приложение «Agent», к которому база знаний подключается напрямую. Похожий визуальный конструктор, Flowise, разобран отдельно.

Установка

Dify ставится на ваш компьютер или сервер через Docker. Docker это программа, которая запускает приложение в готовых контейнерах со всеми зависимостями, поэтому вручную ничего настраивать не придется.

Требования по документации: не меньше 2 ядер процессора и 4 ГиБ оперативной памяти, Docker и Docker Compose свежих версий. На Mac в настройках Docker Desktop выделите виртуальной машине не меньше 2 процессоров и 8 ГиБ памяти. Для первой команды нужны программы git, curl и jq.

1. Скачайте код последней версии Dify командой из документации: git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git. Если она выдает ошибку «Remote branch null not found», укажите номер версии со страницы релизов: git clone --branch <версия> https://github.com/langgenius/dify.git.

2. Перейдите в папку с настройками запуска: cd dify/docker.

3. Создайте файл настроек из образца: cp .env.example .env.

4. Запустите контейнеры: docker compose up -d.

5. Проверьте, что все запустилось: docker compose ps. У каждого контейнера статус «Up» или «healthy», у контейнера init_permissions статус «Exited», так и должно быть.

6. Откройте в браузере http://localhost/install (на сервере http://адрес_сервера/install) и создайте учетную запись администратора. Дальше вход в Dify по адресу http://localhost.

7. Подключите модель: «Integrations» > «Model Provider» (поставщики моделей). Установите поставщика, нажмите «Setup» на его карточке и введите ключ. Без хотя бы одного поставщика приложения Dify не работают.

Чтобы данные не уходили во внешние сервисы, в маркетплейсе Dify есть проверенный плагин Ollama. Он подключает открытые модели, запущенные на вашем компьютере или сервере. В поле «Model Name» укажите модель, в «Base URL» адрес Ollama, доступный из контейнера Dify; ключ для локальной установки не нужен.

Агент и база знаний

Сначала собирают базу знаний, потом агента. Порядок по документации Dify:

1. Откройте «Knowledge» > «Create» > «Create a ready-to-use knowledge base» (готовая база знаний) и загрузите файлы: регламенты, прайс, ответы на частые вопросы.

2. Настройте нарезку на фрагменты («chunk settings»): разделитель и максимальную длину фрагмента. Режим нарезки после создания базы поменять нельзя, разделитель и длину можно.

3. Выберите способ индексации. «High Quality» превращает фрагменты в векторы, то есть в числовые описания смысла, и ищет по смыслу. «Economical» берет 10 ключевых слов на фрагмент, не тратит токены, но ищет менее точно.

4. Дождитесь окончания обработки и проверьте поиск: значок «Retrieval Testing» в левой панели базы. Задайте вопросы, которые зададут клиенты, и посмотрите, какие фрагменты находятся.

5. В разделе «Studio» создайте приложение и выберите тип «Agent».

6. Напишите инструкцию (prompt): кто агент, в каком формате отвечает, чего не делает и в каком случае вызывает каждый инструмент. Инструменты называйте в тексте по именам.

7. Добавьте инструменты Dify и базу знаний. Опишите базу подробно: по описанию модель решает, искать ли в ней ответ на вопрос.

8. В «Agent Settings» задайте «Maximum Iterations»: сколько раз агент может повторить цикл «подумать, вызвать инструмент, прочитать результат» на один запрос. Там же видно режим: «Function Calling», если модель сама умеет вызывать инструменты, или «ReAct», если Dify ведет ее подсказками.

9. Проверьте агента в панели предпросмотра справа и нажмите «Publish». Опубликованное приложение работает как веб-страница, через API или как окно на вашем сайте.

Если в базу знаний или в разговоры попадают данные клиентов, действует 152-ФЗ: сбор и хранение данных граждан России ведутся в базах на территории России, а для передачи за рубеж нужно уведомление в Роскомнадзор. Поэтому Dify с такими данными ставят на сервер в России и берут локальную модель. Как мы это устраиваем, описано на странице о безопасности данных.

Журнал и оценка ответов

Каждое приложение Dify пишет журнал на вкладке «Logs»: что спрашивали, что ответил агент и как ответ оценили. В журнал попадают разговоры из веб-страницы, через API и из списка приложений на главной.

Колонка «User Rate» считает лайки и дизлайки пользователей, «Op. Rate» оценки вашей команды. Откройте разговор и наведите курсор на ответ: видны расход токенов, время ответа и шаги агента с вызовами инструментов. Токен это кусочек текста, за который поставщик модели берет оплату.

Неверный ответ отметьте дизлайком с комментарием или сразу исправьте через аннотацию. Аннотация это одобренный вами ответ: когда новый вопрос похож на сохраненный сильнее заданного порога, Dify возвращает ваш ответ вместо ответа модели.

Аннотации включаются в «Orchestrate» > «Add Features», там же задается порог сходства. Готовые пары «вопрос и ответ» можно загрузить списком по шаблону, а статистика покажет, какие из них срабатывают.

Журнал по умолчанию хранится бессрочно, и в нем полные разговоры. Документация Dify предупреждает об этом прямо: нужна политика обработки данных и согласие пользователей там, где этого требует закон. Очистку старых записей включают переменными окружения, срок хранения по умолчанию 30 дней.

Журнал показывает ошибки после запуска. Как проверить агента до запуска на наборе вопросов, мы разобрали в статье о тестировании агента.

Условия лицензии

Dify распространяется по измененной лицензии Apache 2.0. Сама Apache 2.0 открытая: код можно ставить, менять и использовать в бизнесе. Dify прямо разрешает коммерческое использование, в том числе как основу для ваших сервисов и как платформу разработки внутри компании.

Первое условие: без письменного разрешения Dify нельзя запускать на его коде многопользовательскую среду. Один арендатор (tenant) в терминах лицензии это одно рабочее пространство. Если вы хотите дать нескольким клиентам по своему пространству в одной установке, как в облачном сервисе, нужна коммерческая лицензия.

Второе условие: в интерфейсе Dify нельзя убирать или менять логотип и сведения об авторских правах в консоли и приложениях. Условие не касается случаев, когда вы используете Dify без его интерфейса, например только через API.

Для агента внутри своей компании оба условия обычно не мешают: одно рабочее пространство, логотип на месте. Если агент станет продуктом для ваших клиентов, проверьте схему с юристом до запуска, а не после.

Вопросы и ответы

Сколько стоит Dify для компании?

Код платформы открыт, и лицензия разрешает коммерческое использование, поэтому за саму платформу внутри компании платить не нужно. Расходы складываются из сервера, где по документации нужно не меньше 2 ядер и 4 ГиБ памяти, и из оплаты модели: внешний поставщик берет деньги за токены, а локальная модель через Ollama работает на вашем оборудовании. Коммерческая лицензия понадобится, только если вы дадите нескольким клиентам по своему рабочему пространству в одной установке.

Нужен ли программист, чтобы собрать агента в Dify?

Для самого агента нет: приложение типа «Agent» настраивается формой, где задают модель, инструкцию, инструменты и базу знаний. Специалист нужен на установку через Docker и на подключение ваших систем, например CRM или учетной базы, в качестве инструментов агента. Журнал и аннотации дальше ведет сотрудник, который знает процесс и видит, где агент ошибается.

Можно ли хранить в Dify данные клиентов?

Можно, если соблюдать 152-ФЗ: данные граждан России собирают и хранят в базах на территории России, а до передачи за рубеж подают уведомление в Роскомнадзор. Поэтому платформу с такими данными ставят на сервер в России и подключают локальную модель, чтобы разговоры не уходили внешнему поставщику. Отдельно настройте журнал: по умолчанию он хранит полные разговоры бессрочно, очистку включают переменными окружения.

Чем Dify отличается от Flowise и n8n?

Все три ставят на свой сервер и собирают в них агентов без кода, разница в назначении и лицензии. Dify держит в одном интерфейсе агентов, базу знаний и журнал ответов, а его лицензия Apache 2.0 добавляет два условия: без разрешения нельзя запускать многопользовательскую среду и убирать логотип. Flowise это визуальный конструктор агентов на обычной Apache 2.0, а n8n это платформа автоматизации процессов, лицензия которой запрещает перепродавать n8n как облачный сервис.

Источники и проверка

Проверено редакцией 16 октября 2026.

  1. GitHub, langgenius/dify, LICENSE, 2025 (github.com)
  2. Dify Docs, Deploy Dify with Docker Compose, 2026 (docs.dify.ai)
  3. Dify Docs, Key Concepts, 2026 (docs.dify.ai)
  4. Dify Docs, Agent, 2026 (docs.dify.ai)
  5. Dify Docs, Create a Ready-to-Use Knowledge Base, 2026 (docs.dify.ai)
  6. Dify Marketplace, Ollama, 2026 (marketplace.dify.ai)
  7. Dify Docs, Logs, 2026 (docs.dify.ai)
  8. Dify Docs, Annotation System, 2026 (docs.dify.ai)
  9. arXiv 2005.11401, 22 мая 2020 (arxiv.org)
  10. Brace Law Firm, 9 июля 2023 (brace-lf.com)
  11. Документация Dify: Model Providers, проверено 16 октября 2026 (docs.dify.ai)
  12. Документация Dify: Test Knowledge Retrieval, проверено 16 октября 2026 (docs.dify.ai)
  13. Документация Dify: Integrate Knowledge within Apps, проверено 16 октября 2026 (docs.dify.ai)
  14. Документация Dify: Publish, проверено 16 октября 2026 (docs.dify.ai)
  15. GitHub, FlowiseAI/Flowise, 2026 (github.com)
  16. Wikipedia, n8n, 2026 (en.wikipedia.org)

Нашли ошибку? Напишите нам

Публикации

Как создать чат-бот в Максе: инструкция для компании

Чтобы создать чат-бот в Максе, компании нужно пройти четыре шага на платформе MAX для партнеров: проверить профиль организации через Госуслуги, заполнить карточку бота, дождаться модерации до 48 часов по рабочим дням и собрать сценарий в конструкторе или своим кодом. Ниже каждый шаг по документации MAX, проверенной 16 октября 2026 года, а также как связать бота с сайтом, CRM и командой и на чем бо

ИнструкцияИТСредний11 мин
Написать в Telegram