Vue d’ensemble
- Accéder à la configuration des connexions
- Ajouter une nouvelle connexion LLM
- Configurer les informations d’identification et les paramètres de la connexion
- Tester votre connexion
- OpenAI ChatGPT
- Microsoft Foundry
Conditions préalables
- Accès administrateur à la configuration d’ABBYY Vantage.
- Identifiants d’API de votre fournisseur LLM :
- OpenAI : clé d’API de votre compte OpenAI
- Microsoft Foundry : clé d’API, URL complète du point de terminaison (y compris le chemin
/chat/completionset la version de l’API), ainsi que le nom du modèle à partir de Microsoft Foundry dans Azure.
- Abonnement actif auprès de votre fournisseur LLM.
Étape 1 : Accéder aux paramètres de configuration
- Dans l’interface ABBYY Vantage, repérez la section ADMIN dans la barre latérale gauche.
- Cliquez sur Configuration (icône d’engrenage).
- General
- Connections (c’est ici que nous travaillerons)
- Identity Provider
- Public API Client
- Security Log
- Environment Variables
- IP Restrictions
Accédez à l’interface de gestion Connections.
- Dans le menu de gauche Configuration, cliquez sur Connections.
- La liste des connexions existantes (le cas échéant)
- Les détails de la connexion : Name, Description, Used in Skills, Last Updated
- Les boutons de gestion : Add Connection, Test, Edit, Delete
- Une fonction de recherche pour trouver des connexions spécifiques
Étape 3 : Ajouter une nouvelle connexion LLM
- Cliquez sur le bouton + Add Connection en haut de la page Connexions.
- La boîte de dialogue Add Connection s’affiche et présente les fournisseurs LLM disponibles :
- OpenAI ChatGPT - Connexion directe à l’API d’OpenAI
- Microsoft Foundry - OpenAI et autres modèles d’IA hébergés sur l’infrastructure Azure de Microsoft
- Sélectionnez le fournisseur souhaité (pour cet exemple, nous utiliserons Microsoft Foundry).
- Cliquez sur Next.
Étape 4 : Configurer les paramètres de connexion
Paramètres généraux
- Identifiant unique pour cette connexion
- Exemple :
Microsoft FoundryouProduction GPT-4 - Ce nom apparaîtra lors de la sélection des connexions dans les Compétences de document.
- Facultative mais recommandée.
- Fournissez un contexte utile sur la connexion.
- Exemple : “Microsoft Foundry Connection 1” ou “GPT-4 Production API”.
- Important : n’incluez pas d’informations d’identification sensibles dans la description.
Paramètres de connexion
Pour Microsoft Foundry :
- Votre clé API Microsoft Foundry à partir du portail Azure.
- Pour la trouver : Azure Portal → Votre ressource Microsoft Foundry → Keys and Endpoint.
- Format : une longue chaîne alphanumérique.
- Exemple de valeur fictive :
[API Key Here]
- L’URL de votre point de terminaison (endpoint) Microsoft Foundry.
- Pour la trouver : Azure Portal → Votre ressource Microsoft Foundry → Keys and Endpoint.
- Format :
https://[resource].cognitiveservices.azure.com/openai/deployments/[model-name]/chat/completions?api-version=2025-01-01-preview - Exemple :
https://[redacted]resource.cognitiveservices.azure.com/openai/deployments/gpt-4.1-nano/chat/completions?api-version=2025-01-01-preview
- Le nom de votre modèle déployé dans Microsoft Foundry.
- Pour le trouver : Azure Portal → Votre ressource Microsoft Foundry → Deployments.
- Exemple :
gpt-4.1-nano,gpt-35-turbo,gpt-4 - Ce nom doit correspondre exactement à celui de votre déploiement.
Pour OpenAI ChatGPT :
- Votre clé API OpenAI sur platform.openai.com.
- Vous la trouverez ici : OpenAI Platform → API Keys.
- Format : commence par
sk-
- Le modèle spécifique à utiliser (par exemple,
gpt-4,gpt-3.5-turbo)
Étape 5 : Tester votre connexion
- Après avoir saisi toutes les informations requises, cliquez sur le bouton Test.
- Vantage tentera d’établir une connexion avec votre fournisseur LLM en utilisant les identifiants que vous avez fournis.
- Consultez le résultat du test :
- Succès (coche verte) : la connexion fonctionne correctement.
- Échec (X rouge ou message d’erreur) : vérifiez vos identifiants et réessayez.
Résultats du test
- Une coche verte apparaît à côté de votre connexion.
- Vous pouvez maintenant enregistrer la connexion.
- La connexion est prête à être utilisée avec les Compétences de document.
- Consultez le message d’erreur pour identifier les problèmes spécifiques.
- Problèmes courants :
- Clé API incorrecte
- URL de point de terminaison invalide
- Nom du modèle incorrect
- Problèmes de connectivité réseau
- Autorisations ou quota insuffisants
Étape 6 : Enregistrer votre connexion
- Une fois le test réussi, cliquez sur le bouton Add.
- Votre connexion apparaît maintenant dans la liste Connections.
- La connexion est immédiatement disponible pour tous les concepteurs de Skills de votre tenant.
- Connection name : Comme vous l’avez indiqué
- Description : La description que vous avez fournie
- Used in Skills : Indique quelles compétences utilisent cette connexion
- Last Updated : Date et heure actuelles
Gestion des connexions existantes
Modifier une connexion
- Sélectionnez la connexion dans la liste.
- Cliquez sur le bouton Edit (icône en forme de crayon).
- Mettez à jour les champs nécessaires.
- Testez la connexion à nouveau.
- Cliquez sur Save.
Tester une connexion
- Sélectionnez la connexion dans la liste.
- Cliquez sur le bouton Test (icône de rafraîchissement).
- Vérifiez que la connexion est toujours opérationnelle.
- Cette opération est utile pour le dépannage ou la vérification des identifiants.
Supprimer une connexion
- Sélectionnez la connexion dans la liste.
- Cliquez sur le bouton Delete (icône de corbeille).
- Confirmez la suppression.
Résolution des problèmes
Échec du test de connexion
- Clé API invalide :
- Vérifiez que vous avez copié l’intégralité de la clé correctement.
- Vérifiez l’absence d’espaces ou de caractères supplémentaires.
- Générez une nouvelle clé dans le portail de votre fournisseur, si nécessaire.
- URL du point de terminaison invalide :
- Assurez-vous que l’URL est complète et correctement formatée.
- Vérifiez que l’URL correspond à votre ressource Azure.
- Vérifiez qu’il n’y a pas de fautes de frappe dans le chemin de déploiement.
- Nom de modèle incorrect :
- Confirmez que le déploiement existe dans votre portail Azure.
- Vérifiez l’orthographe et la casse (respect de la sensibilité à la casse).
- Vérifiez que le déploiement est actif et disponible.
- Problèmes réseau :
- Vérifiez votre connectivité Internet.
- Vérifiez que les paramètres du pare-feu autorisent les connexions HTTPS sortantes.
- Confirmez que votre instance Vantage peut atteindre le fournisseur LLM.
- Quota ou autorisations :
- Vérifiez que votre abonnement est actif.
- Vérifiez que vous n’avez pas dépassé les limites de débit.
- Assurez-vous que votre clé API dispose des autorisations nécessaires.
La connexion fonctionne dans le test mais échoue dans les Skills
- Actualisez la page Skill Designer.
- Sélectionnez à nouveau la connexion dans la configuration de la compétence.
- Consultez les journaux d’erreurs de la compétence pour y trouver des messages spécifiques.
- Assurez-vous que la compétence est publiée et qu’elle n’est pas en mode brouillon.
Coûts de l’API plus élevés que prévu
- Passez en revue les compétences qui utilisent la connexion.
- Vérifiez le volume et la fréquence de traitement.
- Envisagez de mettre en place une limitation de débit.
- Surveillez l’utilisation via le tableau de bord de votre fournisseur.
- Utilisez des modèles plus économiques pour les tests.
Bonnes pratiques
Sécurité
- Ne partagez jamais les clés d’API dans des e-mails ou des discussions en clair.
- Renouvelez régulièrement les identifiants (tous les 90 jours recommandés).
- Utilisez des connexions distinctes pour le développement et la production.
- Surveillez les journaux d’accès dans le tableau de bord de votre fournisseur LLM.
- Appliquez le principe du moindre privilège – n’accordez que les autorisations nécessaires.
- Stockez des identifiants de secours de manière sécurisée en cas d’urgence.
Gestion des connexions
- Utilisez des noms explicites qui indiquent l’objectif ou l’environnement.
- Exemple : « Production GPT-4 », « Développement Microsoft Foundry »
- À éviter : « Connexion 1 », « Test »
- Précisez dans les descriptions à quoi sert chaque connexion
- À inclure : Environnement, cas d’usage, contact du responsable
- À exclure : Identifiants, informations sensibles
- Testez régulièrement les connexions pour détecter les problèmes le plus tôt possible
- Mettez en place un calendrier de revue mensuelle.
- Testez après toute modification des identifiants.
- Suivez l’utilisation pour savoir quelles connexions sont actives
- Consultez la colonne « Used in Skills ».
- Archivez ou supprimez les connexions inutilisées.
Gestion des coûts
- Choisissez des modèles adaptés pour chaque cas d’usage.
- Utilisez des modèles plus petits et plus rapides pour les tâches simples.
- Réservez les modèles avancés pour les opérations d’extraction complexes.
- Mettez en place une limitation du débit (rate limiting) si votre fournisseur la prend en charge.
- Évite les pics de coûts inattendus.
- Protège contre les traitements incontrôlés.
- Surveillez les tendances d’utilisation
- Configurez des alertes de facturation dans le tableau de bord de votre fournisseur.
- Examinez chaque mois les coûts et l’utilisation.
- Optimisez les prompts dans vos Compétences de document.
- Des prompts efficaces réduisent l’utilisation de jetons.
- Testez et affinez pour obtenir les meilleurs résultats au moindre coût.
Optimisation du flux de travail
- Regroupez les types de documents similaires
- Configurez des Compétences de document appropriées pour votre cas d’usage
- Testez avec des documents d’exemple avant la mise en production
- Documentez votre flux de travail comme référence pour l’équipe
Comprendre les types de connexion
OpenAI ChatGPT
- Accès direct aux derniers modèles OpenAI
- Configuration simple avec une simple clé d’API
- Organisations utilisant déjà la plateforme OpenAI
- Les données sont traitées par l’infrastructure d’OpenAI
- Régie par les conditions d’utilisation et les politiques de données d’OpenAI
- Nécessite un compte OpenAI et un accès à l’API
Microsoft Foundry
- Les déploiements d’entreprise avec une infrastructure Azure
- Les organisations nécessitant des contrôles de résidence des données
- L’intégration avec d’autres services Azure
- Des fonctionnalités de sécurité et de conformité renforcées
- L’accès à OpenAI et à d’autres modèles d’IA via Azure
- Les organisations disposant déjà d’un abonnement Azure
- Nécessite un abonnement Azure et la configuration de Microsoft Foundry
- Davantage de paramètres de configuration (URL de point de terminaison avec chemin complet, nom du modèle, version de l’API)
- Les modèles disponibles peuvent différer de ceux d’OpenAI en accès direct
- L’URL doit inclure le chemin complet :
/openai/deployments/[model-name]/chat/completions?api-version=... - Peut offrir des capacités spécialisées et l’hébergement de modèles personnalisés
Ressources supplémentaires
- Documentation de l’API OpenAI : https://platform.openai.com/docs
- Microsoft Foundry : https://azure.microsoft.com/products/ai-foundry
- Documentation des services Azure AI : https://learn.microsoft.com/azure/ai-services/
- Assistance : contactez l’assistance ABBYY pour obtenir une aide technique
Résumé
- ✅ Accéder aux paramètres de configuration
- ✅ Accéder à la gestion des connexions
- ✅ Ajouter une nouvelle connexion LLM
- ✅ Configurer les informations d’identification et les paramètres de la connexion
- ✅ Tester votre connexion
- ✅ Découvrir comment gérer les connexions