Comment utiliser Dify : Un guide pratique pour créer rapidement des applications et des agents d'IA
Si vous avez toujours rêvé de pouvoir créer un chatbot d'IA prêt pour la production, un système de QA à génération augmentée par récupération (RAG), ou un agent automatisé sans avoir à vous débattre avec du code complexe, Dify est fait pour vous. Il combine un concepteur de flux de travail visuel, la gestion des invites, la RAG (génération augmentée par récupération) et les intégrations d'outils en une seule plateforme rationalisée. Dans ce guide pratique et axé sur les solutions, vous apprendrez exactement comment utiliser Dify, de la première connexion au déploiement d'une application d'IA soignée.
Il est important de noter que Dify se positionne comme une plateforme de développement d'IA agentique de premier plan, avec des flux de travail en glisser-déposer et des modèles d'applications qui accélèrent considérablement le délai de rentabilisation. Si vous préférez une présentation pratique, il existe de solides tutoriels pour débutants qui montrent des constructions de bout en bout pour les applications de chat et les assistants basés sur des ensembles de données, ainsi que des guides organisés par la communauté pour maîtriser les blocs principaux tels que les nœuds HTTP et la gestion JSON. Pour une expérience de projet de démonstration structurée, un tutoriel étape par étape est également disponible.
Dans ce guide, nous aborderons :
- Ce qu'est Dify et où il excelle
- La configuration de votre espace de travail et de vos clés
- La création de votre première application (chatbot et assistant RAG)
- Les flux de travail visuels, les outils et les connecteurs
- Les agents et le raisonnement en plusieurs étapes
- L'évaluation, l'observabilité et l'itération
- Les meilleures pratiques de déploiement et les flux de travail d'équipe
Nous y intégrerons également des conseils pratiques, les pièges courants et les schémas permettant de gagner du temps, afin que vous puissiez livrer plus rapidement en toute confiance.
Qu'est-ce que Dify et pourquoi l'utiliser ?
Dify est une plateforme low/no-code pour la composition d'applications d'IA via un canevas visuel, avec orchestration d'invites intégrée, gestion de l'état, RAG et capacités d'agent. Il réduit considérablement le travail de plomberie et vous aide à :
- Créer des chatbots, des assistants et des automatisations en plusieurs étapes
- Implémenter la génération augmentée par récupération (RAG) avec votre propre base de connaissances
- Intégrer des outils (recherche web, API, bases de données) sans code de liaison personnalisé
- Itérer les invites, suivre les performances et observer les traces de bout en bout
Les flux de travail visuels et les modèles d'applications de Dify le rendent particulièrement attrayant pour les équipes qui ont besoin de prototyper rapidement et d'évoluer vers la production. Des tutoriels et des démonstrations tiers peuvent vous aider à passer rapidement de zéro à une application fonctionnelle, et il est souvent utilisé pour les modèles agentiques avec récupération de données. Des intégrations d'observabilité sont également disponibles lorsque vous êtes prêt à évaluer et à mettre à l'échelle.
Démarrage rapide : Compte, modèles et clés
- Créer votre espace de travail Dify
- Inscrivez-vous et créez un nouvel espace de travail.
- Choisissez le cloud (le plus rapide) ou préparez-vous à l'auto-hébergement plus tard si vous avez besoin d'un contrôle total.
- Ajouter des fournisseurs de modèles
- Dans les paramètres, connectez-vous à vos LLM préférés (par exemple, OpenAI, Anthropic, etc.).
- Ajoutez les clés API en toute sécurité. Testez avec de petites invites pour confirmer la connectivité.
- Créer une nouvelle application ou un nouveau flux de travail. Nommez-le clairement (par exemple, "RAG de support client" ou "Agent de qualification des prospects").
- Décidez de votre premier livrable : application de chat, outil interne ou agent.
Conseil : Commencez avec un modèle de base pour une itération rapide, puis remplacez-le par des modèles avancés plus tard.
Créez votre première application de chat en quelques minutes
Voici un moyen simple de créer un assistant de chat utile.
- Démarrer à partir d'un modèle
- Dans la galerie d'applications, choisissez un modèle "Chat". Cela fournit une structure de messagerie prête à l'emploi.
- Rédiger votre invite système
- Définissez le rôle, le ton, les limites et le format de sortie. Exemple :
"Vous êtes un assistant produit concis et amical. Citez toujours vos sources, utilisez des puces pour les étapes et posez une question de clarification si la demande de l'utilisateur est vague."
- Ajouter des exemples de tours (few-shot prompting)
- Montrez des paires de questions-réponses exemplaires pour encourager un comportement cohérent.
- Gardez-les courts et représentatifs.
- Tester de manière interactive
- Utilisez le testeur de chat intégré pour essayer de vraies requêtes.
- Ajustez l'invite système pour le style et la température pour la créativité.
- Définissez les séquences d'arrêt, le nombre maximal de jetons et les filtres de contenu si nécessaire.
- Activez le lien de partage de l'application ou intégrez-le via un widget.
Apprendre en faisant est le plus rapide : les présentations vidéo peuvent vous aider à visualiser chaque clic.
Transformez-le en un assistant RAG (chat basé sur la connaissance)
La RAG permet à votre assistant de répondre avec vos documents privés, FAQ ou contenu wiki.
- Créer un ensemble de données (base de connaissances)
- Téléchargez des PDF, du markdown ou connectez-vous à une source de données.
- Dify va découper, intégrer et indexer votre contenu.
- Ajuster le découpage et les intégrations
- Choisissez le modèle d'intégration et la taille des morceaux. Les morceaux plus grands préservent le contexte ; les morceaux plus petits améliorent la granularité. Commencez avec 400 à 800 jetons.
- Configurer la récupération
- Sélectionnez les meilleurs résultats k (par exemple, 4 à 8), le seuil de pertinence et le reranking optionnel.
- Ajoutez des filtres (par exemple, par balise ou type de document) pour la précision.
- Câbler la récupération dans l'application
- Utilisez le canevas de flux de travail ou le bouton RAG de l'application pour injecter le contexte récupéré dans l'invite. Incluez des citations dans le modèle de réponse finale.
- Tester avec de vraies questions
- Essayez des requêtes faciles et difficiles. Validez les citations, le formatage et la latence.
Si vous utilisez une base de données vectorielle comme Milvus, il existe des présentations étape par étape de l'intégration de Dify pour des pipelines RAG robustes.
Flux de travail visuels : Automatiser la logique en plusieurs étapes
Le canevas de Dify vous permet d'enchaîner les étapes, de ramifier la logique et d'appeler des outils.
Blocs courants :
- Entrée/Sortie : définissez le schéma pour les données utilisateur entrantes et la réponse finale.
- Nœud LLM : créez des invites, définissez des modèles, contrôlez la température.
- Nœud de récupération : interrogez vos ensembles de données.
- Nœud HTTP : appelez des API externes (recherche, CRM, services internes).
- Nœud de code : exécutez des transformations légères, l'analyse ou la validation.
- Condition/Branche : acheminez les chemins en fonction de l'intention de l'utilisateur ou des données.
Exemple : Assistant de recherche Web
- Détecter l'intention → Si "recherche", appeler le nœud HTTP pour la recherche → Résumer les résultats avec un LLM → Renvoyer les résultats sous forme de puces avec les sources.
Pour des instructions concrètes sur le câblage des nœuds HTTP et l'analyse des réponses JSON, les tutoriels de la communauté sont utiles.
Agents : Utilisation d'outils, raisonnement en plusieurs étapes
Les agents de Dify combinent la planification, la sélection d'outils et le raisonnement itératif pour atteindre les objectifs.
Quand utiliser des agents :
- Les tâches nécessitent des plans en plusieurs étapes ("recherche → comparaison → résumé").
- L'assistant doit appeler des outils : recherche web, bases de données, calculatrices, API internes.
- Vous voulez que le modèle décide dynamiquement des prochaines actions.
Créer un agent :
- Définissez l'objectif et les contraintes dans l'invite système.
- Enregistrez les outils (HTTP, recherche, récupération de données, fonctions personnalisées).
- Activez la planification : laissez le modèle proposer des étapes et critiquer son travail.
- Définissez le nombre maximal d'étapes, les délais d'attente et les budgets d'outils.
- Testez avec des tâches variées et surveillez les traces pour diagnostiquer les boucles.
Si votre cas d'utilisation nécessite une récupération précise des données web, vous pouvez associer Dify à des plugins de données spécialisés pour enrichir les capacités de l'agent.
Connecteurs et outils : Intégrez votre pile
Dify s'intègre aux services externes via des connecteurs et des nœuds HTTP :
- Recherche web, scraping ou API de connaissances
- CRM et services d'assistance (par exemple, Salesforce, Zendesk)
- Points de terminaison REST/GraphQL internes
- Magasins de vecteurs et entrepôts de données
Meilleures pratiques :
- Normalisez les réponses en JSON et validez les schémas.
- Gardez les descriptions d'outils concises afin que le modèle sache quand les utiliser.
- Ajoutez des limites de débit et des nouvelles tentatives.
Ingénierie des invites dans Dify
Rendez les invites modulaires et testables :
- Utilisez des variables pour l'entrée utilisateur, le contexte récupéré et les sorties d'outils.
- Normalisez le format de sortie avec JSON ou des listes à puces pour l'analyse en aval.
- Fournissez des rubriques étape par étape (par exemple, "Pensez en étapes numérotées") pour réduire les erreurs.
- Incluez des politiques de refus et des guides de style dans l'invite système.
Boucle d'itération :
- Ajoutez un ensemble de test d'invites représentatives.
- Exécutez des évaluations par lots et comparez les paramètres du modèle.
- Enregistrez les cas d'échec et créez de nouveaux exemples ou branches.
Observabilité, test et optimisation
Lorsque vous passez du prototype au pilote, l'observabilité et le traçage sont importants. Vous pouvez ajouter le traçage pour voir l'utilisation des jetons, les latences et les décisions étape par étape pour déboguer et améliorer la qualité.
Vérifications clés avant le lancement :
- Taux d'hallucination avec et sans RAG
- Budget de latence par requête et par appel d'outil
- Cas extrêmes : entrée vide, entrée longue, requêtes hors sujet
Déploiement auprès des utilisateurs
Dify prend en charge plusieurs chemins de déploiement :
- Partagez une interface utilisateur de chat hébergée pour les tests internes
- Intégrez un widget sur votre site web ou votre produit
- Exposez un point de terminaison API que votre application peut appeler
Conseils opérationnels :
- Ajoutez des analyses : sessions, CSAT, taux de repli
- Mettez en cache les réponses fréquentes et préchargez la récupération
- Définissez des alertes pour les délais d'attente et les erreurs de modèle en amont
Collaboration et gouvernance d'équipe
Au fur et à mesure que votre application se développe :
- Utilisez des contrôles d'accès basés sur les rôles et séparez les environnements de développement/préproduction/production
- Contrôlez les versions des invites/flux de travail ; étiquetez les versions
- Créez un manuel d'exécution pour les incidents et les pannes d'outils
- Documentez les contrats d'outils (entrées/sorties) et les SLA
Modèles avancés à essayer ensuite
- Appel de fonction avec des schémas JSON stricts pour les sorties structurées
- Recherche hybride (BM25 + intégrations) pour un meilleur rappel
- RAG multi-vecteurs (titre, corps, intégrations de métadonnées)
- Reranking pour améliorer la précision des extraits
- Boucles d'auto-réflexion pour les tâches complexes
- Garde-fous avec regex ou validation de schéma JSON
Dépannage : Pièges courants et correctifs
- L'agent boucle ou prend trop de temps
- Réduisez le nombre maximal d'étapes, resserrez les descriptions d'outils, ajoutez des conditions d'arrêt.
- Extraits de récupération non pertinents
- Ajustez le découpage, ajoutez des filtres de métadonnées, essayez le reranking, modifiez le top-k.
- Sorties désordonnées ou incohérentes
- Appliquez le schéma JSON, ajoutez des exemples, réduisez la température.
- Mettez en cache la récupération, parallélisez les appels d'outils, passez à des modèles plus rapides.
- Renforcez les contraintes du système, citez toujours les sources, préférez les étapes de RAG et de vérification.
Au fait : Accélérer les flux de travail de contenu
Si votre objectif est l'idéation, la rédaction et la synthèse de contenu, il est important de noter que les assistants créés avec Dify s'associent bien aux outils de productivité tels que Sider.AI pour l'écriture et la synthèse quotidiennes. Sider peut se trouver à côté de votre navigateur pour vous aider à rédiger, traduire et analyser rapidement le contenu ; lorsqu'il est combiné avec un backend RAG alimenté par Dify, vous obtenez à la fois un contexte de domaine précis et une expérience de création fluide (https://sider.ai/). Points clés à retenir
- Commencez simplement avec un modèle de chat, puis ajoutez des couches de RAG et d'outils.
- Utilisez le canevas de flux de travail pour visualiser la logique et éviter le code fragile.
- Traitez les invites comme du code : contrôlez les versions, testez et évaluez.
- Observez tout (traces, coûts, latences) pour mettre à l'échelle en toute confiance.
- Les agents sont puissants, mais les garde-fous et les budgets les rendent fiables.
Ressources supplémentaires
- Présentation et positionnement de Dify.
- Tutoriel vidéo pour débutants sur la création d'une application d'IA.
- Guide de la communauté sur les nœuds HTTP et la gestion de JSON.
- Tutoriel structuré avec un projet de démonstration.
- Création d'agents avec des plugins de récupération de données web.
- Observabilité et traçage pour les applications Dify.
- Présentation de RAG avec Dify et Milvus.
FAQ
Q1:À quoi sert Dify ?
Dify est une plateforme pour créer des applications et des agents d'IA en utilisant des flux de travail visuels, l'orchestration d'invites et RAG. Il aide les équipes à créer rapidement des chatbots, des assistants de connaissances et des automatisations.
Q2:Comment puis-je créer un chatbot RAG dans Dify ?
Créez un ensemble de données, configurez les intégrations et la récupération, puis injectez le contexte récupéré dans votre invite via le flux de travail. Testez top-k, les tailles des morceaux et le reranking pour optimiser la précision.
Q3:Dify peut-il se connecter à mes API et outils ?
Oui. Utilisez les nœuds et les connecteurs HTTP pour appeler les services web, les bases de données et les API de recherche. Gardez les réponses au format JSON et définissez des descriptions d'outils claires afin que l'agent les utilise correctement.
Q4:Comment puis-je empêcher mon agent de boucler ?
Réduisez le nombre maximal d'étapes, ajoutez des critères d'arrêt et resserrez les instructions des outils. L'observabilité et le traçage aident à identifier où la boucle se produit afin que vous puissiez ajuster les invites et la logique des outils.
Q5:Quelle est la meilleure façon d'évaluer mon flux de travail Dify ?
Créez un ensemble de test, exécutez des évaluations par lots et inspectez les traces pour la latence et le coût. Suivez les hallucinations, appliquez des sorties structurées et itérez les invites avec des exemples.
