> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer les connexions LLM

> Configurez des connexions LLM dans ABBYY Vantage pour intégrer les modèles OpenAI ChatGPT, Microsoft Foundry et Google AI Studio (Gemini) à l'extraction et à la classification de documents par l'IA.

<div id="overview">
  ## Vue d’ensemble
</div>

Les connexions LLM dans ABBYY Vantage vous permettent d’intégrer directement à vos workflows de traitement des documents de puissants modèles de langage provenant de fournisseurs comme OpenAI, Microsoft Foundry et Google AI Studio. Ces connexions permettent à vos Compétences de document d’exploiter une IA de pointe pour améliorer l’extraction, la classification et la compréhension des documents complexes.

**Ce que vous allez faire :**

* Accéder à la configuration des connexions
* Ajouter une nouvelle connexion LLM
* Configurer les identifiants et les paramètres de connexion
* Tester votre connexion

**Temps nécessaire :** 10 à 15 minutes

<Note>
  Les connexions LLM ne peuvent actuellement être utilisées dans les Compétences de document que via ABBYY Advanced Designer.
</Note>

Pour une vue d’ensemble conceptuelle et la liste complète des fournisseurs et modèles pris en charge, consultez [Les LLM dans ABBYY Vantage](/fr/vantage/documentation/llms/llms) et [Fournisseurs et modèles LLM pris en charge](/fr/vantage/documentation/llms/supported-providers-models).

***

<div id="prerequisites">
  ## Prérequis
</div>

Avant de commencer, assurez-vous de disposer de :

1. d’un **accès administrateur** à ABBYY Vantage Configuration.
2. 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/completions` et 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
3. d’un **abonnement actif** auprès de votre fournisseur LLM.

<Note>
  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.
</Note>

***

<div id="step-1-access-configuration-settings">
  ## Étape 1 : Accéder aux paramètres de Configuration
</div>

Accédez à la section Configuration, où vous gérerez les connexions LLM.

1. Dans l’interface ABBYY Vantage, repérez la section **ADMIN** dans la barre latérale gauche.
2. Cliquez sur **Configuration** (icône d’engrenage).

<Frame>
  <img src="https://mintcdn.com/abbyy/-OvZCOLG9-NO5n6J/images/vantage/how-to/connections/how_to_select_config.png?fit=max&auto=format&n=-OvZCOLG9-NO5n6J&q=85&s=e4927473c33c7676c5f0f7fa2f8a6f4e" alt="Accès à la Configuration" width="2844" height="1260" data-path="images/vantage/how-to/connections/how_to_select_config.png" />
</Frame>

Vous verrez la page Configuration avec plusieurs options dans le menu de gauche :

* 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

***

<div id="step-2-navigate-to-connections">
  ## Étape 2 : Accéder à la connexion
</div>

Accédez à l’interface de gestion des connexions.

1. Dans le menu de gauche Configuration, cliquez sur **connexion**.

<Frame>
  <img src="https://mintcdn.com/abbyy/-OvZCOLG9-NO5n6J/images/vantage/how-to/connections/how_to_select_connections.png?fit=max&auto=format&n=-OvZCOLG9-NO5n6J&q=85&s=a8976300747ce2ba1a4f4a84bd4c40e7" alt="Page connexion" width="2850" height="1260" data-path="images/vantage/how-to/connections/how_to_select_connections.png" />
</Frame>

La page connexion affiche :

* 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

<Note>
  Les connexions sont des ressources partagées. Tous les concepteurs de compétences de votre tenant peuvent utiliser ces connexions dans leurs compétences.
</Note>

***

<div id="step-3-add-a-new-llm-connection">
  ## Étape 3 : Ajouter une nouvelle connexion LLM
</div>

Commencez à créer une nouvelle connexion vers votre fournisseur LLM.

1. Cliquez sur le bouton **+ Add Connection** en haut de la page **connexion**.
2. 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
3. Sélectionnez un fournisseur (dans cet exemple, nous utiliserons **Microsoft Foundry**).
4. Cliquez sur **Next.**

<Note>
  Chaque fournisseur a des exigences de configuration différentes. Choisissez celui qui correspond à l’abonnement LLM de votre organisation.
</Note>

***

<div id="step-4-configure-connection-details">
  ## Étape 4 : Configurer les paramètres de connexion
</div>

Renseignez les informations obligatoires pour votre connexion LLM.

<Frame>
  <img src="https://mintcdn.com/abbyy/-OvZCOLG9-NO5n6J/images/vantage/how-to/connections/how_to_add_connection_detail.png?fit=max&auto=format&n=-OvZCOLG9-NO5n6J&q=85&s=83e104ac9d625279d8c2c678e5007cf3" alt="Configuration de la connexion" width="2866" height="1290" data-path="images/vantage/how-to/connections/how_to_add_connection_detail.png" />
</Frame>

<div id="general-settings">
  ### Paramètres généraux
</div>

**Nom**

* Un identifiant unique pour cette connexion
* Exemple : `Microsoft Foundry` ou `Production GPT-4`
* Ce nom s’affichera lors de la sélection des connexions dans les Compétences de document.

**Description**

* 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.

<Note>
  Choisissez des noms explicites pour aider les concepteurs de compétence à comprendre quelle connexion utiliser selon le besoin.
</Note>

<div id="connection-settings">
  ### Paramètres de connexion
</div>

Les champs obligatoires varient selon votre fournisseur de LLM :

<div id="for-microsoft-foundry">
  #### Pour Microsoft Foundry :
</div>

**Clé API**

* 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]`

**URL**

* 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`

**Nom du modèle**

* 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.

<div id="for-openai-chatgpt">
  #### Pour OpenAI ChatGPT :
</div>

**clé API**

* Votre clé API OpenAI depuis platform.openai.com.
* Vous la trouverez ici : OpenAI Platform → API Keys.
* Format : commence par `sk-`

**Model**

* Le Model spécifique à utiliser (par ex. `gpt-4`, `gpt-3.5-turbo`)

<div id="for-google-ai-studio-gemini">
  #### Pour Google AI Studio (Gemini) :
</div>

**Clé API**

* 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.

**Model**

* Le modèle Gemini spécifique à utiliser (par exemple, `gemini-2.0-flash`, `gemini-2.5-pro`)

<Warning>
  Ne partagez jamais de clés API et ne les incluez pas dans des descriptions. Ces identifiants donnent accès à vos services LLM ainsi qu’aux coûts associés.
</Warning>

***

<div id="step-5-test-your-connection">
  ## Étape 5 : Testez votre connexion
</div>

Vérifiez que votre connexion est correctement configurée avant de l’enregistrer.

1. Après avoir renseigné toutes les informations obligatoires, cliquez sur le bouton **Test**.

<Frame>
  <img src="https://mintcdn.com/abbyy/-OvZCOLG9-NO5n6J/images/vantage/how-to/connections/how_to_test_connection.png?fit=max&auto=format&n=-OvZCOLG9-NO5n6J&q=85&s=8bd4e55f9f290635ed5202f54b34caac" alt="Test de la connexion" width="2820" height="1262" data-path="images/vantage/how-to/connections/how_to_test_connection.png" />
</Frame>

2. Vantage tentera de se connecter à votre fournisseur de LLM à l’aide des identifiants que vous avez fournis.
3. 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.

<div id="test-results">
  ### Résultats du test
</div>

**Test réussi :**

* 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.

**Échec du test :**

* 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

<Note>
  Testez toujours votre connexion avant de l’enregistrer. Cela garantit que vos Compétences de document pourront utiliser le fournisseur LLM correctement.
</Note>

***

<div id="step-6-save-your-connection">
  ## Étape 6 : Enregistrez votre connexion
</div>

Finalisez la configuration de la connexion.

1. Une fois le test concluant, cliquez sur le bouton **Add**.
2. Votre connexion apparaît maintenant dans la liste connexion.
3. La connexion est immédiatement disponible pour tous les concepteurs de compétence de votre tenant.

La page connexion affiche maintenant :

* **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

<Note>
  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](/fr/vantage/documentation/skill-designer/skill-parameters/document-skill-params).
</Note>

***

<div id="managing-existing-connections">
  ## Gérer les connexions existantes
</div>

Vous pouvez gérer vos connexions une fois créées.

<div id="edit-a-connection">
  ### Modifier une connexion
</div>

1. Sélectionnez la connexion dans la liste.
2. Cliquez sur le bouton **Modifier** (icône en forme de crayon).
3. Mettez à jour les champs requis.
4. Testez à nouveau la connexion.
5. Cliquez sur **Enregistrer.**

<Warning>
  La modification d’une connexion affecte toutes les compétences qui l’utilisent. Testez-la soigneusement après avoir apporté des modifications.
</Warning>

<div id="test-a-connection">
  ### Tester une connexion
</div>

1. Sélectionnez la connexion dans la liste.
2. Cliquez sur le bouton **Test** (icône d’actualisation).
3. Vérifiez que la connexion fonctionne toujours.
4. Cela est utile pour le dépannage ou pour vérifier les identifiants.

<div id="delete-a-connection">
  ### Supprimer une connexion
</div>

1. Sélectionnez la connexion dans la liste.
2. Cliquez sur le bouton **Delete** (icône de corbeille).
3. Confirmez la suppression.

<Warning>
  Vous ne pouvez pas supprimer une connexion actuellement utilisée par des compétences actives. Retirez d’abord la connexion de toutes les compétences.
</Warning>

***

<div id="troubleshooting">
  ## Résolution des problèmes
</div>

<div id="connection-test-fails">
  ### Échec du test de connexion
</div>

**Problème :** le test de connexion renvoie une erreur.

**Solutions :**

* **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.

<div id="connection-works-in-test-but-fails-in-skills">
  ### La connexion fonctionne dans Test mais échoue dans les compétences
</div>

**Problème :** le test réussit, mais les compétences ne parviennent pas à utiliser la connexion.

**Solutions :**

* 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.

<div id="api-costs-higher-than-expected">
  ### Coûts d’API plus élevés que prévu
</div>

**Problème :** Coûts inattendus facturés par votre fournisseur de LLM.

**Solutions :**

* 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.

***

<div id="best-practices">
  ## Bonnes pratiques
</div>

<div id="security">
  ### Sécurité
</div>

* **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.

<div id="connection-management">
  ### Gestion des connexions
</div>

* **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.

<div id="cost-management">
  ### Gestion des coûts
</div>

* **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.

<div id="workflow-optimization">
  ### Optimisation du workflow
</div>

* **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

***

<div id="additional-resources">
  ## Ressources supplémentaires
</div>

* **Documentation de l’API OpenAI :** [https://platform.openai.com/docs](https://platform.openai.com/docs)
* **Microsoft Foundry :** [https://azure.microsoft.com/products/ai-foundry](https://azure.microsoft.com/products/ai-foundry)
* **Documentation des services Azure AI :** [https://learn.microsoft.com/azure/ai-services/](https://learn.microsoft.com/azure/ai-services/)
* **Google AI Studio :** [https://aistudio.google.com](https://aistudio.google.com)
* **Support :** Contactez l’assistance ABBYY pour obtenir une aide technique

***

<div id="summary">
  ## Résumé
</div>

Vous avez réussi à :

* ✅ 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

Votre connexion LLM est maintenant prête à exploiter des fonctionnalités d’IA avancées dans vos Compétences de document ABBYY Vantage !