DeepSeek Harness

Використовуйте цей посібник, щоб запустити відкритий DeepSeek Harness з моделями, які обслуговує Felo API Platform. Рекомендований шлях повторно використовує вбудований адаптер deepseek-official. Ви також можете додати Felo як окремого власного постачальника, сумісного з OpenAI, у вебінтерфейсі.

DeepSeek Harness наразі є попереднім переглядом для розробників і може вносити зміни, що порушують сумісність. Перевіряйте його примітки до випусків вищого рівня, якщо якийсь параметр або екран відрізняється від цього посібника.

Перш ніж почати

Вам потрібні Node.js і один ключ Felo API Platform. Тримайте ключ поза системою контролю версій.

export FELO_API_KEY="YOUR_API_KEY"

У прикладах використовується deepseek-v4-flash. Перед вибором іншого ID моделі перевірте Моделі та ціни.

Рекомендоване налаштування: вбудований адаптер DeepSeek

DeepSeek Harness читає облікові дані вбудованого адаптера з 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. Додайте або виберіть робочий простір проєкту.
2. Відкрийте Settings → Models.
3. Виберіть постачальника deepseek-official і модель deepseek-v4-flash.
4. Почніть новий сеанс і надішліть невелике завдання для репозиторію.

Не додавайте /chat/completions до базової URL-адреси. Вбудований адаптер сам надсилає запити на {DEEPSEEK_BASE_URL}/chat/completions.

Збереження значень середовища

DeepSeek Harness може читати файл .env із каталогу, у якому ви його запускаєте. Додайте наведені нижче значення до невідстежуваного файлу .env, якщо не хочете експортувати їх для кожного сеансу:

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

Не додавайте цей файл до комітів. Ви також можете використовувати файли облікових даних і налаштувань harness у $DSH_HOME, коли потрібна конфігурація на рівні користувача.

Альтернативне налаштування: власний постачальник, сумісний з OpenAI

Використовуйте цей шлях, коли хочете, щоб Felo з'являвся як окремий постачальник, а не замінював вбудоване з'єднання DeepSeek.

1. Запустіть вебінтерфейс за допомогою npx @deepseek-ai/dsh web.
2. Відкрийте Settings → Models.
3. Виберіть Add custom provider.
4. Введіть наведені нижче значення та збережіть постачальника.

Якщо виявлення моделей не працює, додайте ID моделі вручну. Дія постачальника Get available models залежить від маршруту GET /models, сумісного з OpenAI, і не потрібна для ручного налаштування.

Перевірка налаштування

Почніть новий сеанс і запитайте:

Summarize this repository and identify its main packages.

Налаштування готове, коли сеанс завершується з вибраною deepseek-v4-flash і не з'являється помилка автентифікації чи невідомої моделі.

Для неінтерактивного димового тесту з рекомендованим адаптером виконайте з цільового робочого простору:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Примітка про вебпошук

Це налаштування спрямовує запити до моделей через Felo. Вбудований постачальник web_search у DeepSeek Harness має окремі вимоги до endpoint, хоча його типова змінна облікових даних також DEEPSEEK_API_KEY. Не спрямовуйте DEEPSEEK_SEARCH_BASE_URL на Felo, якщо не використовуєте явно сумісний endpoint пошуку. Використовуйте Chat API Felo або інші Felo Skills окремо, коли вашому робочому процесу потрібен пошук Felo.

Усунення несправностей

Наступні кроки

• Репозиторій DeepSeek Harness
• Довідник LLM API
• Довідник Chat API
• Felo Skills для агентів ШІ