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 » ou « Azure Document Intelligence ».
• Point d'accès — l'adresse de l'API du fournisseur, par exemple https://api.openai.com/v1.
• Clé API — le secret d'authentification. Il n'est jamais réaffiché : la liste n'en montre qu'un fragment.
• 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.
• 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. Renseignez le « Point d'accès ».
5. Collez la « Clé API ».
6. Cliquez sur « Enregistrer ».

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

Modifier une connexion

1. Cliquez sur la ligne de la connexion.
2. Modifiez le nom, le type ou le point d'accès.
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. »

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 » ou « Modèle ».
5. Basculez la « Mesure » entre « Jetons » et « Coût ».
6. Filtrez, au besoin, sur une ou plusieurs « Connexions », « Modules » ou « Utilisateurs ».

Quatre chiffres résument la période : « Appels », « Jetons entrée », « Jetons sortie » et « Coût ». 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. »

Référence

Colonnes du tableau

Les deux 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. »

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.

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.