🚀 Подключение пользовательских моделей CodingPlanX к Dify

В этом руководстве показано, как интегрировать API и модели CodingPlanX в вашу платформу Dify для использования пользовательских возможностей ИИ.

📋 Предварительные требования

Перед началом убедитесь, что у вас есть:

Доступ к Dify: Локальный экземпляр Dify (self-hosted) или учетная запись Dify Cloud.
API-ключ: Действующий API-ключ от платформы CodingPlanX.

⚙️ Шаги конфигурации

Шаг 1: Доступ к настройкам поставщика моделей

Войдите в консоль Dify.
Нажмите на значок профиля в правом верхнем углу и выберите Settings (Настройки).
На левой боковой панели нажмите Model Providers (Поставщики моделей).

Шаг 2: Добавление пользовательской модели

Поскольку CodingPlanX совместим с OpenAI, мы используем поставщика OpenAI-API-compatible.

Прокрутите страницу поставщиков моделей вниз, чтобы найти OpenAI-API-compatible.
Нажмите кнопку Add Model (Добавить модель) на карточке.

Шаг 3: Заполнение параметров конфигурации

Заполните всплывающее окно следующим образом:

Параметр	Значение / Пример	Описание
Model Type (Тип модели)	`LLM`	Выберите тип модели (Большая языковая модель).
Model Name (Имя модели)	например, `gpt-4-turbo` или `claude-3-opus`	Обязательно. Используйте точный идентификатор модели, предоставленный CodingPlanX.
API Key (API-ключ)	`sk-xxxxxxxxxxxxxxxxxxx`	Обязательно. Ваш API-ключ CodingPlanX.
API endpoint URL	`https://api.codingplanx.ai/v1`	Обязательно. (⚠️ Примечание: Должен включать суффикс `/v1`).
Context Length (Длина контекста)	`8192`	Максимальное количество токенов, поддерживаемое моделью.
Max Token Limit (Макс. лимит токенов)	`4096`	Максимальное количество токенов, разрешенное для одного ответа.

> 💡 Полезные советы: > * Относительно URL API: Хотя базовым доменом является https://api.codingplanx.ai, Dify требует полный путь: https://api.codingplanx.ai/v1. > * Относительно имени модели: Если вы не уверены в идентификаторе, сверьтесь с официальной документацией CodingPlanX для получения точной строки идентификатора модели.

Шаг 4: Сохранение и проверка

Нажмите Save (Сохранить) после проверки всех данных.
В случае успеха модель появится в вашем списке поставщиков.

🧪 Тестирование настройки

Перейдите в Studio (Студию) Dify и создайте или откройте приложение (например, Chat Assistant).
В области Model Selection (Выбор модели) в правом верхнем углу нажмите на выпадающий список.
Найдите группу OpenAI-API-compatible и выберите вашу модель CodingPlanX.
Отправьте сообщение в окне отладки. Если ИИ отвечает, все готово! 🎉

❓ Устранение неполадок (FAQ)

В1: Ошибка "Connection failed" или "Invalid API Key" при сохранении?

Проверьте наличие лишних пробелов в API-ключе.
Убедитесь, что URL заканчивается на /v1.
Убедитесь, что ваш сервер имеет доступ к https://api.codingplanx.ai.

В2: Ошибка "Model not found" во время чата?

Введенное Model Name (Имя модели) не существует или у вас нет к нему доступа. Дважды проверьте написание (с учетом регистра).

В3: Ответы обрываются?

Проверьте, не слишком ли низко установлен Max Token Limit. Попробуйте увеличить его до 2048 или 4096.