DeepSeek Harness

Gebruik deze handleiding om de open-source DeepSeek Harness te draaien met modellen die door Felo API Platform worden aangeboden. Het aanbevolen pad gebruikt de ingebouwde adapter deepseek-official van de harness opnieuw. Je kunt Felo ook als aparte, aangepaste OpenAI-compatibele provider toevoegen in de webinterface.

DeepSeek Harness is momenteel een developer preview en kan wijzigingen invoeren die compatibiliteit breken. Raadpleeg de releaseopmerkingen van het upstream-project wanneer een optie of scherm afwijkt van deze handleiding.

Voordat je begint

Je hebt Node.js en één Felo API Platform-sleutel nodig. Houd de sleutel buiten versiebeheer.

export FELO_API_KEY="YOUR_API_KEY"

De voorbeelden gebruiken deepseek-v4-flash. Raadpleeg Modellen en prijzen voordat je een ander model-ID kiest.

Aanbevolen configuratie: ingebouwde DeepSeek-adapter

DeepSeek Harness leest de referentie voor de ingebouwde adapter uit DEEPSEEK_API_KEY en het endpoint uit 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

Open http://127.0.0.1:3080 en doe dan het volgende:

1. Voeg je projectworkspace toe of selecteer die.
2. Open Settings → Models.
3. Selecteer de provider deepseek-official en het model deepseek-v4-flash.
4. Start een nieuwe sessie en stuur een kleine repositorytaak.

Voeg /chat/completions niet toe aan de base-URL. De ingebouwde adapter stuurt verzoeken zelf naar {DEEPSEEK_BASE_URL}/chat/completions.

De omgevingswaarden blijvend opslaan

DeepSeek Harness kan een .env-bestand lezen uit de map waarin je het start. Voeg de volgende waarden toe aan een .env-bestand dat niet wordt gevolgd als je ze niet elke sessie opnieuw wilt exporteren:

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

Commit dit bestand niet. Je kunt ook de referentie- en instellingenbestanden van de harness onder $DSH_HOME gebruiken als je configuratie op gebruikersniveau nodig hebt.

Alternatieve configuratie: eigen OpenAI-compatibele provider

Gebruik dit pad als je wilt dat Felo als aparte provider verschijnt in plaats van de ingebouwde DeepSeek-verbinding te overschrijven.

1. Start de webinterface met npx @deepseek-ai/dsh web.
2. Open Settings → Models.
3. Kies Add custom provider.
4. Voer de volgende waarden in en sla de provider op.

Als modeldetectie mislukt, voeg je het model-ID handmatig toe. De actie Get available models van een provider is afhankelijk van een OpenAI-compatibele route GET /models en is niet nodig voor handmatige configuratie.

De configuratie controleren

Start een nieuwe sessie en vraag:

Summarize this repository and identify its main packages.

De configuratie is klaar wanneer de sessie wordt voltooid met deepseek-v4-flash geselecteerd en er geen authenticatie- of onbekend-model-fout verschijnt.

Voor een niet-interactieve rooktest met de aanbevolen adapter voer je vanuit de doelworkspace uit:

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

Opmerking over webzoekopdrachten

Deze configuratie leidt modelverzoeken via Felo. De ingebouwde provider web_search van DeepSeek Harness stelt aparte eisen aan het endpoint, ook al is de standaardvariabele voor de referentie ook DEEPSEEK_API_KEY. Richt DEEPSEEK_SEARCH_BASE_URL niet op Felo, tenzij je een expliciet compatibel zoekendpoint gebruikt. Gebruik de Chat API van Felo of andere Felo Skills apart wanneer je workflow Felo-zoekopdrachten nodig heeft.

Problemen oplossen

Volgende stappen

• DeepSeek Harness-repository
• LLM API-referentie
• Chat API-referentie
• Felo Skills voor AI-agents