DeepSeek Harness

Utilisez ce guide pour exécuter le DeepSeek Harness open source avec des modèles servis par Felo API Platform. La voie recommandée réutilise l'adaptateur intégré deepseek-official du harness. Vous pouvez aussi ajouter Felo comme fournisseur personnalisé séparé compatible OpenAI dans l'interface web.

DeepSeek Harness est actuellement en aperçu développeur et peut introduire des changements qui cassent la compatibilité. Consultez ses notes de version upstream lorsqu'une option ou un écran diffère de ce guide.

Avant de commencer

Vous avez besoin de Node.js et d'une clé Felo API Platform. Gardez la clé hors du contrôle de source.

export FELO_API_KEY="YOUR_API_KEY"

Les exemples utilisent deepseek-v4-flash. Consultez Modèles et tarifs avant de choisir un autre ID de modèle.

Configuration recommandée : adaptateur DeepSeek intégré

DeepSeek Harness lit les identifiants de l'adaptateur intégré dans DEEPSEEK_API_KEY et son endpoint dans 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

Ouvrez http://127.0.0.1:3080, puis :

1. Ajoutez ou sélectionnez l'espace de travail de votre projet.
2. Ouvrez Settings → Models.
3. Sélectionnez le fournisseur deepseek-official et le modèle deepseek-v4-flash.
4. Démarrez une nouvelle session et envoyez une petite tâche sur le dépôt.

N'ajoutez pas /chat/completions à l'URL de base. L'adaptateur intégré envoie lui-même les requêtes à {DEEPSEEK_BASE_URL}/chat/completions.

Persister les valeurs d'environnement

DeepSeek Harness peut lire un fichier .env dans le répertoire depuis lequel vous le lancez. Ajoutez les valeurs suivantes à un fichier .env non suivi si vous ne voulez pas les exporter à chaque session :

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

Ne commitez pas ce fichier. Vous pouvez aussi utiliser les fichiers d'identifiants et de paramètres du harness sous $DSH_HOME lorsque vous avez besoin d'une configuration au niveau utilisateur.

Configuration alternative : fournisseur personnalisé compatible OpenAI

Utilisez cette voie lorsque vous voulez que Felo apparaisse comme un fournisseur séparé au lieu de remplacer la connexion DeepSeek intégrée.

1. Lancez l'interface web avec npx @deepseek-ai/dsh web.
2. Ouvrez Settings → Models.
3. Choisissez Add custom provider.
4. Saisissez les valeurs suivantes et enregistrez le fournisseur.

Si la découverte de modèles échoue, ajoutez l'ID de modèle manuellement. L'action Get available models d'un fournisseur dépend d'une route GET /models compatible OpenAI et n'est pas requise pour une configuration manuelle.

Vérifier la configuration

Démarrez une nouvelle session et demandez :

Summarize this repository and identify its main packages.

La configuration est prête lorsque la session se termine avec deepseek-v4-flash sélectionné et qu'aucune erreur d'authentification ou de modèle inconnu n'apparaît.

Pour un test de fumée non interactif avec l'adaptateur recommandé, exécutez depuis l'espace de travail cible :

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

Remarque sur la recherche web

Cette configuration achemine les requêtes de modèles via Felo. Le fournisseur web_search intégré de DeepSeek Harness a des exigences d'endpoint distinctes, même si sa variable d'identifiant par défaut est aussi DEEPSEEK_API_KEY. Ne pointez pas DEEPSEEK_SEARCH_BASE_URL vers Felo, sauf si vous utilisez un endpoint de recherche explicitement compatible. Utilisez séparément le Chat API de Felo ou d'autres Felo Skills lorsque votre workflow a besoin de la recherche Felo.

Dépannage

Étapes suivantes

• Dépôt DeepSeek Harness
• Référence du LLM API
• Référence du Chat API
• Felo Skills pour agents IA