Objectif de ce wiki

L'objectif de ce document est de formaliser la méthode permettant d'utiliser un agent spécialisé Swiftask comme "cerveau" (LLM) unique au sein d'un nœud AI Agent de n8n, en remplacement des requêtes HTTP GraphQL traditionnelles.

Cette architecture permet de bénéficier de la puissance native des agents n8n (gestion automatisée de la mémoire, orchestration d'outils/tools) tout en déléguant l'intelligence au modèle Swiftask.
La documentation associée se trouve ici : Documentation Swiftask.

Prérequis

Avant de débuter la configuration, assurez-vous de disposer des éléments suivants :

  • Un accès à l'instance n8n (v2.21.7 ou ultérieure)
  • Un compte Swiftask avec un agent déjà configuré
  • La Clé API Swiftask (disponible dans Paramètre du compte -> API)
  • Le Slug de l'agent ou son ID technique

Le slug de l’agent peut se trouver ici dans Swiftask :

Intégration d’un agent IA Swiftask dans n8n

Réalisation du workflow

Vision finale du workflow :

Intégration d’un agent IA Swiftask dans n8n

Étape 1 : Création de la structure globale

  1. Dans l'éditeur de workflow n8n, déposez un nœud AI Agent
  2. Ajoutez un nœud LangChain Code sur l'espace de travail
  3. Connectez le point jaune/orange (AI Chat Model) situé en haut à droite du nœud LangChain Code vers l'entrée Model (point orange inférieur) du nœud AI Agent

Pour pouvoir réaliser l’étape 3, il faut ajouter au moins l’output “Language Model” dans le node “LangChain Code” :

Intégration d’un agent IA Swiftask dans n8n

La sortie Main ne nous sera pas utile mais est indispensable tout de même. Par contre, l’ajout de l’output “Language Model” permet alors la connexion vers le node AI Agent précédent.

Étape 2 : Configuration du node LangChain Code

Dans la partie Code, deux éléments sont ajoutés :

Supply Data :

let ChatOpenAI;

try {
ChatOpenAI = require('@langchain/openai').ChatOpenAI;
} catch (e) {
ChatOpenAI = require('chain/chat_models/openai').ChatOpenAI;
}

const chatModel = new ChatOpenAI({
apiKey: "VOTRE_CLEF_API",
openAIApiKey: "VOTRE_CLEF_API",
model: "L ID SLUG",
modelName: "L ID SLUG",
configuration: {
baseURL: "https://api.swiftask.fr/v1"
}
});

return chatModel;.s

Puis Execute :

return [{ json: { status: "ok" } }];

Exécution du traitement

Ici, nous avons un traitement qui se lance manuellement (à des fins de tests) mais cela permet de vérifier que tout est bien fonctionnel et que l’agent Swiftask a bien été sollicité :

Intégration d’un agent IA Swiftask dans n8n

Conclusion

Grâce à cette approche hybride, le workflow s'affranchit des requêtes HTTP brutes et s'intègre nativement dans l'écosystème Advanced AI de n8n. L'utilisation du SDK OpenAI sous-jacent via le nœud LangChain Code permet de bénéficier de toutes les fonctionnalités avancées de n8n de manière standardisée.

Cette architecture est hautement évolutive : toute modification des champs de sortie ou du comportement de l'IA se gère directement depuis la plateforme Swiftask, sans nécessiter de maintenance ou de re-mapping dans n8n.

Faites confiance aux experts Data & IA de Next Decision, rendez-vous sur la page Contact