Connexions IA

À quoi ça sert

Plusieurs fonctions de Deltia s'appuient sur un fournisseur d'intelligence artificielle : le chatbot, l'analyse de documents, l'assistant, l'import de chiffrages. Plutôt que de saisir des identifiants à chaque endroit, vous les enregistrez une fois ici.

« Une connexion regroupe un point d'accès et une clé API ; les modules choisissent ensuite le modèle à utiliser sur cette connexion. » La page indique aussi quels modules se servent de chaque connexion, ce qui vous évite d'en supprimer une encore en usage.

Concepts clés

• Connexion — un couple point d'accès et clé API, portant un nom qui vous parle.
• Type de fournisseur — « Compatible OpenAI », « OpenRouter » ou « Azure Document Intelligence ». « Compatible OpenAI couvre OpenAI, Mistral et tout point d'accès /chat/completions. OpenRouter permet la résidence UE et le choix filtrable de modèles. Azure Document Intelligence sert uniquement à l'OCR. »
• Point d'accès — l'adresse de l'API du fournisseur, par exemple https://api.openai.com/v1. Sur une connexion OpenRouter, ce champ n'est pas saisi à la main : il découle de la « Résidence des données UE ».
• Clé API — le secret d'authentification. Il n'est jamais réaffiché : la liste n'en montre qu'un fragment.
• Résidence des données UE — réglage propre à OpenRouter : « Traite les requêtes exclusivement dans l'UE, sur un catalogue de modèles réduit. Une requête sur un modèle non disponible en UE échoue plutôt que de basculer hors UE. »
• Zero Data Retention (ZDR) — réglage propre à OpenRouter : « Restreint le routage aux points d'accès OpenRouter qui ne conservent pas les requêtes. »
• Utilisée par — les modules qui pointent sur cette connexion, avec le nombre d'usages. Une connexion libre affiche « Non utilisée ».
• Modèle — l'identifiant du modèle à employer. Il ne se règle pas ici mais dans le module qui l'utilise : en saisie libre pour « Compatible OpenAI », ou choisi dans un catalogue filtrable pour « OpenRouter ».
• Routage d'un modèle — sur une connexion OpenRouter, chaque emplacement de modèle d'un module peut, en plus du modèle, préciser le fournisseur à privilégier et forcer le passage par le point d'accès européen pour ce seul modèle, indépendamment du réglage de résidence UE de la connexion.
• Consommation IA — le tableau de bord, sous la liste des connexions, qui montre ce que vos modules consomment sur une période : nombre d'appels, jetons échangés et coût quand il est connu.

Comment faire

Ouvrir la liste des connexions

1. Ouvrez le menu utilisateur, puis « Administration » et « Connexions IA ».

La page affiche la carte « Connexions », le décompte et un tableau : « Nom », « Type », « Point d'accès », « Clé », « Utilisée par » et « Actions ». Tant qu'aucune connexion n'existe : « Aucune connexion IA. Créez-en une pour que vos modules puissent l'utiliser. »

Créer une connexion

1. Cliquez sur « Nouvelle connexion ».
2. Renseignez le « Nom » : « Le nom affiché dans les sélecteurs des modules. »
3. Choisissez le « Type de fournisseur ».
4. Pour « Compatible OpenAI » ou « Azure Document Intelligence », renseignez le « Point d'accès ». Pour « OpenRouter », voir ci-dessous : le champ est calculé automatiquement.
5. Collez la « Clé API ».
6. Cliquez sur « Enregistrer ».

Le message « Connexion créée. » confirme et la connexion apparaît dans la liste.

Configurer une connexion OpenRouter

1. Dans le formulaire de la connexion, choisissez le « Type de fournisseur » « OpenRouter ».
2. Activez au besoin « Résidence des données UE ». Le « Point d'accès » bascule alors sur le point d'accès européen d'OpenRouter et le catalogue de modèles proposé aux modules se réduit à ceux disponibles en UE.
3. Activez au besoin « Zero Data Retention (ZDR) ».
4. Collez la « Clé API » et cliquez sur « Enregistrer ».

Si le compte OpenRouter de la clé fournie n'a pas accès au routage régional européen, l'enregistrement d'une connexion en résidence UE est refusé : « Le compte OpenRouter de cette connexion n'a pas accès au routage régional européen. Désactivez le routage UE ou activez cette option auprès d'OpenRouter. » En modification, ce cas est signalé avant même d'enregistrer : « Le compte OpenRouter n'a pas accès au routage régional européen. Contactez OpenRouter pour l'activer, ou désactivez cette option. », et le bouton « Enregistrer » reste inactif tant que la case est cochée.

Modifier une connexion

1. Cliquez sur la ligne de la connexion.
2. Modifiez le nom, le type, le point d'accès, la résidence UE ou le ZDR selon le type de fournisseur.
3. Pour changer la clé, saisissez la nouvelle. Pour la conserver, laissez le champ vide : « Laisser vide pour conserver la clé actuelle ».
4. Cliquez sur « Enregistrer ».

Le message « Connexion mise à jour. » confirme. Le volet rappelle la clé en place sous la forme « Clé enregistrée : {fragment} ».

Tester une connexion

1. Dans la colonne « Actions », ouvrez le menu de la connexion.
2. Choisissez « Tester ».

Le test appelle le fournisseur et affiche son résultat. Il n'est pas disponible pour tous les types : « Ce fournisseur n'expose pas de test rapide. »

Supprimer une connexion

1. Dans la colonne « Actions », ouvrez le menu de la connexion.
2. Choisissez « Supprimer ».
3. Confirmez : « La connexion {nom} sera définitivement supprimée. Cette action est irréversible. »

Le message « Connexion supprimée. » confirme. Une connexion encore utilisée est refusée, et le message nomme les modules concernés : « Impossible : la connexion est encore utilisée par {modules}. » Détachez-la d'abord de ces modules.

Consulter l'historique d'une connexion

1. Dans la colonne « Actions », ouvrez le menu de la connexion.
2. Choisissez « Historique ».

Le volet « Historique de la connexion » liste les événements datés : « Connexion créée », « Connexion modifiée », « Connexion supprimée ». S'il n'y en a aucun : « Aucun événement. »

Choisir un modèle et son routage sur une connexion OpenRouter

Cette étape se déroule dans le module qui consomme la connexion (voir « Où les connexions sont consommées » ci-dessous), à côté du sélecteur de connexion.

1. Choisissez une connexion de type « OpenRouter ».
2. Dans le champ « Modèle », recherchez et choisissez un modèle dans le catalogue. Chaque ligne indique la longueur de contexte, la mention « Gratuit » le cas échéant, et le badge « ZDR » pour un modèle disposant d'un point d'accès sans conservation des requêtes.
3. Une fois un modèle choisi, réglez au besoin « Fournisseur » : « Automatique (recommandé) » laisse OpenRouter router vers le fournisseur le plus fiable au meilleur prix ; un fournisseur nommé fige ce choix. Chaque option affiche sa disponibilité, sa latence et son prix.
4. Réglez au besoin « Forcer le routage UE » pour ce modèle, indépendamment de la résidence UE de la connexion.

Le champ « Fournisseur » n'apparaît que si plusieurs fournisseurs existent pour ce modèle. « Forcer le routage UE » n'apparaît que si la connexion n'est pas déjà en résidence UE ; il reste inactif pour l'activer si le modèle n'est pas disponible sur le point d'accès européen (« Ce modèle n'est pas disponible sur le point d'accès européen. ») ou si le compte OpenRouter n'a pas accès au routage régional (« Le compte OpenRouter de cette connexion n'a pas accès au routage régional européen. »). Un modèle déjà enregistré avec le routage UE reste désactivable dans ce cas.

Si aucun fournisseur du modèle n'accepte de température, le formulaire l'indique : « Aucun fournisseur de ce modèle n'accepte de température : les appels partent sans, le modèle applique la sienne. »

Consulter la consommation IA

1. Sur la page « Connexions IA », descendez jusqu'à la carte « Consommation IA », sous la liste des connexions.
2. Choisissez la « Période » : « 7 derniers jours », « 30 derniers jours », « Ce mois-ci », « Mois dernier » ou « 12 derniers mois ».
3. Ajustez la « Granularité » — « Par jour », « Par semaine » ou « Par mois » — pour lisser le graphique.
4. Choisissez comment « Répartir par » : « Vue d'ensemble », « Connexion », « Module », « Utilisateur », « Modèle » ou « Erreur ».
5. Basculez la « Mesure » entre « Jetons » et « Coût ».
6. Filtrez, au besoin, sur une ou plusieurs « Connexions », « Modules » ou « Utilisateurs ».

Cinq chiffres résument la période : « Appels », « Jetons entrée », « Jetons sortie », « Coût » et « Échecs ». Le graphique affiche des barres empilées par période ; dès que « Répartir par » propose autre chose que « Vue d'ensemble », un tableau détaille chaque valeur sous le graphique. Sans consommation sur la période choisie : « Aucune consommation sur la période sélectionnée. »

La consommation inclut les appels de l'assistant IA, y compris une réponse interrompue avant sa fin, ceux des analyses KPI, des automatisations et du contrôle IA des documents.

« Échecs » compte les appels que le fournisseur a refusés (quota atteint, crédits épuisés, clé invalide, modèle indisponible…), chaque tentative étant comptée. Le chiffre s'affiche avec sa part des appels, par exemple « 23 (70 %) », en rouge à partir de 10 %. Une réponse que l'utilisateur arrête lui-même n'est pas un échec. Le tableau sous le graphique a la même colonne « Échecs », et « Répartir par » « Erreur » ventile les appels par cause : « Réussi », « Quota du fournisseur atteint », « Crédits épuisés », « Clé ou configuration invalide », « Routage UE non autorisé », « Modèle non pris en charge », « Fournisseur indisponible », « Erreur réseau » ou « Erreur inconnue ».

Référence

Colonnes du tableau

Les trois types de fournisseur

Champs du formulaire

Résultats du test

Où les connexions sont consommées

Dans ces écrans, le sélecteur « Connexion IA » propose les connexions compatibles. S'il n'y en a aucune : « Aucune connexion IA compatible n'est configurée pour votre organisation. »

Routage par modèle (connexions OpenRouter)

Un fournisseur ou un modèle enregistré puis retiré du catalogue OpenRouter reste affiché, avec la mention « (indisponible) » ou « (hors catalogue) », au lieu de disparaître silencieusement du réglage.

Messages liés à OpenRouter

Réglages du tableau de consommation

Modules suivis par la consommation

Une ligne sans utilisateur identifiable — une reprise automatique plutôt qu'une action d'un utilisateur — s'affiche comme « Traitement automatique » dans la répartition par utilisateur, et comme « Non attribué » dans les autres répartitions.

Fiabilité du coût affiché

Le coût n'est communiqué que par certains fournisseurs. Tant qu'un seul appel de la période provient d'une connexion qui ne le communique pas, le montant affiché porte le badge « Coût partiel », avec l'explication : « Seul OpenRouter communique un prix. Les appels passés par un autre fournisseur sont comptés en jetons mais pas en euros : le montant affiché est un plancher. » Quand aucun appel de la période n'a de coût connu, le total affiche « — ».

Questions fréquentes

Puis-je revoir une clé API enregistrée ?

Non. Seul un fragment est affiché. Pour changer de clé, saisissez la nouvelle dans le formulaire de modification ; un champ laissé vide conserve la clé en place.

Pourquoi ma connexion refuse-t-elle d'être supprimée ?

Parce qu'un module l'utilise encore. Le message nomme les modules concernés : retirez-la de leurs réglages, puis recommencez.

Combien de connexions puis-je créer ?

Autant que nécessaire. Créez-en une par fournisseur, ou une par usage si vous voulez suivre séparément la consommation d'une fonction.

Une connexion sert-elle à choisir le modèle ?

Non. Elle porte le point d'accès et la clé ; le modèle se choisit dans le module qui l'utilise, à côté du sélecteur de connexion.

Une connexion OpenRouter en résidence UE peut-elle basculer hors UE en cas d'échec ?

Non. « Une requête sur un modèle non disponible en UE échoue plutôt que de basculer hors UE. » C'est la même règle pour le routage forcé d'un modèle en particulier.

Le fournisseur choisi pour un modèle OpenRouter change-t-il le modèle lui-même ?

Non. Le fournisseur est l'infrastructure qui exécute le modèle choisi ; il ne change ni le modèle ni son identifiant. « Automatique » laisse OpenRouter retenir le fournisseur le plus fiable au meilleur prix.

Le coût affiché dans « Consommation IA » est-il exact ?

Non, sauf si tous les appels de la période passent par une connexion qui communique son prix. Sinon, il s'agit d'un plancher, signalé par le badge « Coût partiel » : voir « Fiabilité du coût affiché » ci-dessus.