DeepSeek Harness

Tuto příručku použijte ke spuštění open-source nástroje DeepSeek Harness s modely obsluhovanými Felo API Platform. Doporučená cesta znovu používá vestavěný adaptér deepseek-official. Ve webovém rozhraní můžete také přidat Felo jako samostatného vlastního poskytovatele kompatibilního s OpenAI.

DeepSeek Harness je v současnosti developer preview a může zavádět změny, které narušují kompatibilitu. Pokud se některá volba nebo obrazovka liší od této příručky, zkontrolujte poznámky k vydání upstreamu.

Než začnete

Potřebujete Node.js a jeden klíč Felo API Platform. Uchovávejte klíč mimo systém správy verzí.

export FELO_API_KEY="YOUR_API_KEY"

Příklady používají deepseek-v4-flash. Před volbou jiného ID modelu si přečtěte Modely a ceny.

Doporučené nastavení: vestavěný adaptér DeepSeek

DeepSeek Harness čte přihlašovací údaj vestavěného adaptéru z DEEPSEEK_API_KEY a jeho endpoint z 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

Otevřete http://127.0.0.1:3080 a potom:

1. Přidejte nebo vyberte pracovní prostor projektu.
2. Otevřete Settings → Models.
3. Vyberte poskytovatele deepseek-official a model deepseek-v4-flash.
4. Spusťte novou relaci a odešlete malou úlohu nad repozitářem.

Nepřipojujte /chat/completions k základní URL. Vestavěný adaptér sám odesílá požadavky na {DEEPSEEK_BASE_URL}/chat/completions.

Trvalé uložení hodnot prostředí

DeepSeek Harness dokáže číst soubor .env z adresáře, ve kterém jej spustíte. Pokud je nechcete exportovat pro každou relaci, přidejte následující hodnoty do souboru .env, který není sledován verzovacím systémem:

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

Tento soubor necommitujte. Pokud potřebujete uživatelskou konfiguraci, můžete také použít soubory přihlašovacích údajů a nastavení harnessu v $DSH_HOME.

Alternativní nastavení: vlastní poskytovatel kompatibilní s OpenAI

Tuto cestu použijte, když chcete, aby se Felo zobrazoval jako samostatný poskytovatel namísto přepsání vestavěného připojení DeepSeek.

1. Spusťte webové rozhraní pomocí npx @deepseek-ai/dsh web.
2. Otevřete Settings → Models.
3. Zvolte Add custom provider.
4. Zadejte následující hodnoty a poskytovatele uložte.

Pokud zjišťování modelů selže, přidejte ID modelu ručně. Akce poskytovatele Get available models závisí na trase GET /models kompatibilní s OpenAI a pro ruční konfiguraci není nutná.

Ověřte nastavení

Spusťte novou relaci a zeptejte se:

Summarize this repository and identify its main packages.

Nastavení je připraveno, když relace skončí s vybraným deepseek-v4-flash a neobjeví se chyba ověřování ani chyba neznámého modelu.

Pro neinteraktivní rychlý test s doporučeným adaptérem spusťte z cílového pracovního prostoru:

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

Poznámka k webovému vyhledávání

Toto nastavení směruje požadavky na modely přes Felo. Vestavěný poskytovatel web_search v DeepSeek Harness má samostatné požadavky na endpoint, i když jeho výchozí proměnná přihlašovacích údajů je také DEEPSEEK_API_KEY. Nesměrujte DEEPSEEK_SEARCH_BASE_URL na Felo, pokud nepoužíváte výslovně kompatibilní endpoint vyhledávání. Když váš workflow potřebuje vyhledávání Felo, použijte samostatně Chat API Felo nebo jiné Felo Skills.

Řešení problémů

Další kroky

• Repozitář DeepSeek Harness
• Reference LLM API
• Reference Chat API
• Felo Skills pro AI agenty