DeepSeek Harness

Usa questa guida per eseguire l'open source DeepSeek Harness con i modelli serviti da Felo API Platform. Il percorso consigliato riutilizza l'adattatore integrato deepseek-official dell'harness. Puoi anche aggiungere Felo come provider personalizzato separato compatibile con OpenAI nella Web UI.

DeepSeek Harness è attualmente una developer preview e può introdurre modifiche che rompono la compatibilità. Controlla le note di rilascio upstream quando un'opzione o una schermata differisce da questa guida.

Prima di iniziare

Ti servono Node.js e una chiave di Felo API Platform. Tieni la chiave fuori dal controllo del codice sorgente.

export FELO_API_KEY="YOUR_API_KEY"

Gli esempi usano deepseek-v4-flash. Controlla Modelli e prezzi prima di scegliere un ID modello diverso.

Configurazione consigliata: adattatore DeepSeek integrato

DeepSeek Harness legge la credenziale dell'adattatore integrato da DEEPSEEK_API_KEY e il suo endpoint da 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

Apri http://127.0.0.1:3080, poi:

1. Aggiungi o seleziona l'area di lavoro del tuo progetto.
2. Apri Settings → Models.
3. Seleziona il provider deepseek-official e il modello deepseek-v4-flash.
4. Avvia una nuova sessione e invia una piccola attività sul repository.

Non aggiungere /chat/completions all'URL di base. L'adattatore integrato invia le richieste a {DEEPSEEK_BASE_URL}/chat/completions.

Rendere persistenti i valori delle variabili d'ambiente

DeepSeek Harness può leggere un file .env dalla directory in cui lo avvii. Aggiungi i seguenti valori a un file .env non tracciato se non vuoi esportarli a ogni sessione:

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

Non committare questo file. Puoi anche usare i file delle credenziali e delle impostazioni dell'harness in $DSH_HOME quando ti serve una configurazione a livello utente.

Configurazione alternativa: provider personalizzato compatibile con OpenAI

Segui questo percorso quando vuoi che Felo compaia come provider separato invece di sovrascrivere la connessione DeepSeek integrata.

1. Avvia la Web UI con npx @deepseek-ai/dsh web.
2. Apri Settings → Models.
3. Scegli Add custom provider.
4. Inserisci i seguenti valori e salva il provider.

Se la scoperta dei modelli non funziona, aggiungi manualmente l'ID del modello. L'azione Get available models di un provider dipende da una route GET /models compatibile con OpenAI e non è necessaria per la configurazione manuale.

Verificare la configurazione

Avvia una nuova sessione e chiedi:

Summarize this repository and identify its main packages.

La configurazione è pronta quando la sessione termina con deepseek-v4-flash selezionato e non compare alcun errore di autenticazione o di modello sconosciuto.

Per un rapido test non interattivo con l'adattatore consigliato, esegui dall'area di lavoro di destinazione:

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

Nota sulla ricerca web

Questa configurazione instrada le richieste dei modelli attraverso Felo. Il provider web_search integrato di DeepSeek Harness ha requisiti di endpoint separati, anche se la sua variabile delle credenziali predefinita è anch'essa DEEPSEEK_API_KEY. Non puntare DEEPSEEK_SEARCH_BASE_URL a Felo se non stai usando un endpoint di ricerca esplicitamente compatibile. Usa separatamente la Chat API di Felo o altre Felo Skills quando il tuo workflow ha bisogno della ricerca Felo.

Risoluzione dei problemi

Passi successivi

• Repository DeepSeek Harness
• Riferimento LLM API
• Riferimento Chat API
• Felo Skills per agenti IA