> ## Documentation Index
> Fetch the complete documentation index at: https://polza.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify

> Подключите модели Polza.ai к Dify — платформе для создания AI-агентов и автоматизации рабочих процессов.

Dify — платформа с открытым исходным кодом для создания AI-приложений: чат-ботов, агентов и автоматизированных Workflow. Поддерживает подключение любых моделей через OpenAI-совместимый API, что позволяет использовать весь каталог Polza.ai — Claude, Gemini, DeepSeek и другие — прямо из интерфейса Dify.

## Требования

* Аккаунт на [cloud.dify.ai](https://cloud.dify.ai) (или self-hosted инстанс)
* API-ключ Polza.ai — получить на [polza.ai/dashboard](https://polza.ai/dashboard)

## Подключение Polza.ai

### 1. Регистрация и главный раздел

Зайдите на [cloud.dify.ai](https://cloud.dify.ai), создайте аккаунт или войдите в существующий. После входа вы попадёте на главный экран платформы.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/e08808d75b565ce1af6a3a47c90cba6b863cf4f0a851a1c1bd3ba8ec6c4f174c.png" alt="Главный экран Dify после входа" />
</Frame>

### 2. Поставщики моделей

Откройте **Настройки** → **Поставщики моделей**. В списке провайдеров найдите и выберите **OpenAI-API-compatible**.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/0896ea91ac7a54497cbaee05170378ce122e8039814721c49442c89ed8c7ffa4.png" alt="Раздел Поставщики моделей, выбор OpenAI-API-compatible" />
</Frame>

### 3. Добавление модели

Нажмите **Добавить модель** и заполните поля:

| Поле             | Значение                                                    |
| ---------------- | ----------------------------------------------------------- |
| Model Name       | Любое имя, например `claude-sonnet-4.6`                     |
| API Key          | Ваш ключ с [polza.ai/dashboard](https://polza.ai/dashboard) |
| API endpoint URL | `https://polza.ai/api/v1`                                   |

<Note>
  Идентификаторы доступных моделей — на странице [polza.ai/models](https://polza.ai/models). Вы можете добавить несколько моделей, повторив этот шаг.
</Note>

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/fd0312c0f881b3367f9d28f6ec6ee145b00344e495e5c5c394be7e7219bd8fe2.png" alt="Форма добавления модели с заполненными полями" />
</Frame>

### 4. Создание ИИ Агента

Вернитесь на главную и создайте новое приложение, например, **Чатфлоу с ИИ агентом**.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/1b1526ce5968b69f5c6b3c1cf4a3bc516625d4de5d79b88a0b6aca54fa854ab0.png" alt="Создание нового агента в Dify" />
</Frame>

### 5. Workflow

Добавьте нужные блоки — LLM, инструменты, условия — и укажите модель Polza.ai в блоке LLM. Настройте параметры модели.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/4aaa31662ea804fd5e59581964abbc315694420aa8efdb2fe71388f70399a604.png" alt="Редактор Workflow с блоком LLM на базе Polza.ai" />
</Frame>

### 6. Проверка подключения

Откройте **Предпросмотр** и отправьте тестовый запрос. Если в ответе появляется сообщение модели — подключение работает.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/7a0ebbf62a0f7f7d21890edec5c4af753bdb7dd9d2c6b8ba5e71576c88031a6d.png" alt="Предпросмотр с успешным ответом модели" />
</Frame>

## Дальнейшая настройка

Dify предоставляет широкие возможности для кастомизации: системные промпты, инструменты и API-вызовы, RAG-базы знаний, многоэтапные Workflow, публикация в виде веб-приложения или API. Настраивайте сценарий под свои задачи — ограничений по типу использования нет.

## Решение проблем

<AccordionGroup>
  <Accordion title="Модель не отвечает / ошибка при тестировании">
    Проверьте правильность API-ключа и URL (`https://polza.ai/api/v1`). Убедитесь, что в поле **Model Name** указан точный идентификатор модели из [polza.ai/models](https://polza.ai/models).
  </Accordion>

  <Accordion title="Модель не появляется в списке при создании агента">
    После добавления модели обновите страницу. Если модель всё равно не отображается — убедитесь, что сохранили настройки поставщика.
  </Accordion>

  <Accordion title="Ошибка 401 Unauthorized">
    API-ключ недействителен или истёк. Сгенерируйте новый ключ на [polza.ai/dashboard](https://polza.ai/dashboard) и обновите его в настройках поставщика.
  </Accordion>
</AccordionGroup>