DeepSeek Harness

В этом руководстве показано, как использовать модели Felo API Platform в open-source проекте DeepSeek Harness. Рекомендуемый способ использует встроенный адаптер deepseek-official. Также можно добавить Felo в Web UI как отдельный custom OpenAI-compatible provider.

DeepSeek Harness пока находится на стадии developer preview и может получать изменения, нарушающие совместимость. Если названия параметров или интерфейс отличаются от этого руководства, проверьте последние release notes upstream-проекта.

Перед началом

Нужны Node.js и один ключ Felo API Platform. Не добавляйте ключ в систему контроля версий.

export FELO_API_KEY="YOUR_API_KEY"

В примерах используется deepseek-v4-flash. Перед выбором другого model ID проверьте раздел Модели и цены.

Рекомендуемая настройка: встроенный адаптер DeepSeek

Встроенный адаптер DeepSeek Harness читает credential из DEEPSEEK_API_KEY, а endpoint — из DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Откройте http://127.0.0.1:3080, затем:

1. Добавьте или выберите workspace проекта.
2. Откройте Настройки → Модели.
3. Выберите provider deepseek-official и модель deepseek-v4-flash.
4. Создайте новую session и отправьте небольшую задачу по repository.

Не добавляйте /chat/completions к Base URL. Встроенный адаптер самостоятельно отправляет запросы на {DEEPSEEK_BASE_URL}/chat/completions.

Постоянные переменные окружения

DeepSeek Harness может читать файл .env из каталога запуска. Чтобы не выполнять export в каждой session, добавьте следующие значения в .env, исключённый из контроля версий:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

Не добавляйте этот файл в commit. Для пользовательской настройки можно также использовать файлы credentials и settings Harness в $DSH_HOME.

Альтернативная настройка: Custom OpenAI-compatible Provider

Используйте этот способ, если Felo должен отображаться как отдельный provider, а встроенное подключение DeepSeek не должно переопределяться.

1. Запустите Web UI командой npx @deepseek-ai/dsh web.
2. Откройте Настройки → Модели.
3. Выберите Добавить custom provider.
4. Введите следующие значения и сохраните provider.

Если обнаружение моделей не работает, добавьте model ID вручную. Действие Получить доступные модели зависит от OpenAI-compatible route GET /models, но для ручной настройки оно не обязательно.

Проверка настройки

Создайте новую session и отправьте:

Суммируй этот repository и назови его основные package.

Настройка готова, если session с выбранной моделью deepseek-v4-flash завершается без ошибок authentication или unknown model.

Для неинтерактивного smoke test рекомендуемого адаптера выполните в целевом workspace:

npx @deepseek-ai/dsh --profile headless "Покажи файлы верхнего уровня в этом workspace."

Примечание о Web Search

Эта настройка направляет через Felo только запросы модели. У встроенного web_search provider в DeepSeek Harness отдельные требования к endpoint, хотя его credential по умолчанию также называется DEEPSEEK_API_KEY. Не направляйте DEEPSEEK_SEARCH_BASE_URL на Felo, если не используете явно совместимый search endpoint. Для поиска Felo отдельно используйте Chat API или соответствующие Felo Skills.

Устранение неполадок

Следующие шаги

• Репозиторий DeepSeek Harness
• Справочник LLM API
• Справочник Chat API
• Felo Skills для AI Agents