@drx974/n8n-nodes-deepseek-fixed
v0.1.3
Published
DeepSeek Chat Model for n8n AI Agent — fixes strict tool-schema rejection and reasoning_content passback
Readme
@drx974/n8n-nodes-deepseek-fixed
Nœud DeepSeek Chat Model "maison" pour l'AI Agent n8n. Corrige les deux bugs documentés qui cassent le Tool Calling avec DeepSeek dans n8n :
Rejet du schéma
strict: DeepSeek renvoie une erreur 400 ("Required properties must match...") quand n8n envoiestrict: truedans la définition JSON Schema des tools. Ce nœud ne transmet jamais ce flag, quel que soit ce que l'AI Agent essaie de passer.reasoning_contentnon renvoyé : en Thinking Mode, DeepSeek exige que lereasoning_contentdu tour précédent soit renvoyé tel quel dès que ce tour contenait des tool_calls, sinon 400 ("The reasoning_content in the thinking mode must be passed back to the API"). Ce nœud stocke ce champ sur chaque message assistant et le réinjecte automatiquement au tour suivant — Thinking Mode reste utilisable même avec des tools.
Par défaut, Thinking Mode est désactivé (le plus sûr avec Tool Calling) ;
vous pouvez l'activer (high / max) si vous voulez le raisonnement
chain-of-thought sur cet agent.
Build
npm install
npm run buildDéploiement recommandé (le plus sûr, évite l'incident déjà rencontré)
Ne PAS faire npm install à la main dans le container n8n (ça duplique les
dépendances et peut casser le chargement des nodes, comme déjà vécu).
Méthode recommandée : publier sur npm puis installer via l'UI n8n
npm login # une fois, avec un compte npm (peut être le vôtre)
npm publish --access publicPuis, dans n8n : Settings → Community Nodes → Install, coller le nom du
package @drx974/n8n-nodes-deepseek-fixed, cocher la case de risque, Install,
puis redémarrer le container n8n (obligatoire pour que le node se charge,
surtout en mode queue).
Si vous préférez ne pas publier publiquement, publiez sous un nom scope privé
(@votre-compte/n8n-nodes-deepseek-fixed) avec un compte npm payant "private
package", ou utilisez un registre npm privé si vous en avez un (Verdaccio,
GitHub Packages, etc.) — le flux d'installation via l'UI reste identique.
Utilisation dans l'AI Agent
- Ajouter le nœud DeepSeek Chat Model (Fixed)
- Credential : coller votre clé API DeepSeek (
DeepSeek Fixed API) - Le connecter à l'entrée "Chat Model" de l'AI Agent
- Laisser Thinking Mode = Disabled pour du Tool Calling simple, ou
passer à
high/maxsi vous voulez le raisonnement — les deux fonctionnent avec les tools. - Connecter vos tools comme d'habitude.
Icône
Logo DeepSeek (icons8 "3D Fluency"), redimensionné en 60×60 PNG conformément aux recommandations n8n, appliqué au nœud et au type de credential. Licence gratuite icons8 = attribution requise (lien vers icons8.com) sauf si vous disposez d'un plan payant sans attribution — à vérifier avant publication publique si ça vous importe.
Limites connues
- Pas de support du streaming token-par-token (
_generateuniquement, pas de_streamResponseChunks) — suffisant pour l'usage AI Agent classique, mais à garder en tête si vous branchez ça sur un chat en streaming. - Testé par compilation TypeScript stricte contre
@langchain/[email protected]et[email protected](versions au 10/07/2026) — à revalider si n8n monte une version majeure différente de LangChain en interne.
