Configurer l'IA

L'intelligence artificielle est une option de Portail ZAPP : elle ajoute des assistants (résumés, suggestions, aide à la rédaction, chatbot des bases de connaissances publiques) et la recherche sémantique. Toutes les fonctions de l'application marchent sans elle. Elle est désactivée à l'installation : rien n'est envoyé à un service d'IA tant que vous n'avez pas choisi un fournisseur.

L'écran Configuration IA (menu Administration › Instance et exploitation › IA) est réservé aux Administrateurs.

Choisir les fournisseurs

L'onglet Général porte deux choix indépendants :

• Provider de chat actif : le service qui rédige (assistants, chatbot). Choix possibles : OpenAi, Anthropic, AzureOpenAi, Mistral, Ollama, Groq ;
• Provider d'embeddings actif : le service qui calcule la proximité de sens entre textes, pour la recherche sémantique et pour que le chatbot retrouve les passages d'articles utiles. Choix possibles : OpenAi, AzureOpenAi, Mistral, Ollama (Anthropic et Groq n'en proposent pas).

Chacun propose aussi Aucun (IA désactivée). Cliquez sur Enregistrer : le choix s'applique sans redémarrage et il est tracé dans l'historique de l'écran Configuration.

Si votre abonnement inclut l'IA de l'éditeur

Quand la licence de l'instance inclut l'IA de l'éditeur, l'onglet Général affiche l'encadré IA fournie par l'éditeur, et les deux listes proposent en premier le choix IA fournie par l'éditeur. Ce choix ne demande ni clé ni modèle.

• L'usage est décompté d'un crédit de tokens. L'encadré indique le Crédit restant (solde sur le total des recharges en cours) et affiche Crédit épuisé quand il n'en reste plus.
• Crédit épuisé : les assistants d'IA ne répondent plus. La recherche sémantique continue de fonctionner.
• Pour utiliser votre propre IA, choisissez un autre fournisseur et réglez son onglet : le décompte s'arrête et le crédit restant est conservé.

Sans cette licence, par exemple sur une instance installée sur vos serveurs, ni l'encadré ni ce choix n'apparaissent. Le suivi du crédit et ses alertes se trouvent dans l'écran Consommation.

Régler un fournisseur

Chaque fournisseur a son onglet, avec son propre bouton Enregistrer. Enregistrer un onglet ne l'active pas : le fournisseur actif se choisit dans Général.

• Clé API : fournie par le service. Elle n'est jamais réaffichée ; laissez le champ vide pour conserver la clé enregistrée ;
• URL de base : l'adresse de l'API, pré-remplie avec celle du service ; à changer seulement pour passer par un relais ;
• Modèle de chat et, sauf pour Anthropic et Groq qui ne calculent pas d'embeddings, Modèle d'embedding : les noms de modèles du fournisseur, pré-remplis avec une valeur courante ;
• Azure OpenAI demande à la place l'Endpoint de votre ressource, les noms de vos Déploiement chat et Déploiement embeddings (champs marqués d'un astérisque, obligatoires), ainsi que la Version d'API ;
• Ollama est un serveur que vous hébergez : pas de clé, seulement son URL de base et ses modèles. Les textes ne quittent alors pas votre infrastructure.

Par sécurité, les adresses joignables dépendent du fournisseur :

• OpenAI et Azure OpenAI : une adresse publique ou une adresse de votre réseau privé — par exemple une passerelle compatible OpenAI que vous hébergez, ou une ressource Azure OpenAI derrière un point de terminaison privé (Private Endpoint) ;
• Anthropic, Mistral et Groq : une adresse publique seulement ;
• Ollama : la machine même (localhost, valeur par défaut) ou votre réseau privé.

Les adresses réservées (lien local, métadonnées d'un hébergeur de nuage) sont toujours refusées. Les appels ne suivent aucune redirection : la clé n'est jamais envoyée à une autre adresse que celle saisie. Si votre serveur ne sort sur Internet que par un proxy, déclarez-le à l'installation (variables HTTPS_PROXY et NO_PROXY) : les appels passent alors par lui.

Avec les autres fournisseurs, les textes traités (contenu d'un ticket, d'un article…) sont envoyés à leur service au moment où un utilisateur demande une action d'IA.

Si vous changez de fournisseur ou de modèle d'embeddings, cliquez ensuite sur Réindexer tous les articles publiés sur la fiche de chaque base de connaissances : les articles déjà indexés l'ont été avec l'ancien modèle.

Lecture de documents et image (onglet Capacités)

En plus de la conversation et des embeddings, l'IA propose deux capacités, chacune avec son propre fournisseur. Elles restent désactivées tant que vous ne leur en choisissez pas un, y compris sur une instance déjà configurée : choisir un fournisseur de chat n'active ni la lecture de documents ni l'image.

L'onglet Capacités a une section par capacité :

• Lecture de documents : un PDF ou l'image d'un document, même scanné, devient du texte par page avec ses tableaux et, à la demande, des champs extraits. OpenAI, Anthropic et Mistral (Mistral OCR) lisent les PDF et les images ; Azure OpenAI lit les images seulement (PNG, JPEG) ;
• Image : génération d'une image à partir d'une consigne, ou retouche d'une image avec un masque facultatif. OpenAI et Azure OpenAI.

Chaque section porte :

• Fournisseur : Aucun (IA désactivée) ou l'un des fournisseurs qui proposent réellement la capacité ; IA fournie par l'éditeur en tête si votre licence l'inclut ;
• Modèle : vide pour le modèle par défaut du fournisseur. Avec Azure OpenAI, saisissez le nom de votre déploiement, obligatoire. Avec l'IA de l'éditeur, le modèle est choisi par l'éditeur ;
• Taille maximale d'un fichier (Mo) : de 1 à 20 Mo, 10 par défaut. Un fichier plus grand est refusé avant tout envoi.

La clé d'API ne se saisit pas ici : c'est celle de l'onglet du fournisseur, chiffrée au repos, qui sert à toutes ses capacités.

Ce qui part chez le fournisseur et ce qui est conservé est décrit dans « Lire des documents avec l'IA » et « Produire des images avec l'IA ». La transcription de la parole aura sa section quand ses fournisseurs seront livrés.

Choisir un fournisseur ou un modèle par fonction (onglet Fonctions)

Par défaut, chaque fonction qui appelle l'IA (tri des tickets, aide à la rédaction, lecture de factures…) prend le fournisseur et le modèle de sa capacité. L'onglet Fonctions liste les fonctions qui ont appelé l'IA ces 90 derniers jours, sous leur nom technique, avec leur Fournisseur et modèle effectifs. Vous pouvez leur en attribuer d'autres : par exemple un modèle léger pour le tri, un modèle plus puissant pour la rédaction.

Pour ajouter un remplacement, cliquez sur Remplacer sur la ligne de la fonction (sa fonction et sa capacité sont déjà remplies), ou sur Ajouter un remplacement sous la liste et saisissez son code. Le formulaire Nouveau remplacement s'ouvre :

• Capacité : Conversation, Lecture de documents ou Image ;
• Fournisseur : Celui de la capacité pour ne changer que le modèle (la fonction suit alors la capacité ; le modèle ne vaut que pour le fournisseur actuel de celle-ci : si elle en change, la fonction prend le modèle par défaut du nouveau), ou un autre fournisseur ;
• Modèle : vide pour le modèle par défaut du fournisseur ;
• Plafond mensuel : dans l'unité de la capacité (tokens pour la conversation, pages pour la lecture de documents, images pour l'image). Une fois atteint, la fonction est refusée jusqu'au mois suivant ; vide, aucun plafond.

Le badge Remplacé signale une fonction ainsi réglée. Modifier ouvre le formulaire Modifier le remplacement : vous pouvez y changer chaque champ, y compris la fonction et la capacité, et Enregistrer met à jour ce remplacement (il n'en crée pas un second). Annuler la modification referme le formulaire sans rien changer. Retirer rend à la fonction le fournisseur et le modèle de sa capacité. Une fonction sans remplacement se comporte exactement comme avant.

Une fonction a au plus un remplacement par capacité : si la fonction et la capacité choisies en ont déjà un, l'enregistrement est refusé et le message nomme la fonction ; modifiez alors le remplacement existant.

• Une capacité sur Aucun coupe toutes ses fonctions, même remplacées.
• Si le fournisseur choisi pour une fonction n'est plus disponible (licence de l'IA de l'éditeur échue, par exemple), la fonction reprend celui de sa capacité.
• Les embeddings ne se remplacent pas par fonction (Non remplaçable) : l'indexation et la recherche doivent utiliser le même modèle.
• Le fournisseur d'une fonction doit être réglé dans son onglet (clé, adresse) : sans clé, l'appel échoue.

Quand l'IA est désactivée (« Aucun »)

Pour couper toute l'IA, mettez les deux choix sur Aucun (IA désactivée) : c'est la situation d'une instance qui vient d'être installée. Aucun appel ne part alors vers un service extérieur, et rien n'est inscrit dans l'Usage de l'IA.

Provider de chat actif sur Aucun : le badge IA désactivée s'affiche en tête de l'écran.

• Tous les boutons d'IA disparaissent : Service Desk, Base de connaissances, Gestion des changements, Gestion des problèmes, Mises en production, Gestion des événements. Les écrans restent complets et tout se fait à la main.
• La bulle du chatbot n'apparaît plus sur les bases de connaissances publiques.

Provider d'embeddings actif sur Aucun : le badge Recherche sémantique désactivée s'affiche. La recherche dans les bases de connaissances se fait en plein texte (sur les mots), et le chatbot ne retrouve plus de passages d'articles pour appuyer ses réponses.

Les deux choix sont indépendants : avec un fournisseur d'embeddings mais aucun fournisseur de chat, les assistants disparaissent mais la recherche sémantique continue, et donc les appels au fournisseur d'embeddings aussi.

Dans tous les cas, les clés et réglages des fournisseurs restent enregistrés : resélectionner un fournisseur suffit à tout rétablir.

Voir aussi

• « Suivre l'usage de l'IA » : consommation, plafonds et journal.
• « Lire des documents avec l'IA » et « Produire des images avec l'IA » : ce que font ces capacités, ce qui part chez le fournisseur.