Aller au contenu

Assistant IA

À la réception d’une commande fournisseur, KiwiDesk peut lire le bon de livraison PDF (y compris scanné) pour préremplir les quantités reçues. Sans assistant, il lit le texte du PDF et retrouve les références de la commande : cela marche bien avec les PDF générés par un logiciel, moins avec les scans. L’assistant IA est facultatif.

Le réglage vaut pour toute l’instance et est réservé aux super administrateurs.

Fournisseur Ce qui est envoyé Clé Modèle par défaut
Claude (API Anthropic) le PDF lui-même console Anthropic claude-opus-5-5
Gemini (API Google) le PDF lui-même (jusqu’à 50 Mo) https://aistudio.google.com/apikey gemini-3.8-flash
Serveur compatible OpenAI (Ollama, LM Studio, vLLM) le texte du PDF seulement facultative llama3.1

Le bon de livraison contient des données fournisseurs, articles et prix, mais aucune donnée client.

  1. Ouvrez Paramètres > API & Webhooks, onglet Assistant IA.
  2. Choisissez le Fournisseur.
  3. Saisissez la Clé API (et, pour un serveur compatible OpenAI, l’Adresse du serveur, terminée par /v1, par exemple http://192.168.1.30:11434/v1 pour Ollama).
  4. Gardez le Modèle proposé ou saisissez-en un autre : le champ est libre, pour suivre les nouveaux modèles des éditeurs.
  5. Cliquez sur Tester : KiwiDesk vérifie la clé et le modèle. Pour Gemini, le test lit seulement la description du modèle et ne consomme rien.
  6. Cliquez sur Enregistrer.
Onglet Assistant IA : explication du rôle de l'assistant et liste des fournisseurs.

La clé est chiffrée, n’est jamais réaffichée, et est effacée si vous changez de fournisseur sans en saisir une nouvelle : une clé n’est jamais envoyée à un autre éditeur. Chaque modification est inscrite au journal d’audit.

  • Confidentialité de Gemini : avec l’offre gratuite de l’API Gemini, Google peut utiliser les données envoyées pour améliorer ses produits. Activez la facturation du projet Google (offre payante) ou choisissez un autre fournisseur pour les documents sensibles.
  • Tout garder sur place : le serveur compatible OpenAI (Ollama, LM Studio) tourne sur une machine de la boutique ; rien ne sort du réseau local. Il ne reçoit que le texte du PDF, donc les scans sans texte sont moins bien lus.
  • Modèle retiré : quand un éditeur retire un modèle, saisissez son successeur. Pour Gemini, gemini-flash-latest suit automatiquement la dernière version Flash, au prix de changements que vous ne choisissez pas.
  • Quota atteint : avec Gemini, le message « Quota Gemini atteint, réessayez plus tard » s’affiche et la lecture par les références prend le relais.
  • Le serveur KiwiDesk doit pouvoir joindre l’éditeur en HTTPS (pare-feu sortant, proxy).

Quand l’assistant n’est pas utilisé ou échoue, la réception l’indique et passe à la lecture par les références : rien n’est bloqué. Vérifiez alors la clé avec Tester, le nom du modèle, et que le serveur sort bien sur Internet. La réception elle-même est décrite dans Achats et bons de livraison.