Utiliser OneAster dans Dify

​

Prérequis

1. Compte Dify enregistré Visitez le site officiel de Dify pour enregistrer un compte, choisissez la version cloud ou auto-hébergée
2. Clé API OneAster obtenue Connectez-vous à la console OneAster pour obtenir votre clé API (commence par sk-)

​

Étape 1 : Se connecter à Dify et accéder aux paramètres

​

1.1 Accéder à la plateforme Dify

• Version cloud : visitez https://cloud.dify.ai et connectez-vous
• Version auto-hébergée : visitez l’adresse de votre déploiement Dify

​

1.2 Accéder aux paramètres de modèle

1. Cliquez sur l’icône d’avatar en haut à droite
2. Sélectionnez Settings
3. Choisissez Model Provider dans le menu de gauche

​

Étape 2 : Ajouter le fournisseur de modèles OneAster

​

2.1 Sélectionner la méthode de configuration

​

Méthode 1 : utiliser OpenAI Custom API (recommandée)

1. Trouvez le fournisseur OpenAI sur la page Model Provider
2. Cliquez sur le bouton Configure ou Settings
3. Sur la page de configuration :
   • API Key : saisissez votre clé API OneAster (sk-xxxxxxxxxxxx)
   • API Base URL ou Base URL : saisissez https://api.oneaster.ai/v1
4. Cliquez sur Save

5. Après la configuration, revenez à la page du fournisseur OpenAI et consultez la Model List
6. Dans la liste des modèles, trouvez les modèles dont vous avez besoin (par ex. gpt-4o, gpt-4o-mini, chatgpt-4o-latest, etc.)
7. Cliquez sur le commutateur à droite du modèle pour l’activer (bleu indique activé)

​

Méthode 2 : ajouter un fournisseur de modèle personnalisé

1. Faites défiler vers le bas jusqu’à la section Custom Model
2. Cliquez sur le bouton + Add Model

​

2.2 Configurer le fournisseur OneAster

​

2.3 Ajouter plus de modèles (optionnel)

1. Dans la section des modèles personnalisés, cliquez à nouveau sur + Add Model
2. Remplissez les informations de configuration pour un autre modèle
3. Cliquez sur Save

​

Série GPT-4/5

​

Série Claude

​

Série Gemini

​

Étape 3 : Utiliser les modèles OneAster dans les applications

​

3.1 Créer une nouvelle application

1. Revenez à la page d’accueil de Dify
2. Cliquez sur le bouton Create App
3. Sélectionnez le type d’application :
   • Chatbot — application conversationnelle
   • Text Generator — application de génération de texte
   • Agent — agent intelligent
   • Workflow — application de workflow complexe

​

3.2 Sélectionner le modèle OneAster

1. Trouvez la zone Model Settings
2. Cliquez sur le menu déroulant Select Model
3. Sélectionnez le fournisseur OneAster
4. Choisissez votre modèle configuré (par ex. gpt-4o)

​

3.3 Configurer les paramètres du modèle

​

Étape 4 : Construire et tester l’application

​

4.1 Ajouter des prompts

1. Écrivez les prompts dans la zone System Prompt
2. Utilisez des variables pour rendre votre app dynamique :
   • {{variable_name}} — variable d’entrée utilisateur
   • {{context}} — contexte de la base de connaissances

You are a professional customer service assistant, skilled at answering product questions.

Product Information: {{product_info}}

Please provide accurate and friendly answers based on user questions. If unsure, honestly inform the user.

User Question: {{user_question}}

​

4.2 Ajouter une base de connaissances (optionnel)

1. Cliquez sur Knowledge Base dans le menu de gauche
2. Créez une nouvelle base de connaissances et téléversez des documents
3. Liez la base de connaissances sur la page d’orchestration de l’application
4. Configurez les paramètres de recherche

​

4.3 Tester l’application

1. Saisissez des questions de test dans le panneau Preview à droite
2. Examinez l’efficacité de la réponse de l’IA
3. Ajustez les prompts et les paramètres selon les besoins
4. Répétez le test jusqu’à satisfaction

​

4.4 Publier l’application

1. Cliquez sur le bouton Publish en haut à droite
2. Sélectionnez la méthode de publication :
   • API Call — intégration via API
   • Embed in Website — générer le code d’intégration
   • Public Link — générer un lien de partage

​

Étape 5 : Surveiller et optimiser

​

5.1 Consulter les journaux de l’application

1. Cliquez sur l’onglet Logs
2. Consultez tous les enregistrements de conversation
3. Analysez les questions utilisateur et les réponses de l’IA
4. Découvrez les opportunités d’amélioration

​

5.2 Surveiller l’utilisation de l’API

• 📊 Statistiques d’appels API — total des appels, taux de succès
• 💰 Détails des coûts — coûts journaliers/mensuels
• 📈 Tendances d’utilisation — tendances de changement
• 🔍 Journaux des requêtes — enregistrements détaillés des requêtes

​

5.3 Optimiser les performances de l’application

1. Ajuster la sélection du modèle
   • Utilisez gpt-4o-mini pour les tâches simples afin de réduire les coûts
   • Utilisez gpt-4o ou claude-sonnet-4-5 pour les tâches complexes afin d’améliorer la qualité
2. Optimiser les prompts
   • Rendre les prompts plus clairs et spécifiques
   • Ajouter des exemples pour améliorer l’efficacité
   • Utiliser chain-of-thought pour un meilleur raisonnement
3. Configurer la mise en cache
   • Activer la mise en cache pour les questions similaires
   • Réduire les coûts d’appel API

​

Fonctionnalités avancées

​

Utiliser l’orchestration de workflow

1. Branches conditionnelles — exécuter une logique différente selon les conditions
2. Collaboration multi-modèles — combiner les avantages de plusieurs modèles
3. Appels d’outils externes — appeler des API, bases de données et autres ressources externes
4. Passage de variables — passer des données entre différents nœuds

​

Configurer les capacités d’agent

1. Appel d’outils — laisser l’IA appeler des outils externes
2. Gestion de la mémoire — maintenir une mémoire de conversation à long terme
3. Prise de décision autonome — l’IA planifie de manière autonome les étapes d’exécution

​

Applications multimodales

1. Compréhension d’images — utilisez gpt-4o ou claude-3 pour traiter les images
2. Génération d’images — intégrez l’API de génération d’images d’OneAster
3. Traitement vocal — intégrez les services TTS et STT

​

FAQ

​

Q1 : Impossible de se connecter au service OneAster ?

1. Vérifier la Base URL :
   • Assurez-vous qu’il s’agit de https://api.oneaster.ai/v1 (inclut /v1)
   • N’ajoutez pas de chemins supplémentaires et n’omettez pas /v1
2. Vérifier la clé API :
   • Confirmez que la clé API commence par sk-
   • Vérifiez si la clé est valide dans la console OneAster
3. Vérifier la connexion réseau :
   • Assurez-vous que le serveur peut accéder à https://api.oneaster.ai
   • Les versions auto-hébergées doivent assurer la connectivité réseau du serveur

​

Q2 : La réponse du modèle est lente ?

1. Passer à des modèles plus rapides :
   • Utilisez gpt-4o-mini au lieu de gpt-4o
   • Utilisez gemini-2.0-flash-exp pour une réponse plus rapide
2. Optimiser la longueur des prompts :
   • Réduisez le contexte inutile
   • Simplifiez les descriptions des prompts
3. Ajuster la recherche dans la base de connaissances :
   • Réduisez le nombre de documents récupérés
   • Augmentez le seuil de similarité

​

Q3 : Les appels API échouent ou renvoient des erreurs ?

​

Q4 : Comment réduire les coûts d’utilisation de l’API ?

1. Sélection du modèle :
   • Utilisez gpt-4o-mini pour les tâches simples (le coût n’est que 1/10 de gpt-4o)
   • Envisagez des modèles plus économiques pour les tâches par lots
2. Activer la mise en cache :
   • Retournez les résultats en cache pour les mêmes questions
   • Configurez la correspondance par similarité dans Dify
3. Optimiser la longueur de sortie :
   • Définissez des Max Tokens raisonnables
   • Évitez de générer des réponses trop longues
4. Utiliser la sortie en streaming :
   • Améliore l’expérience utilisateur sans augmenter les coûts

​

Q5 : Comment gérer les données sensibles ?

1. Utiliser des variables d’environnement :
   • Ne codez pas en dur les clés API dans le code
   • Utilisez la fonctionnalité de variables d’environnement de Dify
2. Configurer le contrôle d’accès :
   • Définissez les permissions d’accès à l’application
   • Activez l’authentification pour les appels API
3. Journaux d’audit :
   • Vérifiez régulièrement les journaux de l’application
   • Surveillez les modèles d’accès anormaux

​

Bonnes pratiques

​

1. Ingénierie de prompts

# Role Definition
You are a professional [role description]

# Task Objective
You need to help users [task description]

# Output Requirements
- Requirement 1
- Requirement 2
- Requirement 3

# Input Information
{{user_input}}

​

2. Gestion de la base de connaissances

• Stratégie de découpage : définir une taille de chunk de document raisonnable (recommandé 500-1000 caractères)
• Étiquetage de métadonnées : ajouter des métadonnées aux documents pour faciliter la recherche
• Mises à jour régulières : maintenir le contenu de la base de connaissances à jour

​

3. Gestion des erreurs

• Messages conviviaux : fournir des messages d’erreur clairs aux utilisateurs
• Stratégie de repli : basculer vers un modèle de secours en cas d’échec du principal
• Mécanisme de nouvelle tentative : nouvelle tentative automatique pour les erreurs temporaires

​

4. Surveillance des performances

• Définir des alertes : alertes pour solde faible, taux d’erreur élevés
• Analyse régulière : analyser les données d’utilisation hebdomadairement/mensuellement
• Optimisation continue : ajuster la configuration sur la base des données

​

Exemples de cas d’utilisation

​

1. Service client intelligent

• Modèle : gpt-4o-mini (économique)
• Base de connaissances : documents produit, FAQ
• Fonctionnalités : réponse automatique aux questions courantes, escalade des problèmes complexes vers l’humain

​

2. Assistant de création de contenu

• Modèle : gpt-4o ou claude-sonnet-4-5 (haute qualité)
• Fonctionnalités : génération d’articles, réécriture, polissage
• Paramètres : Temperature=0,8 (renforce la créativité)

​

3. Assistant de code

• Modèle : claude-sonnet-4-5 (excellent pour le code)
• Fonctionnalités : génération, explication, débogage de code
• Base de connaissances : docs du projet, docs API

​

4. Assistant d’analyse de données

• Modèle : gpt-4o (forte capacité de raisonnement)
• Outils : exécution de code Python, visualisation de données
• Fonctionnalités : analyse de données, génération de rapports

​

Fonctionnalités

• 🤖 Construire rapidement des apps IA — créer de puissantes applications IA sans codage
• 📚 Enrichissement par base de connaissances — la technologie RAG laisse l’IA répondre sur la base de vos données
• 🔧 Workflows flexibles — orchestrer visuellement la logique IA complexe
• 🎯 Gestion précise des prompts — contrôle de version et tests A/B
• 📊 Surveillance et analyses complètes — comprendre l’utilisation et la performance de l’app
• 🔌 Plusieurs méthodes d’intégration — API, intégré, WebApp et plus
• 👥 Collaboration d’équipe — support du développement multi-utilisateur
• 🌐 Support multi-modèles — basculer de manière flexible entre différents modèles d’IA

​

Support et aide

• 📚 Documentation OneAster
• 📚 Documentation officielle Dify
• 💬 Communauté Discord
• 🐦 Twitter @oneaster_
• 📧 Support technique : [email protected]