Aller au contenu

Configurer la Plataforma de Recepción Inteligente

Définir les types de documents attendus

Section titled “Définir les types de documents attendus”

Chaque cycle attend des types précis (NIF, certificat d’activité, mémoire économique). Le catalogue est réutilisé entre les cycles.

  1. Ouvrez Recepción Inteligente → Configuration → Types de documents. Si votre instance est fédérée avec le canon documentaire, les types de base du secteur sont déjà chargés ; ne les dupliquez pas.
  2. Pour en ajouter un, cliquez sur Créer et remplissez Code (court, minuscules, sans espaces ; utilisé par la classification IA et ne devrait pas changer), Nom, Domaine (identification, formulation, exécution ou justification) et Instructions pour l’agent IA. Plus elles sont précises, mieux c’est : “document avec NIF/CIF, raison sociale et adresse fiscale ; une page, PDF AEAT”.
  3. Enregistrez. Le type est disponible pour les flux et les cycles.

Créer un flux et un cycle de collecte

Section titled “Créer un flux et un cycle de collecte”

Le flux est le modèle (types, destinataires, ton). Le cycle est une instance concrète du flux sur une période.

  1. Ouvrez Recepción Inteligente → Configuration → Flux et cliquez sur Créer.
  2. Remplissez Nom, Origine des destinataires (l’une des six valeurs canon : membres généraux, utilisatrices internes, personnalisé, organisations partenaires réceptrices du projet, financeurs du projet, équipe du projet), Projet si l’origine est liée au projet, et Profil de style.
  3. Dans Types attendus, ajoutez les types du catalogue qui seront demandés. Dans Politique de rappels, éditez les Règles d’escalade (section dédiée ci-dessous). Enregistrez.
  4. Revenez à Recepción Inteligente → Cycles, cliquez sur Créer, associez le cycle au flux et définissez Date de début et Date de fin.
  5. Cliquez sur Ouvrir dans l’en-tête. Le système génère une demande documentaire par destinataire avec son lien unique et envoie l’e-mail de démarrage.

Ajuster le seuil de confiance

Section titled “Ajuster le seuil de confiance”

Le seuil décide quand le système valide automatiquement un document et quand il le laisse en attente.

  1. Pour la valeur par défaut, ouvrez Paramètres → Technique → Paramètres du système et cherchez coop_documentation.classification_threshold. Sa valeur par défaut est 0.7.
  2. Pour la remplacer dans un flux précis, ouvrez le flux et remplissez Seuil de confiance. La valeur 0,0 signifie « utiliser le paramètre par défaut du système ».
  3. Si vous activez le portail avec vérification, ajustez coop_documentation.verify_threshold (par défaut 0.7) pour la vérification croisée entre le type déclaré par la personne destinataire et celui détecté par l’agent IA.

Connecter le modèle IA

Section titled “Connecter le modèle IA”

La plateforme utilise le modèle IA configuré pour l’instance. Ouvrez Configuration → Modèle IA et vérifiez qu’il a le Type : chat (les modèles d’embeddings sont écartés). Pour prioriser un modèle par type de document, associez-le dans le champ Modèle IA du type quand c’est disponible. [VERIFY: ticket multi-modelo per-tipo pendiente.]

Configurer la politique de rappels escaladés

Section titled “Configurer la politique de rappels escaladés”

Quand une demande documentaire est en retard, le cron quotidien décide s’il faut envoyer un rappel et à quel niveau. La politique vit dans le flux sous forme d’un JSON court.

  1. Ouvrez le flux et allez à Politique de rappels.
  2. Règles d’escalade accepte une liste de trois entrées, une par niveau (1 cordial, 2 assertif, 3 urgent). Chaque entrée comporte tier (1, 2 ou 3) et days_after_deadline (jours après l’échéance ; une valeur négative déclenche des pré-avis avant l’échéance).
  3. Exemple canonique : [{"tier": 1, "days_after_deadline": -3}, {"tier": 2, "days_after_deadline": 2}, {"tier": 3, "days_after_deadline": 7}] produit un pré-avis cordial 3 jours avant la clôture, un assertif 2 jours après et un urgent à la semaine.
  4. Une liste vide ([]) signifie silence : le flux n’envoie pas de rappels automatiques. Le plafond est fixé à 3 niveaux ; les supplémentaires sont ignorés et enregistrés dans le journal.
  5. Enregistrez. Le cron applique la politique à sa prochaine exécution.

Programmer et surveiller le cron quotidien

Section titled “Programmer et surveiller le cron quotidien”

L’envoi automatique tourne comme action planifiée Odoo dans Paramètres → Technique → Automatisation → Actions planifiées → Recepción Inteligente: enviar recordatorios pendientes. Par défaut, il s’exécute chaque jour à 08:00 UTC : maintenez une seule exécution quotidienne et ajustez l’heure si vous travaillez sur une autre plage horaire. Pour auditer une exécution, cherchez dans le journal du serveur les lignes contenant coop_documentation._cron_send_pending_followups.

Résolution des problèmes fréquents

Section titled “Résolution des problèmes fréquents”
  • Le cron tourne mais n’envoie rien. Le flux a des règles vides ([] est un silence délibéré) ou les demandes n’ont pas d’e-mail.
  • Les rappels arrivent dans les spams. L’expéditeur du cron ne correspond pas à l’adresse autorisée sur le serveur d’e-mail. Dans DonDominio, Postfix ou SES, l’adresse doit correspondre au Responsable du cycle.
  • L’agent IA classe avec une confiance très basse. Les Instructions du type sont trop succinctes. Enrichissez-les avec des exemples du format attendu.

Prochaines étapes

Section titled “Prochaines étapes”