# Создаём ИИ-помощника без кода в Dify через РФ шлюз RouterAI В этой статье мы настроим связку Dify (визуальный конструктор AI‑приложений) и RouterAI (единый доступ к топовым моделям). Вы узнаете, как создать чат-бота, агента с инструментами и многоэтапный процесс (workflow) без единой строчки кода. ## 1. Что такое Dify? Dify — конструктор AI‑приложений с открытым кодом. Здесь не нужен код, вы просто перетаскиваете блоки мышкой, настраиваете их, и готовый сервис работает сразу. Ключевые возможности: - **Визуальная оркестрация**: соединяете блоки в удобном интерфейсе, задаете логику работы приложения без кода. - **Поддержка множества моделей**: через единый интерфейс можно подключать нужные модели для разных задач. - **RAG (Retrieval-Augmented Generation)**: вы можете загрузить документы (PDF, Word, Markdown), и Dify автоматически разобьет их на фрагменты, проиндексирует и будет использовать как источник знаний, исключая генерацию недостоверной информации. - **Агенты**: AI-агент в Dify сам решает, какие инструменты (поиск в интернете, чтение файлов, API) вызывать для выполнения задачи. - **Инструменты**: встроенная библиотека: Google Search, Wikipedia, генерация изображений, Yahoo Finance и другие. - **Бэкенд**: Dify предоставляет готовый бэкенд. Публикуете приложение, и оно сразу работает как веб‑чат, iframe для вставки на сайт или API‑эндпоинт. **Удобство использования:** - Менеджеры и аналитики смогут создавать AI‑помощников самостоятельно, без участия разработчиков. - Видны шаги AI и количество потраченных токенов. - Сменить модель можно в пару кликов, не переписывая логику. ## **2. Почему Dify + RouterAI?** Dify сам по себе не содержит моделей, ему нужен доступ к API. Тут появляются стандартные сложности: - Привязавшись к одному API (OpenAI или Anthropic), вы зависите от его условий, способов оплаты и доступности. - **Доступ из РФ**: прямая оплата зарубежных моделей затруднена. - **Разрозненные ключи**: держать отдельные API‑ключи для каждой модели неудобно. > **Решение**: мы используем RouterAI как единый шлюз. Dify подключается к RouterAI по стандарту OpenAI‑совместимого API. В настройках вы указываете одну конкретную модель из каталога RouterAI (например, anthropic/claude-sonnet-5.5), а RouterAI автоматически направляет запрос к соответствующему провайдеру, используя собственные интеграции. Вам не нужно хранить ключи каждого провайдера – достаточно одного ключа RouterAI. **Преимущества**: - Один API‑ключ. - Оплата в рублях, пополнение картой РФ или безналом. - Доступ к разным топовым моделям. - Можно переключать модель в пару кликов. ## 3. RouterAI: единый ключ доступа Чтобы Dify мог работать с моделями, ему нужен API‑ключ от RouterAI. Для этого: 1. Зарегистрируйтесь на [RouterAI](/ "RouterAI"). 2. Пополните баланс (модель Pay‑as‑you‑go – платите только за использованные токены). 3. В разделе  **«Ключи API»** создайте новый ключ. Скопируйте его (начинается с `sk-...`). Он понадобится при настройке. ## **4. Техническая часть: настройка Dify + RouterAI** Ключ от RouterAI готов. Теперь нужно «объяснить» Dify, что работать он будет не с официальным OpenAI, а с нашим шлюзом. **Установка** Проще всего использовать облачную версию Dify. 1. Зарегистрируйтесь в [Dify Cloud](https://cloud.dify.ai/ "Dify Cloud"). 2. Перейдите в **«Поставщики моделей»**. 3. В поиске введите OpenAI-API-compatible. Это тип провайдера, который Dify использует для подключения любых сервисов с API, совместимым с OpenAI. 4. Нажмите  **«Установить».** Теперь этот тип провайдера появится в списке, и вы сможете добавить конкретную модель RouterAI. **![Настройка Dify, добавление модели через OpenAI-совместимый API RouterAI](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/1cff7ef704e2b7480889378b87334693.png)** В карточке установленного провайдера нажмите **«Добавить модель»** и заполните поля: - **Model Name**: Имя модели из списка RouterAI (например, anthropic/claude-sonnet-5.5). Полный список доступен в личном кабинете [RouterAI](/models "RouterAI"). - **Model Type**: LLM - **API Key**: Ключ, созданный в RouterAI. **API Endpoint URL:** *[https://routerai.ru/api/v1](/api/v1 "https://routerai.ru/api/v1")* ![Настройка модели в Dify через RouterAI](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/3c3ad23a9e2fcbc3ab356d7ef9260c14.png) После сохранения модель появится в списке доступных и будет использоваться в приложениях Dify. ## **5. Создание ИИ-агента в Dify** 1. На главной странице Dify нажмите **«Создать с нуля»**, выберите **«Агент»**. 2. Пропишите инструкцию (системный промпт), например:  *«Ты – AI-помощник, доступный через API. Отвечай максимально кратко и по делу. Если задача требует кода – выдавай только сам код без пояснений, если не запрошено обратное. Если ответ должен быть в формате JSON – выдавай валидный JSON без дополнительного текста. Не задавай уточняющих вопросов, не добавляй вступления и выводы. Если не знаешь ответа – ответь одной фразой «Не знаю». Не упоминай, что ты работаешь через RouterAI или Dify, если об этом не спрашивают.».* 1. В настройках агента перейдите в раздел **«Инструменты»** и добавьте нужные (Google Search, Wikipedia, чтение файлов и т.д.). Для некоторых инструментов потребуется отдельный API‑ключ. 2. Настройте **параметры** модели под задачу (рекомендации ниже). **![Интерфейс Dify: отладка агента с системным промптом](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/7c12b5c6f8a5d18de3965c147fde2800.png)** **Настройки параметров модели**

Задача

Temperature

Top P

Frequency Penalty

Max Tokens

Код, точные ответы

0.1–0.3

0.9–1.0

0–0.3

512–1024

Диалог, поддержка

0.5–0.7

0.9–1.0

0.3–0.5

1024–2048

Генерация идей

0.8–1.0

0.95–1.0

0–0.3

1024–2048

Классификация, JSON

0.0–0.2

0.8–0.9

0.5–0.7

256–512
**![Настройки агента Dify, параметры модели: Temperature, Max Tokens](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/c31565b83ea6f9e61bb27f970514b2ef.png)** **Проверка и публикация ИИ-агента в Dify ** - Нажмите **«Отладка»**, чтобы протестировать агента в чате. - При публикации доступно 3 действия: - **«Запустить приложение»**: откроется веб‑чат. - **«Встроить на сайт»**: получите iframe‑код. - **«Доступ к API»**: получите эндпоинт и ключ для вызова из кода (Python, JavaScript и др.). **![еню публикации агента Dify: запуск приложения, встраивание на сайт, доступ к API](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/87c6a0af5e42d3f93758d8c4a97c7a47.png)** **Далее попробуем вызвать Агента Dify в терминале:** - Для агента нужно использовать response\_mode: «*streaming*». - Ответ приходит частями в формате *server‑sent events*. - Последнее сообщение типа *agent\_message* содержит финальный ответ в поле answer. - Поля usage в *message\_end* показывают количество потраченных токенов (полезно для демонстрации контроля расходов). ```bash curl -X POST https://api.dify.ai/v1/chat-messages \ -H "Authorization: Bearer app-xxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "inputs": {}, "query": "Напиши функцию на Python для факториала. Только код, без пояснений.", "response_mode": "streaming", "user": "test-user" }' ``` ## 6. Создание чат‑бота Чат‑бот проще агента, он не использует дополнительные инструменты и не принимает самостоятельных решений. Он генерирует ответ на основе системного промпта и, если подключена база знаний (Knowledge), ищет информацию в загруженных документах. 1. Нажмите **«Создать с нуля»**, выберите **«Чат‑бот»**. 2. В настройках модели укажите ту же модель RouterAI (например, *anthropic/claude-haiku-5.5*). 3. Установите параметры для точных ответов: Temperature 0.2, Max Tokens 512. При необходимости подключите **Контекст** (базу знаний), для этого загрузите документы, по которым бот будет отвечать. **![Создание чат‑бота с нуля без кода в Dify](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/a03c83c54a342d6d7d4d056269c2a521.png)** ## 7. Демонстрация возможностей Workflow в Dify Workflow позволяет выстраивать автономные ИИ-процессы без кода. Разберём пример: определение языка текста и перевод на русский, если нужно. 1. Создайте новый **«Рабочий процесс»**. 2. Добавьте стартовый узел **«Вход пользователя»** с переменной `text`. 3. Добавьте первый узел **LLM**. - **Модель**: оставьте ту же, что использовали ранее. - **Промпт**: *«Определи язык следующего текста. Ответь только названием языка на русском: {{text}}»* 4. Добавьте узел **«ЕСЛИ/ИНАЧЕ»**. - Условие: если язык не равен «русский» – переход в ветку IF, иначе – ELSE. 1. В ветке IF добавьте второй узел LLM. - **Промпт**: *«Переведи следующий текст на русский язык: {{text}}»* 2. Добавьте узел **«Вывод»**, соединив с ним оба варианта (результат перевода или исходный текст). Нажмите **«Отладка»,** введите текст на английском и получите перевод. Если ввести русский текст, вернётся исходный. ![Демонстрация возможностей Workflow в Dify](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/cd203fcfeb7f0f1acfcf75adfba1348f.png) ## 8. Важные нюансы При использовании связки **Dify** и **RouterAI** обратите внимание на несколько моментов: - **Модель имеет значение.** Для сложных рабочих процессов и агентов используйте мощные модели (Claude Sonnet 5.5, GPT‑5.5). Для простых чат‑ботов подойдут более легкие и дешевые варианты. - **Следите за балансом.** В RouterAI расходуется баланс по мере генерации токенов. Регулярно проверяйте остаток в личном кабинете, чтобы агент не перестал отвечать в неожиданный момент. - **Контекст и токены.** Dify автоматически управляет историей, но при длинных диалогах или больших документах расход токенов растёт. При необходимости используйте функцию очистки контекста или ограничивайте длину ответа. - **Переключение моделей в Dify ручное.** RouterAI позволяет использовать любую модель, но в рамках одного чата или workflow автоматически сменить модель нельзя. Если нужно, чтобы разные этапы обрабатывались разными моделями (например, дешевая для классификации, мощная для генерации), используйте несколько узлов LLM в workflow, каждый со своей моделью. - **API-ключи для инструментов.** Некоторые встроенные инструменты Dify (Google Search, Wikipedia, Yahoo Finance) требуют отдельных API-ключей. Перед добавлением инструмента убедитесь, что у вас есть соответствующий ключ, иначе агент не сможет его вызвать. ## 9. Заключение Мы собрали рабочий сетап для быстрого создания AI‑приложений: - **Dify** даёт визуальный конструктор, готовый бэкенд и инструменты для сложной логики. - **RouterAI** обеспечивает доступ к самым современным моделям с удобной оплатой и доступом из РФ. Теперь вы можете собрать чат‑бота по документам, агента с инструментами или приложение через workflow и сразу опубликовать его. Удачной работы с AI!