# Documentation Diadems — contexte complet > Copie consolidée de la documentation publique. Mise à jour automatiquement à chaque build. --- # Abonnement et factures > Gérer l’abonnement propre à chaque agent et retrouver les justificatifs. Chaque agent dispose de son propre abonnement mensuel. Le prix dépend de l’offre et du rythme choisis lors de sa création. ## Consulter l’abonnement Ouvrez **Agent → Configuration → Mon abonnement** pour voir son état et sa prochaine échéance. Selon la situation, vous pouvez terminer un paiement, programmer une résiliation ou reprendre un abonnement dont la fin était programmée. L’abonnement est sans engagement. Une résiliation arrête le renouvellement selon la date indiquée dans l’interface ; elle ne supprime pas immédiatement les données de l’agent. ## Droit de rétractation Lorsqu’il s’applique, le bouton **Exercer mon droit de rétractation (14 j)** est présent dans la configuration. L’écran récapitule les conséquences avant confirmation, notamment pour un service dont l’exécution a déjà commencé. Pour les conditions contractuelles complètes, consultez les [Conditions générales](/cgv). ## Retrouver une facture 1. Ouvrez **Mon compte**. 2. Sélectionnez **Factures**. 3. Repérez la date, le numéro, le montant et le statut. 4. Téléchargez le PDF ou ouvrez la facture en ligne. Les coordonnées professionnelles et de facturation se règlent dans **Mon compte**. Vérifiez-les avant le prochain paiement pour qu’elles apparaissent correctement sur les nouveaux documents. :::danger[Résilier ou supprimer] Résilier arrête le renouvellement. **Supprimer l’agent** détruit sa mémoire, ses fichiers et ses accès : cette seconde action est définitive. ::: --- # Collaboration d'équipe > Utiliser les notes privées, les salons et les messages directs de Diadems. Diadems sépare les échanges avec vos agents de la collaboration entre humains. L'espace **Équipe** permet de discuter sans ajouter ces messages au contexte de vos agents. ## Salons d'équipe Tous les membres actifs accèdent aux salons de l'organisation. Le salon **général** est créé automatiquement. Le propriétaire et les administrateurs peuvent créer d'autres salons, préciser leur sujet, les renommer ou les archiver. Dans un salon, vous pouvez répondre à un message, mentionner un membre avec `@`, modifier vos propres messages et copier rapidement un contenu. Les administrateurs peuvent aussi supprimer un message lorsque cela est nécessaire. ## Messages privés Cliquez sur un membre pour ouvrir une conversation directe. Seuls les deux participants peuvent la consulter. Un message privé n'est pas visible par les autres membres ni par les agents. ## Notes privées de session Le **Centre de mission** propose une note personnelle pour la session affichée. Elle peut contenir un titre, des listes, des tâches et vos repères de suivi. La note est enregistrée automatiquement et peut être épinglée ou supprimée. Une note reste strictement liée à son auteur. Même un administrateur autorisé à consulter la session ne peut pas lire la note privée d'un autre membre. ## Activité partagée d’un agent Lorsque plusieurs personnes ou canaux utilisent simultanément un agent, le **Centre de mission** peut afficher plusieurs activités. Il indique uniquement le prénom d’usage du membre — par exemple « travaille avec Lina » — ou un type générique comme e-mail, Telegram, événement automatique ou tâche planifiée. Cette présence ne révèle jamais le titre d’une session, son contenu, les outils utilisés, l’expéditeur d’un e-mail ou le contenu d’un webhook. Le détail de votre propre mission reste visible dans votre navigateur ; les autres activités sont volontairement réduites à cette indication minimale. :::note[Stockage séparé des agents] Les notes, salons et messages sont stockés dans le control plane Diadems, avec leur contenu chiffré avant écriture dans PostgreSQL. Ils ne sont jamais copiés dans une capsule, envoyés à Hermes ou transmis à un fournisseur de modèle IA. ::: --- # Budget et réserve > Suivre le cycle en cours et garder la consommation de chaque agent sous contrôle. La page **Budget** donne une vue globale de la consommation de votre organisation. La configuration de chaque agent détaille son forfait et sa réserve. ## Comprendre le cycle Le forfait se recharge à chaque nouveau cycle mensuel. La page indique : - la part du forfait déjà utilisée ; - une projection à la fin du cycle ; - les dates de début et de fin ; - la consommation répartie par agent ; - les plafonds applicables. La projection est une estimation basée sur l’activité observée, pas un débit programmé. ## Forfait puis réserve Avec un modèle fourni par Diadems, l’agent utilise d’abord le budget inclus dans son forfait : 10 € avec Essentiel, 20 € avec Pro et 30 € avec Équipe. Une fois ce volume épuisé, il peut continuer avec la **Réserve** disponible. Le plafond quotidien protège uniquement le budget inclus. Il ne limite pas une réserve déjà achetée. Lorsque l’agent utilise votre propre clé API ou votre abonnement OpenAI, son texte n’est décompté ni du forfait Diadems ni de la réserve. Les services externes fournis par Diadems, comme la recherche et la lecture web, restent mesurés séparément même dans ces modes. Leur consommation réelle apparaît en euros dans le budget de l’agent. La réserve se recharge volontairement depuis les montants proposés. Le solde restant est reporté d’un mois sur l’autre tant que les conditions du service sont remplies. ## Recharge automatique Dans **Agent → Configuration → Forfait & réserve** : 1. définissez un plafond mensuel ; 2. activez la recharge automatique ; 3. vérifiez le montant et l’état de l’option. Lorsque forfait et réserve sont épuisés, l’agent peut alors recharger dans la limite fixée. Désactivez l’option pour repasser à des recharges manuelles. :::caution[Deux recharges différentes] La **recharge de quota** remet à zéro les compteurs jour/semaine. La **recharge de réserve** achète du volume supplémentaire après le forfait. Les deux actions ne sont pas interchangeables. ::: Si un plafond est atteint, l’agent conserve ses données mais peut refuser de nouvelles missions jusqu’au renouvellement ou à une recharge autorisée. --- # Profil et équipe > Mettre à jour le compte, sécuriser l’accès et inviter les bons collaborateurs. La page **Mon compte** regroupe vos informations personnelles, votre organisation, la facturation et les accès de l’équipe. ## Modifier le profil Vous pouvez mettre à jour votre prénom, votre nom et la langue de l’interface. Enregistrez chaque section avant de quitter la page. Pour changer de mot de passe, saisissez le mot de passe actuel puis le nouveau. Utilisez une phrase de passe unique, différente de celle de votre messagerie. ## Configurer la facturation Indiquez si le compte est utilisé à titre particulier ou professionnel. Pour une entreprise, complétez la raison sociale, l’adresse et les informations fiscales demandées. Ces données alimentent les prochaines factures. ## Inviter un membre Le forfait **Équipe** ouvre le même agent à plusieurs membres, dans la limite de ses sièges. Les forfaits Essentiel et Pro restent réservés au propriétaire : 1. ouvrez la section **Équipe** ; 2. indiquez le prénom que les agents doivent employer avec cette personne ; 3. saisissez l’adresse e-mail du collaborateur ; 4. choisissez son rôle ; 5. pour un utilisateur, sélectionnez les agents puis les sections visibles ; 6. envoyez l’invitation et vérifiez le compteur de sièges utilisés. Le lien de création de compte reste valable pendant **7 jours**. La fiche du membre indique si l’invitation est encore en attente ou si elle a expiré. Dans les deux cas, **Renvoyer** crée un nouveau lien de 7 jours et invalide le précédent. Le **prénom utilisé par les agents** appartient au siège dans cette organisation. Il peut donc être différent du nom du titulaire du compte Diadems. Un propriétaire ou un administrateur peut le corriger depuis la fiche du membre, sans modifier son identité de facturation, son adresse e-mail, son rôle ou ses accès. Les prochains messages envoyés à l’agent utilisent immédiatement ce prénom authentifié. Inviter un membre n’ajoute pas de coût par lui-même : la limite dépend de l’offre. Lorsque tous les sièges sont occupés, retirez un accès inutile ou passez à une offre adaptée. ## Administrateur ou utilisateur - **Propriétaire payeur** : conserve le compte, l’abonnement et tous les accès. - **Administrateur** : gère l’équipe, la facturation et toute la configuration des agents. - **Utilisateur** : ne voit que les agents attribués. Pour chaque agent, un administrateur choisit les sections du cockpit disponibles. Le chat reste toujours accessible. Un administrateur peut rouvrir **Gérer** à tout moment pour modifier le prénom d’usage, le rôle, les agents ou les sections sans renvoyer d’invitation. Pour un utilisateur, il peut aussi activer **Peut limiter la visibilité de ses sessions**. ## Partager et piloter une session Les sessions d'un utilisateur sont **standard** par défaut : tous les administrateurs de l'organisation peuvent les consulter. Les sessions d'un propriétaire ou d'un administrateur sont **restreintes** par défaut et ne sont visibles que par leur créateur et les participants invités. Un utilisateur autorisé peut choisir lui aussi le mode restreint avant son premier message. Dans le **Centre de mission**, ouvrez **Collaboration** pour : 1. choisir une visibilité standard ou restreinte quand vous y êtes autorisé ; 2. inviter les membres qui ont déjà accès au chat de cet agent ; 3. voir le pilote actuel ; 4. donner la main à un participant lorsque l'agent a terminé et que la file de messages est vide. Les participants voient le transcript et les nouvelles données produites en direct, mais une seule personne pilote la session. Un administrateur peut prendre la main sur une session standard d'utilisateur lorsqu'elle est au repos. L'ancien pilote passe immédiatement en lecture seule et ne peut pas reprendre la main sans nouveau transfert. :::caution[Visibilité du fil et mémoire de l'agent] Le mode restreint limite l'accès au fil dans le portail. Il ne crée pas une mémoire étanche dans l'agent : dans le contexte de l'organisation, l'agent peut réutiliser dans une autre session ce qu'il a appris auparavant. ::: ## Suivre la consommation La section **Consommation par utilisateur** récapitule les appels, les tokens et leur montant en euros sur les 30 derniers jours. Dépliez une ligne pour consulter la répartition par modèle. Les missions autonomes et les autres canaux sont regroupés séparément. ## Retirer un accès Cliquez sur **Retirer** à côté du membre concerné et confirmez. Son siège est libéré et il ne peut plus utiliser l’espace partagé. Le propriétaire et les administrateurs conservent les actions sensibles de gestion du compte. Utilisez **Se déconnecter** sur un appareil partagé. --- # Sécurité et confidentialité > Comprendre les protections Diadems et les contrôles qui restent entre vos mains. Diadems opère l’infrastructure et l’intelligence de l’agent. Vous définissez ses accès, ses correspondants autorisés et les actions que vous validez. ## Un espace isolé par agent Chaque agent travaille dans une capsule isolée avec ses propres ressources, fichiers et limites. Il n’accède pas aux espaces des autres agents. L’espace de travail est hébergé en France. Les indications de localisation affichées avec l’offre ou le modèle précisent le périmètre de traitement applicable. ## Secrets protégés Les identifiants ajoutés au **Coffre** sont chiffrés et leur valeur n’est pas réaffichée. Dans une consigne, référencez uniquement le nom du secret. Diadems peut fournir et gérer l’accès aux modèles France/UE. Vous pouvez aussi choisir votre propre clé API ou connecter votre abonnement OpenAI. Les clés personnelles sont chiffrées et ne sont jamais réaffichées en clair. La recherche et la lecture de pages web passent par un accès Firecrawl géré par Diadems. La clé du fournisseur n’est jamais placée dans l’espace de l’agent : sa capsule utilise uniquement un accès propre à cet agent, révocable et isolé des autres clients. ## Accès limités par vous - Les contacts e-mail doivent faire partie de la liste autorisée. - Un canal doit être associé explicitement à l’agent. - Les membres de l’équipe occupent des sièges identifiés. - Un accès tiers, comme Google, GitHub ou Grok, peut être révoqué depuis le portail. - Une action sensible peut être soumise à validation. L’adresse e-mail gérée par Diadems fonctionne dans un périmètre fermé : l’agent peut répondre sans validation message par message, mais uniquement aux contacts autorisés et dans le sens choisi. Les autres actions sensibles restent soumises aux validations configurées. ## Vos responsabilités Relisez les résultats avant de les publier ou de prendre une décision importante. N’accordez que les accès nécessaires et retirez-les dès qu’ils ne servent plus. Évitez de placer des données sensibles dans une consigne lorsqu’elles ne sont pas indispensables. ## Suppression La suppression d’un agent détruit son espace, sa mémoire et ses accès. Exportez d’abord les fichiers que vous souhaitez conserver. Pour les règles de conservation et l’exercice de vos droits, consultez la [Politique de confidentialité](/confidentialite). --- # Modèle, paiement et voix > Choisir la source d’intelligence, le modèle et la voix de l’agent. Le **modèle** est le moteur d’intelligence de l’agent. La **voix** détermine le rendu de ses réponses lues à haute voix et de ses notes vocales. ## Choisir la source d’intelligence Ouvrez **Agent → Configuration → Modèle et paiement**. Trois modes sont proposés : - **Modèles Diadems** : modèles traités en France ou dans l’Union européenne, utilisables sans clé externe ; - **Ma clé API** : appel direct au fournisseur choisi avec votre propre clé ; - **Mon abonnement OpenAI** : utilisation de votre compte ChatGPT/Codex après sa connexion depuis **Mon compte**. Le catalogue Diadems affiche le lieu de traitement garanti, le niveau d’intelligence et les tarifs d’entrée et de sortie. Le drapeau **France** ou **UE** correspond au lieu d’inférence du modèle. Les modifications restent en attente tant que vous n’avez pas sélectionné **Valider et appliquer**. L’agent conserve sa capsule et ses données ; seul son gateway Hermes redémarre pour charger la nouvelle configuration. Diadems vous demande alors une confirmation explicite et rappelle qu’une exécution en cours peut être interrompue, ce qui permet de vérifier d’abord l’activité d’un agent partagé. ## Comprendre le paiement Avec les **Modèles Diadems**, l’usage est décompté du budget inclus, puis de la réserve rechargeable. Le budget inclus est de 10 € pour Essentiel, 20 € pour Pro et 30 € pour Équipe à chaque cycle mensuel. Avec une **clé API personnelle** ou un **abonnement OpenAI**, le texte n’utilise pas le budget IA Diadems. Le fournisseur ou l’abonnement concerné applique ses propres limites et conditions. :::note[Voix et abonnement OpenAI] Un abonnement ChatGPT/Codex ne comprend pas l’API audio OpenAI. La transcription et la synthèse vocale peuvent donc continuer à utiliser le budget voix Diadems, contrairement au texte. Avec une clé API OpenAI personnelle, l’audio est facturé directement sur cette clé. ::: ## Choisir une voix 1. Ouvrez **Agent → Configuration**. 2. Descendez jusqu’à **La voix de l’agent**. 3. Cliquez sur **Écouter** pour comparer les extraits. 4. Sélectionnez la voix voulue. Le nouveau choix s’applique au bouton **Écouter** du chat et aux notes vocales envoyées par les canaux compatibles. :::tip[Choisissez pour l’usage réel] Une voix sobre convient aux comptes-rendus ; une voix plus expressive peut être préférable pour l’accueil ou les messages courts. Testez-la avec une réponse typique de votre activité. ::: Si aucun son ne démarre, vérifiez le volume et l’autorisation de lecture audio du navigateur, puis réessayez avec un extrait. --- # Profil, ressources et coffre > Lire l’état de l’agent, gérer son espace et protéger ses identifiants tiers. La fiche d’un agent rassemble son identité, son état de service et les ressources qui lui sont attribuées. ## Lire le tableau de bord En haut de la fiche, vérifiez le nom, l’état et la dernière activité. Les jauges de stockage ou de mémoire deviennent particulièrement visibles lorsqu’elles approchent de leur limite. Sélectionnez le portrait de l’agent pour choisir ou remplacer sa photo. Le nouveau visuel est utilisé sur sa fiche et dans les repères du portail. L’onglet **Activité** présente les quatorze derniers jours : - requêtes traitées et éventuelles erreurs ; - volume de traitement ; - dernière activité connue ; - journal technique utile au diagnostic. Une absence d’activité n’est pas une erreur si aucune mission n’a été confiée. ## Gérer les fichiers et le stockage Le stockage contient les fichiers de travail durables de l’agent. Consultez la jauge dans **Fichiers**. Si l’espace devient insuffisant, supprimez les fichiers inutiles ou utilisez **Ajouter du stockage** lorsque l’option est proposée. La mémoire conversationnelle et le stockage de fichiers sont deux ressources différentes : supprimer un fichier ne retire pas automatiquement un fait mémorisé. ## Utiliser le coffre Le **Coffre** conserve les mots de passe, jetons ou clés nécessaires à un service tiers. Pour ajouter un secret : 1. choisissez un nom explicite en majuscules, par exemple `GOOGLE_API_KEY` ; 2. collez sa valeur ; 3. enregistrez ; 4. donnez à l’agent uniquement le **nom** du secret à utiliser. La valeur est chiffrée et n’est pas réaffichée en clair. Par exemple, dites : > Utilise `GOOGLE_API_KEY` pour cette mission. Ne recopiez jamais la valeur dans le chat, la mémoire ou un fichier. :::note[Clés de modèle] Vous n’avez aucune clé de modèle à fournir pour utiliser les modèles France/UE gérés par Diadems. Si vous choisissez **Ma clé API** dans **Modèle et paiement**, la clé du fournisseur se configure dans ce panneau dédié, pas comme un secret de mission ordinaire. ::: Supprimer une entrée du coffre retire l’accès correspondant lors des prochaines missions. Vérifiez d’abord qu’aucune automatisation n’en dépend. GitHub et Grok disposent d’un bouton de connexion officiel dans ce même onglet. Pour ces deux comptes, aucun jeton n’est enregistré dans la base Diadems : il reste dans l’espace privé de la capsule de l’agent. GitHub autorise les dépôts, pull requests et Actions ; Grok permet à Hermes d’utiliser un abonnement SuperGrok ou X Premium+. Chaque connexion peut être révoquée séparément. --- # Rythme de travail > Comprendre les heures, jours, quotas et recharges de l’agent. Le rythme de travail transforme l’offre de l’agent en un volume quotidien et hebdomadaire. Il sert à dimensionner l’abonnement et à garder la consommation prévisible. ## Lire le rythme Dans **Configuration → Rythme de travail**, vous retrouvez : - le nombre d’heures par jour ; - le nombre de jours actifs par semaine ; - le prix mensuel du forfait ; - l’usage du jour et de la semaine ; - le nombre de recharges encore disponibles. Les heures sont une représentation du budget d’usage de l’offre. La durée réelle d’une mission varie selon sa complexité et les outils employés. ## En dehors des jours actifs L’agent reste joignable. S’il travaille en dehors du planning, il puise dans son volume inclus et les limites du forfait continuent de s’appliquer. Les tâches planifiées et les déclencheurs utilisent le même budget que les missions démarrées dans le chat. ## Utiliser une recharge Le bouton **Utiliser une recharge** remet à zéro les compteurs du jour et de la semaine. Le nombre disponible est affiché avant l’action. Utilisez-la lorsqu’une mission prioritaire doit continuer après épuisement du quota. Une recharge ne change pas l’offre mensuelle et ne remplace pas la réserve en euros. :::caution[Consommation récurrente] Avant d’ajouter de nombreuses automatisations, testez chacune manuellement et surveillez **Activité** ainsi que la page **Budget**. ::: --- # Créer son compte > Inscription, confirmation d’e-mail, connexion et récupération du mot de passe. ## S’inscrire Depuis [diadems.fr](https://diadems.fr), sélectionnez **Créer un compte**. Renseignez : - votre adresse e-mail ; - un mot de passe d’au moins 8 caractères ; - votre nom ; - votre situation personnelle ou professionnelle ; - les informations de société demandées si vous créez un compte professionnel. L’inscription implique l’acceptation des conditions générales et de la politique de confidentialité accessibles depuis le formulaire. ## Confirmer l’adresse e-mail Après l’inscription, Diadems envoie un lien de confirmation. Ouvrez ce lien dans le même navigateur ou connectez-vous ensuite normalement. Si le message n’arrive pas : 1. vérifiez les courriers indésirables ; 2. vérifiez l’adresse affichée sur l’écran **Vérifiez votre e-mail** ; 3. utilisez **Renvoyer l’e-mail** ; 4. recommencez l’inscription si l’adresse est incorrecte. ## Se connecter Ouvrez [la page de connexion](https://diadems.fr/login), puis saisissez votre e-mail et votre mot de passe. Un compte non confirmé ne peut pas accéder au portail. L’écran de connexion propose alors de renvoyer l’e-mail de vérification. ## Mot de passe oublié 1. Depuis la connexion, choisissez **Mot de passe oublié ?** 2. Saisissez votre adresse e-mail. 3. Ouvrez le lien reçu. 4. Définissez et confirmez le nouveau mot de passe. Pour votre sécurité, un lien expiré ou déjà utilisé doit être remplacé par une nouvelle demande. ## Modifier son profil ou son mot de passe Une fois connecté, ouvrez **Mon compte**. Vous pouvez y modifier votre nom, la langue du portail et votre mot de passe. L’adresse e-mail du compte ne se modifie pas directement depuis cette page. --- # Créer un agent > Les étapes Nom, Offre et Paiement du parcours de création d’un agent Diadems. Depuis le [Dashboard](https://diadems.fr/app), sélectionnez **Créer un agent**. ## 1. Nom Diadems propose un nom que vous pouvez conserver ou modifier à cette étape. Choisissez un nom facile à reconnaître dans le chat, les notifications et les canaux externes. ## 2. Offre Choisissez l’offre adaptée à la charge de travail et aux fonctions attendues. La page indique le prix mensuel, les ressources incluses et les conditions de l’offre. Un agent correspond à un abonnement. Si vous créez plusieurs agents, chacun dispose de son propre abonnement et de sa propre capsule isolée. ## 3. Paiement Vérifiez le récapitulatif avant de continuer vers le paiement sécurisé. Pour une exécution immédiate, le formulaire peut demander votre accord explicite sur le démarrage du service avant la fin du délai de rétractation. Après confirmation du paiement, Diadems : 1. crée l’agent ; 2. prépare son environnement isolé ; 3. installe sa configuration ; 4. l’affiche sur votre Dashboard. La fiche peut indiquer **En préparation** pendant cette installation. :::caution[Ne relancez pas immédiatement un second paiement] Si le retour du paiement semble lent, revenez au Dashboard et vérifiez si l’agent existe déjà. En cas de doute, contactez l’assistance avec l’heure du paiement et l’adresse e-mail du compte. ::: ## Après la création Ouvrez la fiche de l’agent, attendez l’état **Opérationnel**, puis rendez-vous dans **Chat** pour lui confier sa première mission. --- # Confier une première mission > Comment formuler une demande utile et laisser l’agent compléter son onboarding par la conversation. Ouvrez votre agent depuis le Dashboard. L’onglet **Chat** est l’espace principal pour lui confier du travail et préciser son rôle. ## Formuler la demande Une mission utile précise : - **le résultat** : ce qui doit être livré ; - **le contexte** : activité, destinataire, contraintes ; - **les ressources** : fichiers, e-mails, sites ou informations disponibles ; - **l’échéance** : ponctuelle ou récurrente ; - **la validation** : ce que l’agent peut préparer et ce que vous devez approuver. Vous pouvez écrire naturellement. Il n’est pas nécessaire d’utiliser une syntaxe spéciale. ## Laisser l’agent poser ses questions Votre agent peut demander les informations qui lui manquent. Répondez au fil de la conversation. Les préférences durables peuvent ensuite être conservées dans sa mémoire. ## Ajouter des ressources Le bouton **+** du composeur permet d’ajouter : - une photo prise avec l’appareil ; - une image de la galerie ; - un fichier ; - un niveau d’intelligence lorsque cette option est proposée. Les images rejoignent directement le message. Les autres fichiers sont placés dans l’espace de travail de l’agent et leur chemin lui est transmis. ## Suivre l’exécution Pendant une mission, le chat affiche sa progression et les actions enregistrées. Vous pouvez arrêter la réponse en cours. Une mission terminée peut présenter un résumé, sa durée, les domaines mobilisés et le déroulé des étapes. :::note[Votre agent reste sous votre contrôle] Une action sensible peut s’arrêter et demander votre feu vert. Pour l’e-mail, l’envoi exige toujours une validation humaine. ::: --- # Premiers pas > Le parcours le plus court pour passer du compte vide à une première mission confiée à votre agent. Diadems prépare et opère un employé numérique durable pour vous. Vous n’avez ni clé API à acheter, ni serveur à administrer, ni abonnement IA séparé à configurer. ## Le parcours en quatre étapes 1. **Créez votre compte** et confirmez votre adresse e-mail. 2. **Nommez votre agent**, choisissez son offre et validez l’abonnement. 3. **Ouvrez sa fiche**, puis l’onglet **Chat**. 4. **Décrivez le résultat attendu** comme vous le feriez avec un nouveau collaborateur. Votre agent peut ensuite vous poser les questions nécessaires : contexte, priorités, ton, ressources disponibles et règles de validation. ## Où retrouver votre agent Le [tableau de bord Diadems](https://diadems.fr/app) affiche chaque agent sous forme de carte avec : - son état actuel ; - ses canaux connectés ; - sa consommation du cycle ; - sa dernière activité ; - le nombre d’éléments qui attendent votre validation. Sélectionnez une carte pour ouvrir la fiche complète de l’agent. ## Les trois espaces à connaître - **Dashboard** : vue d’ensemble des agents, du budget en euros et des dernières factures. - **Fiche agent** : chat, sessions, fichiers, e-mail, tâches, compétences, mémoire, canal, activité et configuration. - **Mon compte** : profil, mot de passe, équipe, coordonnées de facturation, abonnement et factures. :::tip[Commencez simplement] Une bonne première mission tient en trois éléments : le résultat souhaité, les informations disponibles et la façon dont vous voulez valider le travail. ::: ## Exemple de première demande > Chaque matin, résume mes nouveaux e-mails, classe-les par urgence et prépare > une réponse pour les trois plus importants. Ne réponds jamais sans mon accord. Vous pourrez ensuite connecter l’e-mail, ajouter les contacts autorisés et transformer cette demande en tâche planifiée. --- # États d’un agent > Interpréter les indicateurs affichés avant de lancer un diagnostic. L’état visible sur la fiche indique si l’agent peut recevoir une nouvelle mission. Il ne décrit pas la qualité d’une réponse particulière. | État | Signification | Action conseillée | | --- | --- | --- | | **En préparation** | L’espace sécurisé et le moteur démarrent. | Patientez puis actualisez la fiche. | | **En ligne / opérationnel** | L’agent est prêt à recevoir une mission. | Vous pouvez utiliser le chat ou un canal. | | **Travaille** | Une mission est en cours. | Laissez l’onglet ouvert ou revenez plus tard : la réponse se synchronise. | | **En pause** | Le cycle, le quota ou l’abonnement empêche un nouveau travail. | Lisez le bandeau du chat et la section Budget. | | **Suspendu** | L’accès de l’agent est temporairement arrêté. | Vérifiez l’abonnement ou contactez Diadems. | | **Action Diadems requise** | Le démarrage a rencontré un problème technique. | Ouvrez Activité, puis contactez l’assistance si l’état persiste. | ## État de l’agent et état d’une tâche Une tâche planifiée possède son propre état **Active** ou **En pause**. Un agent peut être en ligne alors qu’une tâche précise est suspendue. De même, **Telegram connecté**, **boîte e-mail active** et **Google connecté** sont des états d’intégration distincts. ## Quand patienter Après la création, un démarrage ou une reprise, la préparation peut prendre un moment. N’envoyez pas plusieurs fois la même mission : attendez que le composeur soit actif et que le statut passe en ligne. Si l’état ne change pas après quelques minutes, ouvrez **Activité** et suivez le guide [Résoudre un problème](/docs/depannage/resoudre-un-probleme/). --- # Questions fréquentes > Réponses rapides sur les agents, les budgets, les données et les accès. ## Ai-je besoin d’une clé ou d’un abonnement d’intelligence artificielle ? Non. Les modèles France/UE fournis par Diadems fonctionnent sans clé externe. Vous pouvez toutefois choisir d’utiliser votre propre clé API ou votre abonnement OpenAI depuis **Agent → Configuration → Modèle et paiement**. ## Un abonnement couvre-t-il tous mes agents ? Non. Chaque agent est un employé numérique durable avec son propre abonnement, son offre et son espace isolé. ## L’agent peut-il continuer quand je ferme la page ? Oui. Une mission déjà lancée, une tâche planifiée ou un déclencheur peut continuer côté Diadems. Revenez dans **Chat** ou **Sessions** pour voir le résultat. ## Quelle différence entre Chat et Sessions ? **Chat** sert à converser dans la session active. **Sessions** sert à rechercher, renommer, ouvrir ou supprimer les conversations de l’agent. ## L’agent envoie-t-il des e-mails sans moi ? Oui, si vous activez son adresse gérée et autorisez le destinataire en sortie. L’agent ne peut écrire qu’aux contacts de sa liste blanche et dans le sens que vous avez choisi. Vous pouvez suspendre l’adresse ou retirer un contact à tout moment. ## Où retrouver le résultat d’une tâche ? Dans **Sessions** si la livraison est réglée sur le portail, ou dans Telegram si ce canal est connecté et sélectionné. ## Pourquoi l’agent est-il en pause ? Consultez le bandeau du chat et **Configuration**. Les causes courantes sont une limite quotidienne, un forfait et une réserve épuisés, ou un abonnement inactif. ## La réserve expire-t-elle à la fin du mois ? Le solde non consommé est reporté d’un mois sur l’autre selon les conditions du service. Le forfait inclus, lui, suit son cycle mensuel. ## Puis-je inviter mon équipe ? Oui, dans la limite des sièges de l’offre. Les membres invités peuvent utiliser l’agent partagé ; retirez immédiatement un accès devenu inutile. ## Où placer un mot de passe nécessaire à une mission ? Dans le **Coffre**, jamais dans le chat, la mémoire ou un fichier. Donnez ensuite à l’agent uniquement le nom de l’entrée. ## Que détruit la suppression d’un agent ? Son espace, sa mémoire, ses fichiers et ses accès. Téléchargez les éléments à conserver avant de confirmer. Une résiliation d’abonnement est une action distincte. ## La documentation est-elle exploitable par un agent IA ? Oui. L’index compact se trouve dans [`/docs/llms.txt`](/docs/llms.txt), le corpus complet dans [`/docs/llms-full.txt`](/docs/llms-full.txt) et les consignes d’usage dans [`/docs/skill.md`](/docs/skill.md). --- # Résoudre un problème > Vérifications courtes pour rétablir le chat, les canaux, l’e-mail et les automatisations. Commencez par identifier l’état de l’agent et le dernier message affiché. Les contrôles ci-dessous ne suppriment aucune donnée. ## Le chat ne permet pas d’envoyer 1. Vérifiez que l’agent est **En ligne**. 2. Attendez la fin de la préparation ou de la mission en cours. 3. Lisez un éventuel bandeau de quota au-dessus du composeur. 4. Ouvrez **Configuration → Forfait & réserve**. 5. Actualisez la page une fois, puis réessayez avec un court message. Si la réponse reste en cours, ne renvoyez pas la même consigne : elle s’affichera quand la mission sera terminée. ## Limite ou paiement Une limite quotidienne atteinte laisse l’agent terminer la tâche en cours, puis le met en pause jusqu’au prochain jour. Utilisez une recharge disponible ou la réserve si vous devez continuer immédiatement. Si l’abonnement n’est pas actif, ouvrez **Configuration → Mon abonnement** et terminez le paiement ou reprenez l’abonnement. ## Telegram ne reçoit rien - Vérifiez l’état **Connecté** dans **Canal**. - Recréez l’association si le code a expiré. - Pour une tâche, vérifiez que la livraison choisie est **Sur Telegram**. - Assurez-vous de consulter la conversation du bon agent. ## L’e-mail ou Google ne fonctionne pas - Vérifiez que la boîte de l’agent est active. - Contrôlez l’orthographe du contact et sa présence dans la liste autorisée. - Contrôlez le sens autorisé du contact : entrant, sortant ou les deux. - Consultez **Suivi des emails** : l’état distingue attente, traitement et échec. - Utilisez **Réessayer** seulement lorsque la livraison est indiquée récupérable. ## Un fichier ne s’importe pas Vérifiez sa taille, son format et l’espace restant dans **Fichiers**. Renommez-le si un fichier du même nom existe, ou remplacez l’ancien après contrôle. ## Une automatisation ne se lance pas Vérifiez qu’elle est **Active**, que sa prochaine exécution est correcte et que l’agent dispose encore de quota. Utilisez **Exécuter maintenant** ou **Tester** pour isoler un problème de planning ou d’intégration. ## Contacter Diadems Si le statut affiche **Action Diadems requise** ou si le problème persiste, préparez : - le nom de l’agent ; - l’heure approximative du problème ; - l’action effectuée ; - le message d’erreur visible ; - une capture sans secret ni donnée confidentielle. Ne communiquez jamais un mot de passe, une valeur du Coffre ou un secret de déclencheur. --- # Documentation Diadems > Le guide officiel pour créer, piloter et faire progresser votre agent Diadems. ## Trouver rapidement ### Je découvre Diadems Commencez par les [premiers pas](/docs/demarrage/premiers-pas/), puis créez votre agent et confiez-lui une première mission en langage naturel. ### Je travaille avec mon agent Apprenez à utiliser le [chat](/docs/utiliser/chat/), les [fichiers](/docs/utiliser/fichiers/), l’[e-mail](/docs/utiliser/email/) et les [tâches planifiées](/docs/utiliser/taches-planifiees/). ### Je gère mon abonnement Consultez votre [budget et votre réserve](/docs/compte/credits-reserve/), vos [factures](/docs/compte/abonnement-factures/) et les membres de votre équipe. ### Quelque chose ne fonctionne pas Identifiez d’abord l’[état de votre agent](/docs/depannage/etats-agent/), puis suivez le guide de [résolution des problèmes](/docs/depannage/resoudre-un-probleme/). :::note[Documentation lisible par les agents IA] Cette aide est aussi disponible sous forme structurée à [`/docs/llms.txt`](/docs/llms.txt), en contexte complet à [`/docs/llms-full.txt`](/docs/llms-full.txt) et comme mode d’emploi agent à [`/docs/skill.md`](/docs/skill.md). ::: --- # Application Windows > Utiliser le cockpit, le navigateur intégré, les fichiers et les notifications dans l’application Diadems pour Windows. L’application Windows réunit le cockpit et un navigateur Chromium dans une même fenêtre. Elle utilise le même compte et les mêmes agents que le portail. ## Connexion rapide Sur l’écran de connexion, choisissez **Continuer dans votre navigateur**. Diadems ouvre votre navigateur habituel afin de réutiliser une session déjà connectée ou de vous identifier. L’application revient ensuite automatiquement au cockpit avec un code court, à usage unique. Le navigateur intégré, les fichiers et la liaison avec un agent ne sont disponibles qu’après cette connexion. ## Navigateur intégré Le bouton **Navigateur** ouvre une zone de travail à droite du cockpit. Vous pouvez : - ouvrir plusieurs onglets ; - ajouter une page aux favoris depuis l’étoile de la barre d’adresse ; - afficher ou masquer la barre de favoris et rechercher dans la bibliothèque ; - importer les favoris de Chrome, Edge, Brave, Vivaldi ou Opera, ainsi qu’un fichier HTML exporté depuis un autre navigateur ; - suivre, annuler et ouvrir les téléchargements depuis le bouton de la barre d’adresse, qui conserve les cinq derniers fichiers ; - glisser un téléchargement terminé dans le chat ou choisir **Agent** pour le préparer comme pièce jointe, sans exposer son chemin Windows ; - saisir une adresse ; - revenir en arrière, avancer et actualiser ; - rechercher dans la page avec `Ctrl+F` et parcourir les résultats ; - régler le zoom avec `Ctrl++`, `Ctrl+-` et revenir à 100 % avec `Ctrl+0` ; - redimensionner la séparation entre le chat et le navigateur ; - ouvrir la page courante dans votre navigateur par défaut. Les raccourcis habituels sont disponibles : `Ctrl+L` sélectionne l’adresse, `Ctrl+T` ouvre un onglet, `Ctrl+W` le ferme, `Ctrl+Maj+T` le restaure et `Ctrl+Tab` passe au suivant. Le menu du navigateur regroupe aussi la duplication d’onglet, la copie d’adresse, la recherche, le zoom et l’ouverture dans le navigateur par défaut. Le navigateur possède un profil local persistant. Vous vous connectez vous-même aux sites utiles ; ses cookies et ses sessions restent sur votre PC. ## Demander à Diadems à partir d’un texte Sélectionnez un passage dans le cockpit ou dans le navigateur intégré, puis faites un clic droit et choisissez **Demander avec Diadems**. L’application vous laisse choisir l’agent et la conversation, puis prépare le passage sous forme de citation dans le composeur. Vous pouvez ajouter votre question avant de l’envoyer : aucune demande ne part automatiquement. L’adresse source éventuellement jointe est limitée à la page sans paramètres ni fragment. Les cookies, les mots de passe et le reste de la page ne sont jamais transmis par cette action. Les favoris et l’historique des cinq derniers téléchargements restent eux aussi sur le PC. Leurs fichiers sont protégés par le coffre Windows de l’utilisateur. Les chemins locaux et ceux des profils importés ne sont jamais transmis au portail, à la capsule ou à l’agent. Lors d’un ajout au chat, Electron émet uniquement une autorisation temporaire et révocable pour lire le fichier choisi. ## Paramètres du navigateur L’icône d’engrenage située complètement à droite de la barre d’adresse ouvre les réglages locaux. Vous pouvez notamment : - choisir Google, Bing, DuckDuckGo, Qwant, Brave Search ou Ecosia pour les recherches saisies dans la barre d’adresse ; - définir la page d’accueil, le zoom par défaut et l’affichage de la barre de favoris ; - activer le signal « Ne pas me pister », bloquer les fenêtres intempestives et demander une confirmation Windows pour les permissions sensibles ; - choisir le dossier de téléchargement, l’ouvrir ou revenir au dossier Windows ; - effacer les cookies et le cache sans toucher aux favoris ni aux réglages. Les réglages et le chemin du dossier personnalisé sont chiffrés avec la protection du compte Windows. Seul le nom du dossier est affiché dans l’interface. ## Laisser l’agent piloter Dans la fiche d’un agent, ouvrir **Navigateur** autorise automatiquement cet agent à utiliser la zone visible. Fermez le navigateur pour couper immédiatement le contrôle. Cette autorisation n’est pas transmise à un autre agent. L’agent peut lire le texte actuellement visible, naviguer, faire défiler, remplir un champ ordinaire ou utiliser une cible repérée sur la page. Il voit aussi la liste des onglets ouverts et peut passer de l’un à l’autre, sans pouvoir les fermer. Lorsqu’une fenêtre ou une popup recouvre la page, elle est signalée explicitement et devient le seul espace dans lequel l’agent peut agir. Si la structure d’une page ne suffit pas, l’agent peut demander une inspection visuelle. Les éléments sûrs sont alors encadrés dans la capture et portent la même référence que dans son relevé de page. Ces repères sont temporaires et sont retirés immédiatement après la capture. Un curseur Diadems matérialise ses gestes et un léger halo coloré entoure le navigateur pendant toute la séquence de contrôle, y compris lorsqu’il observe la page. Les onglets restent toujours visibles au-dessus de cet effet. La frappe apparaît progressivement dans les champs au lieu d’insérer le texte d’un seul coup. Le curseur et le halo disparaissent après une courte période sans action. Une coupure passagère de la liaison est reconnectée automatiquement. L’agent ne reçoit jamais les cookies, les mots de passe ni un accès DevTools brut. Les champs de mot de passe, les pièces jointes, les téléchargements, l’envoi de formulaire et les adresses du réseau local sont bloqués. :::caution[Vous gardez la main] Relisez toute action ayant un effet externe. Les envois, paiements, publications et autres confirmations importantes restent à effectuer ou valider par vous. ::: ## Ajouter un fichier Le bouton **Fichiers** ouvre le sélecteur Windows. Seuls les fichiers choisis reçoivent une autorisation locale temporaire. Ils sont ajoutés au compositeur de la conversation courante, mais ne sont pas envoyés avant votre validation. ## Notifications et mises à jour Lorsque l’application n’est pas au premier plan, Windows peut afficher les réponses et événements du centre de notifications Diadems. Un clic ramène à la bonne page. Les mises à jour sont téléchargées depuis Diadems et vérifiées par leur signature avant installation. Quand une version est prête, la barre supérieure propose de redémarrer l’application pour l’appliquer. L’installeur public est signé au nom de Diadems. Windows peut ainsi vérifier son éditeur et son intégrité avant l’installation ; n’utilisez pas une copie dont l’éditeur est inconnu. ## Journaux de diagnostic En cas de fermeture inattendue ou de blocage, ouvrez **Mon compte → Application Windows → Ouvrir les journaux**. Le dossier contient le journal technique rotatif de l’application et, lorsqu’un processus a crashé, le rapport natif correspondant. Vous pouvez transmettre ce dossier au support Diadems. Ces fichiers restent uniquement sur votre PC. Ils ne contiennent ni jeton, ni mot de passe, ni paramètres d’URL, et ne sont jamais envoyés automatiquement. --- # Canaux et notifications > Relier Telegram et recevoir les résultats de l’agent au bon endroit. Le portail reste le poste de pilotage principal. Un canal connecté permet aussi d’échanger avec l’agent et de recevoir ses résultats depuis votre téléphone. ## Connecter Telegram 1. Ouvrez l’agent puis l’onglet **Canal**. 2. Choisissez Telegram et demandez un code d’association. 3. Ouvrez le lien ou le bot indiqué dans Telegram. 4. Envoyez le code avant son expiration. 5. Revenez dans le portail et actualisez l’état si nécessaire. L’état **Connecté** confirme que les messages Telegram sont associés au bon agent. Ne transmettez pas le code d’association à une autre personne. ## Utiliser le canal Une fois connecté, vous pouvez parler à l’agent depuis Telegram. Les échanges restent organisés en sessions, comme dans le portail. Pour une tâche planifiée ou un déclencheur web, choisissez : - **Dans le portail** pour ranger le résultat dans **Sessions** ; - **Sur Telegram** pour le recevoir directement sur votre téléphone. ## Notifications de l’application Le portail ou l’application peut vous prévenir lorsqu’une réponse se termine alors que vous ne la consultez pas. Si la bonne session n’est toujours pas visible après une minute, la notification contient un aperçu ; un appui ouvre directement cette session. L’activation peut demander l’autorisation du navigateur ou de l’appareil. Si rien ne s’affiche, vérifiez les autorisations de notifications dans les réglages du système et du navigateur. Dans **Mon compte → Application & appareils**, vous pouvez masquer le contenu des aperçus, activer une plage silencieuse ou retirer les notifications d’un ancien appareil. Dans l’application Android, ce même bloc permet aussi d’activer le verrou par biométrie ou code du téléphone, de masquer l’aperçu dans les applications récentes et d’installer une mise à jour vérifiée. ## Déconnecter un canal Déconnectez le canal depuis sa carte dans **Canal** lorsque l’appareil ou le compte Telegram ne doit plus accéder à l’agent. Vous pourrez créer une nouvelle association plus tard. :::note[Plusieurs agents] Chaque association concerne un agent précis. Vérifiez le nom affiché avant d’envoyer une information sensible. ::: --- # Chat et messages > Envoyer, rechercher, citer, écouter et reprendre les messages échangés avec un agent. Le **Chat** reste monté lorsque vous consultez une autre section de la fiche : une réponse en cours ne disparaît pas si vous ouvrez momentanément les fichiers ou la configuration. ## Envoyer un message Écrivez votre demande puis sélectionnez **Envoyer**. Selon l’appareil, vous pouvez aussi : - dicter le texte du message ; - maintenir le bouton vocal pour enregistrer une note vocale ; - importer une photo, une prise de vue ou un fichier avec l’icône **Importer** ; - sur Android, sélectionner un texte dans une autre application puis choisir **Demander avec Diadems** pour le préparer comme citation modifiable ; - arrêter une réponse en cours. Dans l’application Android, une légère vibration signale les étapes utiles du travail de l’agent et la livraison de sa réponse. Les séries rapides d’actions d’outils sont volontairement temporisées pour éviter une vibration continue. Les photos envoyées apparaissent directement dans votre bulle et peuvent être agrandies d’un toucher. Elles restent dans l’espace de stockage privé de votre agent : leur aperçu est donc encore disponible après une actualisation ou sur un autre appareil. ## Actions sur un message Le menu d’un message propose, selon son auteur et sa position : - **Répondre** pour citer le message ; - **Copier** ; - **Écouter** ou arrêter la lecture d’une réponse ; - **Régénérer** la dernière réponse de l’agent ; - **Modifier** puis renvoyer votre propre message ; - **Nouveau chat depuis ici** pour créer une bifurcation avec le contexte précédent. Les réponses peuvent contenir du Markdown, des liens enrichis, des fichiers, des blocs de code et des schémas interactifs. Un schéma peut être agrandi, réduit, remis à sa taille initiale ou téléchargé en SVG. ## Rechercher dans la conversation Utilisez l’icône de recherche en haut du chat. Saisissez un mot ou une expression, puis naviguez entre les résultats avec les contrôles précédent et suivant. ## Nouvelle session et mémoire de travail Le bouton **+** de l’en-tête crée une nouvelle session avec une mémoire de travail vierge. Cela n’efface pas les souvenirs durables enregistrés dans l’onglet **Mémoire**. La session n'est réellement créée qu'au premier message. Ouvrir plusieurs fois un nouveau chat sans rien envoyer ne remplit donc pas le gestionnaire de sessions vides. Lorsque le contexte de la conversation devient très rempli, le chat peut proposer : - de compacter la conversation ; - de démarrer une nouvelle session. La compaction résume le contexte utile pour poursuivre dans la même session. ## Lecture vocale Sur une réponse de l’agent, choisissez **Écouter**. Pendant la lecture, vous pouvez mettre en pause, reprendre, changer la vitesse ou rejouer depuis le début. --- # Compétences et mémoire > Adapter les capacités de l’agent et conserver les informations qui comptent. Les **compétences** déterminent les savoir-faire disponibles. La **mémoire** conserve les faits durables que l’agent doit réutiliser d’une mission à l’autre. ## Consulter les compétences 1. Ouvrez votre agent. 2. Sélectionnez **Compétences**. 3. Recherchez un savoir-faire par son nom, sa catégorie ou sa commande. Une compétence installée est disponible automatiquement. L’agent n’en charge les instructions détaillées que lorsque votre mission en a besoin. La compétence **LLM Wiki** est incluse. Demandez par exemple à l’agent de créer une base de connaissances pour un projet, d’y ingérer des documents ou d’en auditer les sources. Elle produit des fichiers Markdown interconnectés dans le dossier `wiki` de l’espace de l’agent : ils restent lisibles, téléchargeables et portables sans outil propriétaire. Depuis **Fichiers**, l’action **Ajouter à la base de connaissances** prépare directement cette mission dans le chat pour le document choisi. Vous gardez la main avant l’envoi ; l’agent conserve ensuite la source, met à jour les liens et indique précisément les pages du wiki qu’il a modifiées. ## Apprendre une procédure Dans **Compétences**, sélectionnez **Apprendre**, puis fournissez : - une procédure écrite avec ses étapes et le résultat attendu ; - ou l’URL d’une documentation à étudier. Diadems prépare la commande dans le chat. Relisez-la puis envoyez-la : l’agent analyse la source et crée un savoir-faire réutilisable. La nouvelle compétence apparaît dans la section **Apprises par votre agent**. :::tip[Compétence ou mémoire ?] Une compétence décrit **comment faire** une tâche répétable. La mémoire conserve un fait sur votre activité, vos décisions ou vos préférences. ::: ## Supprimer une compétence Utilisez la corbeille sur sa fiche puis confirmez. La compétence est retirée de la capsule immédiatement, sans redémarrer l’agent. Cette suppression retire ses instructions et ses fichiers associés ; conservez ailleurs tout modèle ou script dont vous pourriez encore avoir besoin. ## Structurer la mémoire L’onglet **Mémoire** présente d’abord la mémoire automatique Hindsight, puis deux types de repères explicites que vous pouvez corriger : - **Contexte de référence** : règles, décisions, contexte métier et projets suivis ; - **Profil utilisateur** : identité, société et préférences de travail partagées. En complément, Hermes consolide automatiquement les échanges utiles avec **Hindsight**. Cette mémoire sémantique locale aide l’agent à retrouver des faits, des relations et des expériences au fil des sessions. Elle reste dans la capsule de votre agent ; elle n’est pas recopiée dans la base Diadems. Pour analyser et consolider ces souvenirs, Hindsight utilise le fournisseur, le modèle et le mode de paiement actuellement choisis pour l’agent. Il ne bascule pas silencieusement sur un autre modèle. La mémorisation automatique concerne les conversations humaines : chat Diadems, e-mails et messageries connectées comme Telegram ou Discord. Les webhooks, les tâches planifiées et les traitements par lot en sont exclus afin de ne pas transformer des données opérationnelles temporaires en souvenirs durables. Si l’agent possédait déjà des conversations avant l’activation de Hindsight, utilisez **Importer les anciennes conversations**. Le traitement s’effectue dans la capsule, peut continuer après la fermeture de la page et peut être repris sans créer de doublons. Il consomme les tokens de l’agent sur le modèle actuellement sélectionné. Aucun transcript n’est copié dans la base Diadems. Dans **Mémoire → Hindsight → Vue**, la carte relie les faits, les expériences et les synthèses consolidées. Vous pouvez rechercher un souvenir, filtrer sa nature, zoomer, déplacer la carte puis sélectionner un point pour consulter son contexte. Un fait ou une expérience peut être corrigé ou oublié. L’oubli est réversible : Hindsight écarte l’information de ses futurs rappels tout en conservant sa trace d’audit. Les synthèses dérivées se recalculent depuis les faits et ne sont donc pas modifiées directement. L'ouverture de l'onglet reste passive : elle ne démarre pas Hindsight. Utilisez **Explorer la mémoire** pour charger la carte, ou ouvrez **Synthèse** puis lancez réellement votre question. La mémorisation automatique des conversations reste active indépendamment de cette interface. La vue **Synthèse** permet de poser une question à l’ensemble de la mémoire. Elle produit une réponse raisonnée et permet d’ouvrir les souvenirs qui l’étayent. Cette opération utilise le modèle et le mode de paiement choisis pour l’agent. La carte, les corrections et les synthèses transitent à la demande depuis la capsule ; leur contenu n’est pas enregistré dans la base Diadems. Si la mémoire était en veille, le premier affichage peut prendre quelques instants. Écrivez des faits courts et vérifiables, une information par ligne : ```text - Le client préfère des réponses directes. - Le compte-rendu hebdomadaire est livré le vendredi. - Projet en cours : refonte du catalogue été. ``` Enregistrez après chaque modification. Une information de mémoire influence les futures réponses ; retirez donc ce qui est devenu faux ou obsolète. ## Mémoire ou session ? Utilisez une **session** pour le contexte d’une conversation ou d’une mission. Utilisez la **mémoire** pour une information qui doit rester vraie dans le temps. Utilisez **LLM Wiki** pour un corpus documentaire structuré, sourcé et consultable comme des fichiers. :::tip[Demandez une confirmation] Après une modification importante, demandez à l’agent de reformuler ce qu’il doit retenir. Vous repérez immédiatement une règle ambiguë. ::: N’enregistrez pas de mot de passe dans la mémoire. Les identifiants d’un service tiers appartiennent au **Coffre**. --- # Déclencheurs web (webhooks) > Connecter un service externe à un agent Diadems avec un webhook signé et rejouable sans doublon. Un déclencheur web lance une mission lorsqu’un service externe envoie un événement à Diadems. Il convient par exemple à une nouvelle commande, un formulaire reçu, une alerte ou un changement de statut. Le service externe appelle uniquement l’URL publique fournie par Diadems. Il n’accède jamais directement au serveur interne, au port de la capsule ou à une clé API générale Diadems. ## Créer un déclencheur 1. Ouvrez **Agent → Tâches → Déclencheurs événementiels**. 2. Donnez un nom stable au déclencheur, par exemple `Nouvelle commande`. 3. Rédigez la consigne que l’agent devra exécuter. 4. Si nécessaire, indiquez les types d’événements acceptés, séparés par des virgules. 5. Choisissez où livrer le résultat : dans le portail, sur Telegram ou vers votre application avec un callback HTTPS. 6. Enregistrez. Diadems affiche une **URL HTTPS** et un **secret** propres à ce déclencheur. Le secret sert uniquement à signer les requêtes de cette route. :::danger[Le secret est confidentiel] Conservez-le dans le gestionnaire de secrets du service émetteur. Ne le placez jamais dans le code source, une page publique, un ticket ou une capture d’écran. ::: ## Contrat recommandé pour une intégration personnalisée Une intégration générique doit utiliser la signature HMAC **V2**, qui lie la requête à un horodatage et empêche la réutilisation tardive d’une requête interceptée. 1. Sérialisez le JSON une seule fois et conservez exactement cette chaîne comme corps HTTP. 2. Produisez un timestamp Unix en secondes, par exemple `1785920400`. 3. Construisez les octets à signer : `.`. 4. Calculez leur HMAC-SHA256 avec le secret du déclencheur. 5. Encodez le résultat en hexadécimal minuscule. 6. Envoyez le corps sans le sérialiser ni le modifier une seconde fois. ```text POST Content-Type: application/json X-Webhook-Timestamp: X-Webhook-Signature-V2: X-Request-ID: ``` La signature est donc : ```text hex(HMAC-SHA256(secret, UTF8(timestamp + "." + corps_json_brut))) ``` L’horloge du service émetteur doit être synchronisée. Diadems refuse un timestamp éloigné de plus de **5 minutes** de l’heure du serveur. `X-Request-ID` doit identifier l’événement métier, pas la tentative HTTP. Rendez-le unique pour tout l’agent en préfixant la source et le type, par exemple `boutique:order.created:1234`. En cas de nouvelle tentative, réutilisez le même identifiant : la capsule reconnaît durablement une livraison déjà acceptée, y compris après un redémarrage, au lieu de relancer l’agent. ### Exemple PHP La variable `$body` utilisée pour calculer la signature est exactement celle transmise par cURL. ```php id; $payload = [ 'event_type' => 'order.created', 'event_id' => $eventId, 'occurred_at' => gmdate(DATE_ATOM), 'data' => [ 'order_id' => (string) $order->id, 'customer_id' => (string) $order->customer_id, ], ]; $body = json_encode( $payload, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ); $timestamp = (string) time(); $signature = hash_hmac('sha256', $timestamp . '.' . $body, $secret); $request = curl_init($url); curl_setopt_array($request, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => $body, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-Webhook-Timestamp: ' . $timestamp, 'X-Webhook-Signature-V2: ' . $signature, 'X-Request-ID: ' . $eventId, ], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, ]); $responseBody = curl_exec($request); $status = curl_getinfo($request, CURLINFO_RESPONSE_CODE); curl_close($request); ``` ### Exemple Node.js ```js import { createHmac } from "node:crypto"; const eventId = "boutique:order.created:1234"; const body = JSON.stringify({ event_type: "order.created", event_id: eventId, occurred_at: new Date().toISOString(), data: { order_id: "1234" }, }); const timestamp = Math.floor(Date.now() / 1000).toString(); const signature = createHmac("sha256", process.env.DIADEMS_WEBHOOK_SECRET) .update(`${timestamp}.`, "utf8") .update(body, "utf8") .digest("hex"); const response = await fetch(process.env.DIADEMS_WEBHOOK_URL, { method: "POST", headers: { "Content-Type": "application/json", "X-Webhook-Timestamp": timestamp, "X-Webhook-Signature-V2": signature, "X-Request-ID": eventId, }, body, }); ``` ## Format conseillé du JSON Diadems accepte tout objet JSON, mais un format stable facilite le filtrage, la lecture et les évolutions : ```json { "event_type": "order.created", "event_id": "order-1234", "occurred_at": "2026-08-05T10:15:00Z", "data": { "order_id": "1234" } } ``` - `event_type` détermine le type d’événement utilisé par les filtres de la route ; - `event_id` identifie l’événement métier dans le contenu ; - `occurred_at` indique quand l’événement s’est réellement produit ; - `data` contient seulement les données nécessaires à la mission. Évitez d’envoyer un mot de passe, une clé API ou une donnée inutile dans le corps. Une signature authentifie l’émetteur, mais le contenu reçu reste une entrée non fiable pour l’agent. ## Réponses HTTP et nouvelles tentatives | Statut | Signification | Action de l’émetteur | | --- | --- | --- | | `202` | Événement authentifié et écrit dans la file durable de la capsule | Ne pas renvoyer | | `200` | Événement ignoré ou doublon déjà accepté | Ne pas renvoyer | | `400` | Corps illisible ou mal formé | Corriger la requête | | `401` | Signature absente ou incorrecte | Corriger le secret ou le calcul | | `403` | Route désactivée ou sans secret valide | Corriger la configuration | | `404` | Agent ou route inconnu | Corriger l’URL | | `413` | Corps supérieur à 1 Mio | Réduire le corps | | `429` | Limite temporaire atteinte | Réessayer avec attente exponentielle | | `502` ou `503` | Capsule momentanément indisponible | Réessayer avec attente exponentielle | Pour `429`, `502` et `503`, conservez le même `X-Request-ID`. Si la nouvelle tentative intervient plus de cinq minutes après la première, générez un nouveau timestamp et recalculez la signature sur le même corps. ## File durable et garantie de traitement Après validation de la signature, Hermes enregistre l’événement dans une file SQLite située sur le volume privé de la capsule. La réponse `202` n’est envoyée qu’après la validation de cette écriture. Le corps, la consigne rendue et les informations de livraison ne sont ni enregistrés dans PostgreSQL Diadems, ni renvoyés au plan de contrôle. La capsule traite les événements avec une concurrence bornée. Un échec est réessayé automatiquement jusqu’à trois tentatives, avec des attentes de 30 secondes puis 5 minutes. Après le troisième échec, la livraison passe dans l’état **Échec à vérifier** et peut être relancée manuellement depuis la fiche du déclencheur. Le portail affiche uniquement l’identifiant, le type, l’état, les dates et le nombre de tentatives ; il ne lit jamais le contenu de l’événement. Une fois la mission terminée, le contenu sensible de la ligne de file est effacé. La trace technique de réussite est conservée sept jours pour reconnaître les reprises tardives. Une livraison en échec conserve son contenu dans la capsule pendant quatorze jours afin de permettre une relance, puis elle est supprimée. :::caution[Garantie « au moins une fois »] Une reprise peut réexécuter une partie d’une mission interrompue. Toute mutation externe — création de commande, changement d’état ou paiement — doit donc être idempotente et réutiliser le `X-Request-ID` comme clé d’idempotence. Aucun système distribué ne doit promettre « exactement une fois » sans cette coopération du service métier. ::: ## Réception du résultat Le webhook est **asynchrone**. Une réponse `202 Accepted` signifie que Hermes a authentifié et enregistré durablement la mission dans la capsule ; elle ne contient pas le résultat final de l’agent. Ne gardez jamais la requête entrante ouverte en attendant la fin du travail. La fin d’un webhook reste disponible dans sa session et dans le suivi technique. Elle n’apparaît dans votre cloche et sur vos appareils que si vous activez **Me notifier dans Diadems, Windows et mobile** pour ce déclencheur. Ce choix est personnel : il ne crée aucune notification chez les autres membres de l’équipe. ### Retour dans votre application Choisissez **Vers mon application** dans **Livraison du résultat** pour recevoir automatiquement la réponse finale sur votre API : 1. indiquez une URL HTTPS publique sans identifiants, paramètres ni fragment ; 2. choisissez un jeton Bearer ou une signature HMAC ; 3. saisissez le jeton ou le secret partagé ; 4. adaptez si nécessaire les noms `content` et `event_id` ; 5. ajoutez les champs scalaires de l’événement à renvoyer, par exemple `data.order.id` vers `order_id` ; 6. créez le déclencheur puis utilisez **Tester le retour**. Le secret est écrit directement dans le magasin dotenv privé de la capsule. Il n’est ni conservé dans PostgreSQL Diadems, ni réaffiché par l’API. Une rotation est possible depuis **Configurer le retour** : laissez le champ vide pour garder le secret existant, ou saisissez une nouvelle valeur pour le remplacer. Le corps sortant contient uniquement les champs explicitement déclarés, la réponse finale et l’identifiant stable : ```json { "order_id": "1234", "content": "Analyse terminée…", "event_id": "boutique:order.created:1234" } ``` Avec **Jeton Bearer**, la capsule envoie : ```text Authorization: Bearer X-Request-ID: ``` Avec **Signature HMAC**, elle signe exactement le corps JSON avec la même construction V2 que le webhook entrant : ```text X-Webhook-Timestamp: X-Webhook-Signature-V2: hex(HMAC-SHA256(secret, timestamp + "." + corps brut)) X-Request-ID: ``` Votre endpoint doit répondre avec un statut `2xx`. Une redirection ou un autre statut est considéré comme un échec. Diadems ne marque la livraison comme terminée qu’après ce `2xx` ; le callback bénéficie donc des trois tentatives, du backoff et de la relance manuelle de la file capsule. La garantie reste « au moins une fois » : utilisez `event_id` ou `X-Request-ID` comme contrainte unique afin qu’une reprise n’applique pas deux fois la même mutation. Pour empêcher un callback de devenir un accès au réseau interne, la capsule refuse les hôtes locaux, privés, réservés ou non publics, épingle l’adresse DNS publique pendant la connexion TLS et ne suit aucune redirection. ## GitHub, GitLab et Svix Les fournisseurs pris en charge peuvent conserver leur signature native : - GitHub : `X-Hub-Signature-256` au format `sha256=` ; - GitLab : `X-Gitlab-Token` contenant le secret exact ; - Svix : `svix-id`, `svix-timestamp` et `svix-signature`. Pour une intégration développée sur mesure, utilisez la signature générique V2 décrite plus haut. L’ancien en-tête `X-Webhook-Signature`, signé uniquement sur le corps, reste accepté par Hermes pour compatibilité mais ne protège pas contre le rejeu temporel et ne doit pas être utilisé pour une nouvelle intégration. ## Tester et révoquer Le bouton **Tester l’événement** envoie un événement signé de contrôle et lance réellement l’agent. Vérifiez ensuite le résultat dans **Sessions** ou sur Telegram. La fiche du déclencheur affiche également les dernières livraisons et leur état : en attente, en cours, nouvelle tentative, terminée ou en échec. Supprimez un déclencheur qui n’est plus utilisé. Son URL et son secret cessent alors d’être valides. Pour remplacer un secret possiblement compromis, supprimez le déclencheur, recréez-le puis mettez à jour le gestionnaire de secrets du service émetteur. --- # E-mail > Lire, résumer et préparer des e-mails avec un périmètre de contacts maîtrisé. L’onglet **E-mail** réunit la boîte de votre agent et ses adresses ou domaines autorisés. ## Activer la boîte de l’agent 1. Ouvrez **Agents**, puis votre agent. 2. Sélectionnez **E-mail**. 3. Activez la boîte si elle n’est pas encore prête. 4. Copiez l’adresse affichée pour la communiquer à vos contacts. Une fois la boîte active, vous pouvez rechercher une conversation, ouvrir un fil et consulter ses pièces jointes depuis le portail. ## Ce que l’agent peut faire L’agent peut lire les messages autorisés, les résumer, classer les informations, préparer une réponse et l’envoyer à un contact autorisé. Décrivez le résultat attendu dans le chat, par exemple : > Résume les e-mails reçus aujourd’hui et prépare une réponse aux trois plus > urgents. :::caution[Périmètre fermé] L’adresse gérée par Diadems n’échange qu’avec les adresses et domaines que vous avez explicitement autorisés. L’agent peut répondre sans validation message par message dans ce périmètre. Retirez ou suspendez une règle pour bloquer immédiatement les nouveaux échanges correspondants. ::: ## Autoriser une adresse ou un domaine Dans **Liste blanche : contacts et domaines**, choisissez le type de règle : - **Adresse précise** autorise une seule boîte, par exemple `client@entreprise.fr`. - **Domaine complet** autorise toutes les adresses du domaine exact, par exemple `@entreprise.fr`. Il n’autorise pas `@support.entreprise.fr`. Une règle de domaine est pratique pour une entreprise dont tous les membres doivent pouvoir échanger avec l’agent. Pour éviter l’usurpation d’adresse, un message entrant autorisé par un domaine n’est accepté que si son expéditeur réussit l’authentification SPF, DKIM ou DMARC. Le sens est toujours présenté du point de vue de la boîte de l’agent : - **Reçus et envoyés par l’agent** autorise les échanges dans les deux sens. - **Reçus par l’agent uniquement** autorise le contact à écrire à l’agent, mais empêche l’agent de lui envoyer un message. - **Envoyés par l’agent uniquement** autorise l’agent à écrire au contact, mais refuse les messages entrants de celui-ci. Vous pouvez modifier ce sens, suspendre la règle ou la retirer à tout moment. ## Suivre une livraison La carte **Suivi des emails** distingue les messages en attente, en cours de traitement, en nouvelle tentative et les livraisons à vérifier. Une erreur récupérable propose **Réessayer**. Ce suivi ne contient ni adresse, ni sujet, ni corps de message, ni nom de pièce jointe : ces données restent dans la capsule de l’agent. Une boîte indiquée **active** confirme que le canal est autorisé. Le suivi de livraison indique séparément si un message précis est réellement en attente, en cours ou en échec. ## Retrouver un résultat Les échanges e-mail créent des sessions Hermes avec la source **E-mail**. Ils apparaissent dans **Sessions** et dans la boîte de l’onglet **E-mail**. Le Centre de mission affiche le traitement seulement tant qu’une livraison est réellement en attente ou en cours. --- # Fichiers > Organiser l’espace de travail de l’agent, envoyer des documents et prévisualiser les formats pris en charge. L’onglet **Fichiers** ouvre l’espace de travail persistant de l’agent. Chaque agent possède son propre stockage isolé et un quota visible dans sa fiche. ## Actions disponibles Vous pouvez : - parcourir les dossiers ; - créer un dossier ; - envoyer un ou plusieurs fichiers ; - prévisualiser un fichier pris en charge ; - télécharger un fichier ; - renommer un fichier ou un dossier ; - supprimer un élément. Le fil d’Ariane permet de remonter dans l’arborescence. Sur mobile, les actions sont accessibles depuis le menu de l’élément. ## Envoyer un fichier depuis le chat Le bouton **Envoyer un fichier** du chat accepte aussi les fichiers. Une image est jointe au message ; un autre document est téléversé dans l’espace de travail puis indiqué à l’agent par son chemin. Sur Android, vous pouvez également choisir **Diadems** dans le menu **Partager** d’une autre application. Diadems vous demande l’agent et la conversation avant de préparer le document ; aucun message n’est envoyé sans votre confirmation. Les documents volumineux restent dans le cache privé de l’application pendant leur transfert et ne sont pas convertis en texte ou en lien public. Dans l’application Windows, le bouton **Fichiers** de la barre supérieure ouvre le sélecteur système. L’autorisation est limitée aux fichiers choisis, expire rapidement et est supprimée dès leur ajout au compositeur. ## Conflit de nom Si un fichier du même nom existe déjà, le portail affiche une demande de résolution. Choisissez l’option proposée avec attention pour éviter d’écraser un document utile. ## Stockage La jauge de la fiche indique l’espace utilisé et le quota. Lorsque le stockage approche de sa limite : 1. supprimez les fichiers devenus inutiles ; 2. téléchargez d’abord les livrables à conserver ; 3. ajoutez du stockage depuis **Configuration**, si l’offre le permet. :::caution[Suppression] Supprimer un fichier du portail le retire de l’espace de l’agent. Téléchargez une copie avant toute suppression définitive. ::: --- # Sessions > Retrouver, filtrer, renommer, bifurquer et supprimer les conversations d’un agent. Une session est un fil de conversation persistant avec son propre contexte de travail. L’onglet **Sessions** présente le gestionnaire complet. ## Ce que vous pouvez faire - créer une nouvelle session ; - ouvrir ou reprendre une session existante ; - ajouter une session à vos favoris pour la conserver en tête de liste ; - rechercher par titre, aperçu ou identifiant ; - filtrer par canal, par exemple portail, e-mail ou Telegram ; - renommer une session ; - supprimer une session ; - nettoyer les sessions devenues éligibles à l’archivage. Le panneau récapitule également le nombre de sessions, leur activité, leur canal d’origine, le modèle enregistré, les actions réalisées et l’usage de jetons. Les détails d’entrée, de sortie, de raisonnement et de cache restent disponibles dans l’infobulle du compteur, sans afficher les coûts techniques du fournisseur. Le badge **Chat Diadems**, **E-mail**, **Webhook** ou **Tâche planifiée** indique le canal qui a créé la session. La ligne **Ressources** a un autre rôle : ses favicons et aperçus montrent les sites et fichiers réellement rencontrés dans les échanges récents. L’un ne remplace donc jamais l’autre. Une session issue d’une bifurcation ou d’une continuation après compression est signalée sans exposer les identifiants techniques de sa filiation. Lorsqu’une session travaille encore, elle remonte automatiquement dans le groupe **En cours maintenant**. Une pastille indique si elle est en cours, en attente, en nouvel essai ou en attente d’une validation. L’état est actualisé sans recharger la page et disparaît dès que le travail est terminé. ## Conversations et automatisations L’onglet distingue deux historiques : - **Conversations** : Chat Diadems, e-mails et messageries comme Telegram ou Discord ; - **Automatisations** : tâches planifiées, webhooks et traitements lancés par une intégration sans conversation ouverte par un utilisateur. Le libellé **Traitement automatique** désigne une commande interne utilisée par Hermes ou par une ancienne intégration. Ce n’est pas un terminal auquel le client doit se connecter. Les longues listes sont affichées progressivement et restent filtrables par origine. Avec une offre partagée, les administrateurs voient les sessions regroupées par leur créateur. Une session appartenant à un autre membre s’ouvre en lecture seule : l’administrateur peut consulter son historique, mais ne peut pas envoyer de message, la renommer, la compacter, la supprimer ou interrompre son travail. Son état en cours reste visible afin de savoir immédiatement qu’un autre membre ou qu’une automatisation utilise l’agent. Un utilisateur retrouve uniquement ses propres sessions. L’agent reçoit l’identité authentifiée de la personne qui lui parle, même lorsque plusieurs collaborateurs utilisent le même agent. Cette identité reprend le **prénom utilisé par les agents** défini dans la section Équipe, et non nécessairement le nom du titulaire du compte Diadems. Les favoris sont propres à votre compte. Diadems conserve seulement l’identifiant opaque nécessaire à ce classement ; le titre, les messages et l’historique restent sur la capsule de l’agent. Depuis le **Centre de mission**, chaque membre peut aussi tenir une note privée liée à la session. Son contenu chiffré reste côté Diadems, hors de la capsule et du contexte de l'agent. Cette note n'est visible que par son auteur. ## Nouvelle session ou bifurcation ? - **Nouvelle session** : repart avec une mémoire de travail vierge. - **Nouveau chat depuis ici** : reprend le contexte jusqu’au message choisi et ouvre une branche indépendante. La bifurcation est utile pour explorer une autre stratégie sans altérer le fil principal. Une nouvelle session reste un brouillon local tant que vous n'avez envoyé aucun message. Elle n'apparaît donc ni dans la liste ni dans les compteurs. Au premier envoi, Diadems l'attribue à votre compte et Hermes la crée dans la capsule ; si vous quittez le brouillon sans écrire, aucune session vide n'est conservée. ## Supprimer une session Seul le créateur peut supprimer sa session. La suppression retire l’historique de cette session. Elle n’efface pas automatiquement la mémoire durable de l’agent ni ses autres sessions. :::caution Vérifiez le titre et l’aperçu avant de supprimer. Une session supprimée n’est plus disponible dans le portail. ::: --- # Tâches planifiées > Faire travailler un agent automatiquement à une date ou selon une fréquence. Une tâche planifiée réveille votre agent sans nouveau message de votre part. Elle convient aux résumés récurrents, contrôles périodiques et rappels. ## Créer une tâche 1. Ouvrez l’agent, puis **Tâches**. 2. Dans **Tâches planifiées**, choisissez **Ajouter**. 3. Donnez un nom clair, par exemple « Résumé du matin ». 4. Rédigez une consigne complète. 5. Choisissez la fréquence et le lieu de livraison. 6. Choisissez si vous souhaitez être personnellement notifié à la fin. 7. Enregistrez. La consigne doit pouvoir être exécutée sans question complémentaire : > Résume mes e-mails non lus, classe-les par urgence et liste les trois actions > prioritaires avec leur échéance. ## Choisir la fréquence L’interface propose les cas courants : - une seule fois, à une date et une heure précises ; - chaque heure ; - chaque jour ; - chaque semaine, avec choix du jour ; - un planning avancé pour les rythmes particuliers. Les dates et heures sont présentées dans le fuseau horaire de votre espace. ## Livrer le résultat Choisissez **Dans le portail** pour retrouver le résultat dans **Sessions**. Choisissez **Sur Telegram** pour recevoir une notification sur votre téléphone ; Telegram doit d’abord être connecté dans l’onglet **Canal**. L’option **Me notifier dans Diadems, Windows et mobile** ajoute aussi le résultat à votre cloche et l’envoie à vos appareils si vous ne consultez pas déjà la bonne session. Elle ne s’applique qu’à votre compte et ne notifie pas les autres membres. ## Piloter les tâches existantes Depuis la liste, vous pouvez : - exécuter une tâche immédiatement pour la tester ; - la mettre en pause et la reprendre ; - modifier sa consigne ou son planning ; - la supprimer. Une indication signale la prochaine exécution et un éventuel échec récent. :::note[Forfait de l’agent] Une exécution consomme les ressources de l’agent et reste soumise à son rythme de travail et à son quota. ::: --- # Validations humaines > Contrôler une action sensible avant que l’agent ne l’exécute. Lorsqu’une action nécessite votre accord, Diadems place une demande dans **Validations**. L’agent attend votre décision au lieu d’exécuter immédiatement. ## Examiner une demande Chaque demande présente : - l’agent et l’action concernée ; - le niveau de risque ; - la destination ou le montant lorsqu’ils existent ; - un aperçu du contenu à envoyer ou publier ; - la date de la demande. Lisez l’ensemble de l’aperçu, notamment le destinataire et les pièces jointes. ## Prendre une décision Vous disposez de trois choix : - **Approuver** : autorise l’action telle qu’elle est présentée ; - **Éditer** : corrige le brouillon avant validation ; - **Rejeter** : annule l’action. La décision est enregistrée. Une validation ne vaut que pour cette demande : elle ne donne pas une autorisation générale à l’agent. :::note[E-mail géré par Diadems] Le canal e-mail natif est contrôlé par sa liste de contacts et le sens autorisé. Dans ce périmètre fermé, un envoi ne crée pas systématiquement une validation. Une autre intégration ou une politique personnalisée peut toujours en exiger une. ::: ## Bon réflexe de contrôle Avant d’approuver, vérifiez : 1. l’identité du destinataire ; 2. le contenu exact et le ton ; 3. les données personnelles ou confidentielles ; 4. le montant, la portée ou le caractère public de l’action ; 5. la cohérence avec votre demande initiale. En cas de doute, rejetez puis demandez à l’agent de préparer une nouvelle version plus précise.