Vue d’ensemble
- Accéder à la configuration des connexions
- Ajouter une nouvelle connexion LLM
- Configurer les identifiants et les paramètres de connexion
- Tester votre connexion
Les connexions LLM ne peuvent actuellement être utilisées dans les Compétences de document que via ABBYY Advanced Designer.
Prérequis
- d’un accès administrateur à ABBYY Vantage Configuration.
- des identifiants API de votre fournisseur LLM de votre choix :
- OpenAI : clé API de votre compte OpenAI
- Microsoft Foundry : clé API, URL complète du point de terminaison (y compris le chemin
/chat/completionset la version de l’API), et nom du modèle dans Microsoft Foundry sur Azure. - Google AI Studio : clé API de votre compte Google AI Studio
- d’un abonnement actif auprès de votre fournisseur LLM.
Les connexions LLM sont gérées au niveau du tenant et peuvent être utilisées par tous les concepteurs de compétences de votre organisation. Actuellement, les connexions LLM ne peuvent être intégrées aux Compétences de document que via ABBYY Advanced Designer.
É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).
- Général
- Connexions (c’est ici que nous travaillerons)
- Fournisseur d’identité
- Client d’API public
- Journal de sécurité
- Variables d’environnement
- Restrictions d’accès par IP
Accédez à l’interface de gestion des connexions.
- Dans le menu de gauche Configuration, cliquez sur connexion.
- La liste des connexions existantes (le cas échéant)
- Les détails de la connexion : Name, Description, utilisé dans les Skills, Last Updated
- Les boutons de gestion : Add Connection, Test, modifier, Delete
- Une fonctionnalité de recherche pour trouver des connexions spécifiques
Les connexions sont des ressources partagées. Tous les concepteurs de compétences de votre tenant peuvent utiliser ces connexions dans leurs compétences.
Étape 3 : Ajouter une nouvelle connexion LLM
- Cliquez sur le bouton + Add Connection en haut de la page connexion.
- 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 d’autres modèles d’IA hébergés sur l’infrastructure Azure de Microsoft
- Google AI Studio (Gemini) - Modèles Gemini de Google via AI Studio
- Sélectionnez un fournisseur (dans cet exemple, nous utiliserons Microsoft Foundry).
- Cliquez sur Next.
Chaque fournisseur a des exigences de configuration différentes. Choisissez celui qui correspond à l’abonnement LLM de votre organisation.
Étape 4 : Configurer les paramètres de connexion
Paramètres généraux
- Un identifiant unique pour cette connexion
- Exemple :
Microsoft FoundryouProduction GPT-4 - Ce nom s’affichera lors de la sélection des connexions dans les Compétences de document.
- Facultative, mais recommandée.
- Ajoutez des informations utiles sur la connexion.
- Exemple : “Connexion Microsoft Foundry 1” ou “API de production GPT-4”.
- Important : N’incluez pas d’informations d’identification sensibles dans la description.
Choisissez des noms explicites pour aider les concepteurs de compétence à comprendre quelle connexion utiliser selon le besoin.
Paramètres de connexion
Pour Microsoft Foundry :
- Votre clé API Microsoft Foundry, disponible dans le portail Azure.
- Vous la trouverez ici : Portail Azure → Votre ressource Microsoft Foundry → Keys and Endpoint.
- Format : une longue chaîne alphanumérique.
- Exemple d’espace réservé :
[API Key Here]
- L’URL du point de terminaison de Microsoft Foundry.
- Vous la trouverez ici : Portail Azure → 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.
- Vous le trouverez ici : Portail Azure → Votre ressource Microsoft Foundry → Deployments.
- Exemple :
gpt-4.1-nano,gpt-35-turbo,gpt-4 - Il doit correspondre exactement à votre déploiement.
Pour OpenAI ChatGPT :
- Votre clé API OpenAI depuis platform.openai.com.
- Vous la trouverez ici : OpenAI Platform → API Keys.
- Format : commence par
sk-
- Le Model spécifique à utiliser (par ex.
gpt-4,gpt-3.5-turbo)
Pour Google AI Studio (Gemini) :
- Votre clé API Google AI Studio, disponible sur aistudio.google.com.
- Vous la trouverez ici : Google AI Studio → Get API key.
- Format : une longue chaîne alphanumérique.
- Le modèle Gemini spécifique à utiliser (par exemple,
gemini-2.0-flash,gemini-2.5-pro)
Étape 5 : Testez votre connexion
- Après avoir renseigné toutes les informations obligatoires, cliquez sur le bouton Test.
- Vantage tentera de se connecter à votre fournisseur de LLM à l’aide des identifiants que vous avez fournis.
- Vérifiez 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 dans les Compétences de document.
- Consultez le message d’erreur pour identifier le problème précis.
- Problèmes courants :
- Clé API incorrecte
- URL du point de terminaison non valide
- Nom de modèle incorrect
- Problèmes de connectivité réseau
- Permissions insuffisantes ou quota insuffisant
Testez toujours votre connexion avant de l’enregistrer. Cela garantit que vos Compétences de document pourront utiliser le fournisseur LLM correctement.
Étape 6 : Enregistrez votre connexion
- Une fois le test concluant, cliquez sur le bouton Add.
- Votre connexion apparaît maintenant dans la liste connexion.
- La connexion est immédiatement disponible pour tous les concepteurs de compétence de votre tenant.
- Nom de la connexion : Tel que vous l’avez indiqué
- Description : La description que vous avez fournie
- Utilisée dans les Skills : Indiquera quelles compétences utilisent cette connexion
- Dernière mise à jour : Date et heure actuelles
Une fois qu’une compétence utilisant cette connexion est publiée, la connexion est définie par défaut dans le portail web Vantage sous Skill Catalog → [compétence] → Parameters. Les administrateurs du tenant peuvent remplacer la valeur par défaut par une autre connexion pour chaque environnement sans republier la compétence — voir Paramètres de compétence de document.
Gérer les connexions existantes
Modifier une connexion
- Sélectionnez la connexion dans la liste.
- Cliquez sur le bouton Modifier (icône en forme de crayon).
- Mettez à jour les champs requis.
- Testez à nouveau la connexion.
- Cliquez sur Enregistrer.
Tester une connexion
- Sélectionnez la connexion dans la liste.
- Cliquez sur le bouton Test (icône d’actualisation).
- Vérifiez que la connexion fonctionne toujours.
- Cela est utile pour le dépannage ou pour vérifier les 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 non valide :
- Vérifiez que vous avez bien copié la clé dans son intégralité.
- Vérifiez qu’il n’y a pas d’espaces ni de caractères en trop.
- Régénérez la clé dans le portail de votre fournisseur si nécessaire.
- URL du point de terminaison non valide :
- 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 faute de frappe dans le chemin de déploiement.
- Nom du modèle incorrect :
- Vérifiez que le déploiement existe dans votre Azure portal.
- Vérifiez l’orthographe et la casse (respect de la casse).
- Vérifiez que le déploiement est actif et disponible.
- Problèmes de réseau :
- Vérifiez votre connexion Internet.
- Vérifiez que les paramètres du pare-feu autorisent les connexions HTTPS sortantes.
- Assurez-vous que votre instance Vantage peut joindre 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 Test mais échoue dans les compétences
- Actualisez la page Skill Designer.
- Sélectionnez de nouveau la connexion dans la configuration de la compétence.
- Vérifiez les logs d’erreur de la compétence pour trouver des messages spécifiques.
- Vérifiez que la compétence est publiée et qu’elle n’est pas en mode brouillon.
Coûts d’API plus élevés que prévu
- Vérifiez quelles compétences utilisent cette connexion.
- Vérifiez le volume et la fréquence de traitement.
- Envisagez de mettre en place une limitation du 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 de clés d’API dans des e-mails en texte brut ou par chat.
- Renouvelez régulièrement vos identifiants (tous les 90 jours est recommandé).
- 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 - accordez uniquement les autorisations nécessaires.
- Conservez des identifiants de secours dans un emplacement sécurisé en cas d’urgence.
Gestion des connexions
- Utilisez des noms explicites qui indiquent la finalité ou l’environnement.
- Bon : “Production GPT-4”, “Développement Microsoft Foundry”
- À éviter : “Connexion 1”, “Test”
- Indiquez 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 une vérification mensuelle.
- Effectuez un test après toute modification des identifiants.
- Suivez l’utilisation pour identifier les connexions actives
- Vérifiez la colonne “utilisé dans les Skills”.
- Archivez ou supprimez les connexions inutilisées.
Gestion des coûts
- Choisissez les modèles adaptés à chaque cas d’utilisation.
- Utilisez des modèles plus petits et plus rapides pour les tâches simples.
- Réservez les modèles avancés aux extractions complexes.
- Mettez en place une limitation du taux de requêtes si votre fournisseur la prend en charge.
- Évite les hausses de coûts imprévues.
- Protège contre les traitements qui s’emballent.
- Surveillez les tendances d’utilisation
- Configurez des alertes de facturation dans le tableau de bord de votre fournisseur.
- Passez en revue chaque mois les coûts et l’utilisation.
- Optimisez les prompts dans vos Compétences de document.
- Des prompts efficaces réduisent l’utilisation des tokens.
- Testez et affinez pour obtenir les meilleurs résultats au coût le plus bas.
Optimisation du workflow
- Regroupez les types de documents similaires
- Configurez les compétences de document appropriées pour votre cas d’usage
- Testez avec des documents d’exemple avant toute utilisation en production
- Documentez votre workflow à titre de référence pour l’équipe
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/
- Google AI Studio : https://aistudio.google.com
- Support : Contactez l’assistance ABBYY pour obtenir une aide technique
Résumé
- ✅ Accéder aux paramètres de Configuration
- ✅ Accéder à la gestion des Connections
- ✅ Ajouter une nouvelle connexion LLM
- ✅ Configurer les identifiants et les paramètres de connexion
- ✅ Tester votre connexion
- ✅ Apprendre à gérer les connexions