DeepSeek Harness : démarrage, quatre modes et limites des plugins

Lancez DeepSeek Harness dans un dossier isolé, choisissez Standard, PTC, Minimal ou Creation et contrôlez les permissions des plugins.

DeepSeek Harness est un environnement open source qui assemble un agent à partir de composants remplaçables : modèle, outils, skills, session, sandbox, stockage, agent loop, planification et UI. DeepSeek le présente comme une Developer Preview. Le premier objectif doit donc être une exécution observable dans un dossier isolé, pas un déploiement immédiat dans un dépôt de production.

Si vous connectez un modèle via un API endpoint personnalisé, vérifiez le protocole, le Base URL et l'authentification avant d'installer des plugins. BetterToken.ai fournit des interfaces OpenAI-compatible et Anthropic-compatible aux outils qui acceptent un Base URL personnalisé, mais cela ne prouve pas la compatibilité avec chaque plugin Harness. Consultez le schéma du provider et la configuration de l'API Key dans la documentation BetterToken, puis lancez une petite tâche read-only.

Ce que DeepSeek a publié

Le dépôt officiel est sous licence MIT et repose sur Cordis. Cordis charge et décharge les plugins et gère leurs dépendances ; les capacités de l'agent viennent des plugins. Cette séparation permet de tester le modèle, les outils ou la session sans tout modifier en même temps.

Premier démarrage dans un dossier jetable

Après avoir installé Node.js, lancez la Web UI :

npx @deepseek-ai/dsh web
  1. Créez un dossier vide ou un clone propre, sans secrets ni changements non commités.
  2. Choisissez le mode Standard.
  3. Demandez une petite tâche read-only, par exemple trouver le point d'entrée ou expliquer la structure.
  4. Comparez la réponse aux fichiers et inspectez Trajectory avant d'autoriser les modifications.

L'isolation est une mesure d'ingénierie générale ; elle ne signifie pas que Harness sécurise automatiquement toute commande shell.

Choisir parmi les quatre modes

  • Standard : agent complet avec édition, shell, recherche, skills, plans, objectifs, subagents et workflows. C'est le point de départ normal.
  • PTC : ajoute le Code Mode SDK et permet au modèle de composer plusieurs tool calls dans un programme TypeScript. Vérifiez le programme et chaque frontière d'outil.
  • Minimal : conserve uniquement un bash persistant et str_replace_editor. Il sert d'environnement minimal ou de baseline de benchmark.
  • Creation : ajoute l'inspection du runtime, les expériences de plugins Cordis en mémoire et la création de presets. Utilisez-le pour concevoir votre propre configuration.

PTC ne garantit pas un meilleur résultat ; il rend l'orchestration lisible et reproductible. Minimal est une référence de diagnostic, pas seulement un Standard allégé.

Trajectory comme piste d'audit

Selon DeepSeek, le contexte vu par le modèle et les événements d'exécution sont enregistrés dans un journal de session append-only : system prompts, tool calls et résultats, planification des subagents et injections de contexte. Dans Trajectory, vérifiez les fichiers et sorties réellement vus, les appels inattendus et si l'arrêt vient des permissions, outils, instructions ou du contexte.

Avant d'installer un plugin, notez la capacité qu'il apporte, les données et services auxquels il accède, le signal d'une régression et le chemin de rollback. Lisez le code et les dépendances des plugins communautaires. Consultez de nouveau le quickstart officiel avant d'utiliser des données réelles : des changements incompatibles sont attendus pendant la Developer Preview.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.