Skip to main content
Une connexion LLM stocke les identifiants au niveau du tenant qui relient ABBYY Vantage à un fournisseur de LLM externe. Une fois configurée, elle est partagée dans votre tenant, et toute compétence de document peut l’utiliser pour l’extraction basée sur des prompts et la classification.
Les connexions LLM peuvent actuellement être utilisées dans les compétences de document uniquement via ABBYY Advanced Designer. Elles sont gérées au niveau du tenant et sont accessibles à tous les concepteurs de compétences de votre organisation.
Pour une vue d’ensemble et la liste complète des fournisseurs pris en charge, consultez Les LLM dans ABBYY Vantage et Fournisseurs et modèles de LLM pris en charge.

​
Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :
  • Accès administrateur à ABBYY Vantage Configuration.
  • Abonnement actif auprès du fournisseur LLM de votre choix.
  • Identifiants API fournis par ce fournisseur :
    • Anthropic - Clé API de votre compte Anthropic.
    • Google AI Studio - Clé API de votre compte Google AI Studio.
    • Microsoft Foundry - Clé API, URL complète du point de terminaison (y compris le chemin /chat/completions et la version de l’API) et nom du modèle déployé dans Azure.
    • Mistral AI - Clé API de votre compte Mistral AI.
    • OpenAI - Clé API de votre compte OpenAI.

​
Ajouter une connexion LLM

1

Ouvrir la page Connexions

Dans la barre latérale gauche, sous ADMIN, cliquez sur Configuration (icône d’engrenage), puis sur Connexions.
Page Connexions dans la configuration de Vantage
La page Connexions répertorie les connexions existantes avec leur Nom, leur Description, la colonne Utilisé dans les Skills et leur date de Dernière mise à jour, ainsi que les boutons Ajouter une connexion, Test, Modifier et Delete.
2

Sélectionner un fournisseur

Cliquez sur + Ajouter une connexion. La boîte de dialogue Ajouter une connexion répertorie les fournisseurs disponibles : Anthropic, Microsoft Foundry, Google AI Studio, Mistral AI et OpenAI.
Boîte de dialogue Ajouter une connexion répertoriant les fournisseurs Anthropic, Microsoft Foundry, Google AI Studio, Mistral AI et OpenAI
Sélectionnez le fournisseur correspondant à votre abonnement, puis cliquez sur Suivant.
3

Saisir les paramètres généraux

Donnez un nom à la connexion et ajoutez éventuellement une description.
  • Nom - Nom unique de la connexion. Ce nom apparaît lorsque les concepteurs de compétence sélectionnent une connexion dans une Compétence de document. Choisissez donc un nom explicite, tel que Production Claude ou Mistral AI.
  • Description - Contexte facultatif sur l’objectif ou l’environnement de la connexion. N’incluez pas de clés API ni d’autres identifiants.
4

Saisir les paramètres de connexion

Saisissez les identifiants de votre fournisseur. Les champs obligatoires dépendent du fournisseur sélectionné. Pour connaître les champs requis pour chaque fournisseur, consultez Paramètres de connexion par fournisseur.
Formulaire de configuration de connexion avec les sections Général et Paramètres de connexion
5

Tester la connexion

Cliquez sur Test. Vantage tente de contacter le fournisseur à l’aide des identifiants saisis.
Test d’une connexion LLM
Une coche verte confirme que la connexion fonctionne. Une erreur rouge indique que les identifiants ou les paramètres doivent être vérifiés. Pour obtenir de l’aide, consultez Résolution des problèmes.
6

Enregistrer la connexion

Une fois le test réussi, cliquez sur Ajouter. La connexion apparaît dans la liste Connexions et est immédiatement accessible à tous les concepteurs de compétence de votre tenant.
Lorsqu’une compétence qui référence cette connexion est publiée, cette connexion devient celle par défaut dans le portail web Vantage, sous Skill Catalog → [compétence] → Paramètres. Un administrateur du tenant peut modifier cette valeur par défaut pour chaque environnement sans republier la compétence. Pour plus d’informations, consultez Paramètres de compétence de document.

​
Paramètres de connexion par fournisseur

Les champs des Paramètres de connexion diffèrent selon le fournisseur. Saisissez le nom exact du modèle pris en charge par votre compte. Pour consulter des exemples de modèles, voir Fournisseurs et modèles LLM pris en charge.
Ne partagez jamais de clés API et ne les incluez pas dans la description d’une connexion. Ces identifiants donnent accès à vos services LLM et aux coûts associés.

​
Anthropic

  • nom du modèle - Le modèle Anthropic à utiliser. Sélectionnez un modèle pris en charge par votre compte.
  • Clé API - Votre clé API Anthropic (commence par sk-).

​
Google AI Studio (Gemini)

  • Nom du modèle - Le modèle Gemini à utiliser, par exemple gemini-2.0-flash.
  • Clé API - Votre clé API Google AI Studio, disponible dans Google AI Studio → Get API key.

​
Microsoft Foundry

  • Nom du modèle - Nom de votre modèle déployé dans Microsoft Foundry, indiqué dans Azure Portal → votre ressource Microsoft Foundry → Deployments. Il doit correspondre exactement au déploiement.
  • URL - Point de terminaison de votre Microsoft Foundry, indiqué dans Azure Portal → votre ressource Microsoft Foundry → Keys and Endpoint. Incluez le chemin de déploiement et la version de l’API, par exemple https://<resource>.cognitiveservices.azure.com/openai/deployments/<model-name>/chat/completions?api-version=2025-01-01-preview.
  • Clé API - Clé API de votre Microsoft Foundry, indiquée sur la même page Keys and Endpoint.

​
Mistral AI

  • nom du modèle - Modèle Mistral AI à utiliser. Sélectionnez un modèle pris en charge par votre compte.
  • Clé API - Votre clé API Mistral AI.

​
OpenAI ChatGPT

  • Nom du modèle - Le modèle OpenAI à utiliser, par exemple gpt-4.
  • Clé API - Votre clé API OpenAI (commence par sk-), disponible dans OpenAI Platform → API Keys.

​
Gérer les connexions

Les connexions sont partagées ; une modification affecte donc chaque compétence qui les utilise. Effectuez un test après chaque modification.

​
Modifier une connexion

1

Sélectionner la connexion

Sur la page connexion, sélectionnez la connexion, puis cliquez sur Edit (icône en forme de crayon).
2

Mettre à jour et tester

Mettez à jour les champs, cliquez sur Test pour vérifier que la connexion fonctionne toujours, puis cliquez sur Save.
La modification d’une connexion affecte toutes les compétences qui l’utilisent. Testez-les minutieusement après toute modification.

​
Tester une connexion

Sur la page connexion, sélectionnez la connexion, puis cliquez sur Test (icône d’actualisation) pour vérifier que les identifiants sont toujours valides. Cette opération est utile pour les vérifications de routine et la résolution des problèmes.

​
Supprimer une connexion

Sur la page connexion, sélectionnez la connexion, cliquez sur Delete (icône de corbeille), puis confirmez.
Vous ne pouvez pas supprimer une connexion utilisée dans une compétence active. Retirez d’abord la connexion de toutes les compétences.

​
Résolution des problèmes

​
Échec du test de connexion

Vérifiez les identifiants et les paramètres du fournisseur.
  • Clé API non valide - Vérifiez que vous avez copié l’intégralité de la clé, sans espaces superflus. Régénérez-la dans le portail du fournisseur si nécessaire.
  • URL de point de terminaison non valide (Microsoft Foundry) - Vérifiez que l’URL est complète, qu’elle correspond à votre ressource Azure et qu’elle ne contient pas d’erreur dans le chemin de déploiement.
  • Nom de modèle incorrect - Vérifiez que le modèle ou le déploiement existe et est actif, ainsi que l’orthographe et la casse (respect de la casse).
  • Problèmes de réseau - Vérifiez que les connexions HTTPS sortantes sont autorisées et que votre instance Vantage peut joindre le fournisseur.
  • Quota ou autorisations - Vérifiez que votre abonnement est actif, que vous respectez les limites de débit et que la clé dispose des autorisations nécessaires.

​
La connexion fonctionne dans le test mais échoue dans une compétence

  • Actualisez la page Skill Designer et sélectionnez de nouveau la connexion dans la compétence.
  • Vérifiez que la compétence est publiée et qu’elle n’est pas en mode brouillon.
  • Vérifiez les logs d’erreur de la compétence pour trouver des messages spécifiques.

​
Les coûts de l’API sont plus élevés que prévu

  • Vérifiez quelles compétences utilisent la connexion et leur volume de traitement.
  • Utilisez des modèles plus petits et plus rapides pour les tâches simples.
  • Surveillez l’utilisation et configurez des alertes budgétaires dans le tableau de bord de votre fournisseur.

​
Bonnes pratiques

  • Sécurisez vos identifiants. Ne partagez jamais vos clés API et ne les incluez pas dans une description. Renouvelez régulièrement vos clés, n’accordez à chacune que les privilèges strictement nécessaires et utilisez des connexions distinctes pour le développement et la production.
  • Nommez clairement les connexions. Utilisez des noms indiquant leur objectif ou leur environnement, tels que Production GPT-4 ou Development Foundry, plutôt que Connection 1. Indiquez l’environnement, le cas d’utilisation et le responsable dans la description.
  • Vérifiez régulièrement les connexions. Testez-les régulièrement et après toute modification des identifiants, puis utilisez la colonne utilisé dans les Skills pour repérer et supprimer les connexions qui ne sont plus utilisées.
  • Gérez les coûts. Utilisez des modèles plus petits et plus rapides pour les tâches simples, rédigez des prompts efficaces et configurez des alertes budgétaires dans le tableau de bord de votre fournisseur.

​
Ressources supplémentaires