Dify Workflow : Dites adieu au docking fastidieux de l'API, générez du code et des paramètres de requête en un seul clic.

À l'ère numérique, les API (interfaces de programmation d'applications) sont devenues la pierre angulaire de l'interaction entre différents systèmes logiciels. Cependant, les méthodes traditionnelles d'interface API sont souvent inefficaces et frustrantes pour les développeurs.

Avez-vous également été confronté au dilemme suivant :

• Documentation Skybook : La documentation de l'interface est obscure et les descriptions des paramètres sont vagues et confuses.
• Labyrinthe terminologique : La terminologie est infinie et les novices doivent passer beaucoup de temps à consulter des informations pour les comprendre.
• Trous noirs paramétriques : La documentation complexe de l'API comporte de nombreux paramètres et un nombre vertigineux de combinaisons de configuration.
• Duplication du travail : Chaque fois que vous utilisez une nouvelle API, vous devez lire la documentation, écrire du code, déboguer et tester, ce qui prend beaucoup de temps et demande beaucoup de travail.

Ces problèmes réduisent non seulement l'efficacité du développement, mais augmentent également les coûts de R&D des entreprises. Pour résoudre ces problèmes, Dify a lancé un nouveau flux de travail qui vise à utiliser la technologie de l'IA pour simplifier le processus d'arrimage des API et libérer les développeurs d'un travail de documentation fastidieux.

Dify Workflow : l'assistant API intelligent

Dify Les flux de travail sont comme des assistants intelligents qui lisent et comprennent automatiquement la documentation de l'API et la transforment en code et en informations que les développeurs peuvent facilement utiliser. Il s'appuie sur de grands modèles d'IA pour analyser sémantiquement et traiter les documents relatifs aux API.

L'ensemble du processus se déroule comme suit :

1. Extraction de documents : Les flux de travail de Dify prennent en charge plusieurs sources de documentation sur les API :
   • Documentation locale : Prise en charge du téléchargement de documents dans les formats Word, Markdown, PDF et autres.

     

   • Documentation en ligne : Prend en charge la saisie de l'URL d'un document API pour capturer automatiquement le contenu d'une page web.
   • Fichier de définition de l'API : Prise en charge de l'importation directe de fichiers de définition d'API au format Swagger/OpenAPI.
2. Recherche de pages : Pour la documentation en ligne de l'API, Dify intègre l'outil open-source Firecrawl qui convertit le contenu web au format Markdown.

   Site officiel de Firecrawl : https://www.firecrawl.dev/

   

   Les utilisateurs peuvent créer un compte sur le site web de Firecrawl pour obtenir une clé API et installer le plugin approprié dans Dify.

   

   Dify prend en charge l'installation du plugin Firecrawl, tandis que le déploiement localisé est également une option pour ceux qui peuvent se le permettre, étant donné le nombre limité de crédits Firecrawl gratuits.

3. Traitement des modèles d'IA : Soumettre le contenu du document extrait ou le texte Markdown exploré au macromodèle d'IA pour traitement.

   Les flux de travail de Dify prennent en charge une large sélection de modèles d'IA. Les tests ont montré queqwen2.5-coder-32b-instruct Les modèles sont un bon choix pour les principales raisons suivantes :

   1. Fenêtre contextuelle de 128k, suffisante pour gérer la plupart des documents de l'API.
   2. En tant que modèle de code, il est plus apte à gérer les tâches liées à la génération de code.
   3. Toutes les principales plateformes de modélisation sont disponibles pour un accès facile.
   4. Pour les utilisateurs disposant de GPU performants (par exemple, 4090, 5090), le déploiement local est une option pour un traitement plus rapide.
   

   Bien entendu, si vous disposez d'un budget limité, vous pouvez également choisir qwen2.5-coder-7b-instruct Les modèles. Si l'on veut obtenir les meilleurs résultats, ledeepseek-r1 La modélisation est également une bonne option.

4. Compatibilité : Les flux de travail de Dify prennent en charge les principaux systèmes d'exploitation tels que Windows, macOS et Linux, et sont compatibles avec Python, Java, JavaScript, Go et d'autres langages de programmation.

Grâce aux étapes ci-dessus, le flux de travail Dify peut transformer les documents API provenant de différentes sources et de différents formats en données textuelles unifiées qui peuvent être comprises par l'IA, jetant ainsi les bases de la génération ultérieure de code, de l'interrogation de paramètres et d'autres fonctions.

Documentation API pour générer du code : le développement du nombre public de micro-canaux en tant qu'exemple

Prenons ensuite l'exemple du développement du numéro public de WeChat pour montrer comment le flux de travail de Dify peut simplifier le processus d'intégration de l'API.

La première étape du développement de WeChat consiste généralement à obtenir un jeton d'accès.

La documentation officielle de WeChat : https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

Le processus de développement traditionnel se présente généralement comme suit :

1. Lisez la documentation pour trouver l'URL de l'interface et la méthode de requête.
2. Déterminer les paramètres requis pour l'interface.
3. Recherchez dans la documentation les paramètres clés tels que AppID et AppSecret.
4. Écrire le code de test.
5. Exécutez le code et déboguez-le.
6. Si une erreur est rencontrée, retournez à la documentation pour trouver la cause en fonction du code d'erreur.

Avec les flux de travail de Dify, le processus ci-dessus peut être grandement simplifié. Il suffit de saisir l'URL du document API dans l'interface de flux de travail de Dify, de sélectionner un langage de programmation (par exemple, Python) et de cliquer sur Run (Exécuter).

Dify analyse automatiquement l'ensemble du document, interprète la signification exacte des paramètres et des codes d'erreur et génère des exemples de code exécutables.

De plus, Dify donnera directement des conseils dans les commentaires du code généré ou sur l'interface, indiquant aux utilisateurs comment obtenir des paramètres clés tels que l'AppID et l'AppSecret. Par exemple, pour le développement de WeChat public, Dify invitera l'utilisateur à se rendre sur "WeChat public platform's 'Settings and Development - Basic Configuration'" pour l'obtenir.

Les utilisateurs remplissent simplement les "Notes supplémentaires" du flux de travail Dify avec l'AppID et l'AppSecret qu'ils ont obtenus, et sans aucun formatage spécial, ils cliquent sur Exécuter pour générer un code utilisable.

Copiez le code généré dans un IDE tel que PyCharm et exécutez-le pour appeler directement les API, ce qui élimine la nécessité d'écrire manuellement de grandes quantités de code et de procéder à un débogage fastidieux.

Outre la génération de code de test, Dify prend également en charge l'utilisation de cadres de développement ou de bibliothèques spécifiques. Par exemple, dans le cadre du développement Java, vous pouvez utiliser la bibliothèque weixin-java-mp Il s'agit d'une bibliothèque de développement WeChat couramment utilisée. Les utilisateurs n'ont qu'à faire une demande dans Dify, même s'ils ne se souviennent pas du nom complet de la bibliothèque, Dify peut générer le code correspondant.

En outre, Dify prend également en charge la complétion de code. Les utilisateurs peuvent copier des extraits de code existants dans Dify, qui complétera automatiquement le code en fonction du contexte afin d'améliorer l'efficacité du développement.

Documentation de l'API Paramètre Requête

Outre la génération de codes, le flux de travail Dify offre également une puissante fonction d'interrogation des paramètres. Les utilisateurs peuvent poser des questions directement dans le document, par exemple sur la signification d'un paramètre. Cette fonction est très utile, en particulier pour les documents qui utilisent des initiales pinyin comme noms de paramètres.

Dify donnera des explications précises basées sur le contenu de la documentation pour aider les utilisateurs à comprendre rapidement comment utiliser l'API.

Prix et accès

Dify propose des versions gratuites et payantes. La version gratuite comprend des fonctionnalités de base et est suffisante pour les développeurs individuels. La version payante offre des fonctionnalités plus avancées et une assistance technique, et convient aux entreprises. Les utilisateurs peuvent s'inscrire pour un essai gratuit sur le site web de Dify.

Pour découvrir les nouveaux flux de travail de Dify, vous pouvez trouver et importer des fichiers DSL dans le Studio sur la page d'accueil de Dify.

Résumé et perspectives

Le nouveau flux de travail de Dify utilise la technologie de l'IA pour analyser automatiquement les documents de l'API, générer du code et des paramètres de requête, ce qui simplifie considérablement le processus d'ancrage de l'API et améliore l'efficacité du développement. Les débutants comme les développeurs expérimentés peuvent bénéficier du flux de travail de Dify.

À l'avenir, Dify continuera d'optimiser les modèles d'IA afin d'améliorer la précision et la rapidité de l'analyse des documents d'API. Parallèlement, Dify explorera également d'autres scénarios d'application, tels que les tests automatiques d'API, la surveillance des performances des API, etc. Dify se réjouit de travailler avec vous pour explorer une méthode de développement plus intelligente et plus efficace.