# 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. ::: --- # Crédits et réserve > Suivre le cycle en cours et garder la consommation de chaque agent sous contrôle. La page **Crédits** 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 crédit 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 crédit 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. 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 → Crédits & recharge** : 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 Une offre peut ouvrir le même agent à plusieurs membres, dans la limite de ses sièges : 1. ouvrez la section **Équipe** ; 2. saisissez l’adresse e-mail du collaborateur ; 3. envoyez l’invitation ; 4. vérifiez le compteur de sièges utilisés. 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. ## 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é. :::caution[Accès partagé] Un membre autorisé peut voir et utiliser les agents accessibles à l’organisation. N’invitez que des personnes qui doivent réellement consulter ces données. ::: Le propriétaire conserve 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. ## 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, peut être révoqué depuis le portail. - Une action sensible peut être soumise à validation. L’envoi d’un e-mail exige toujours une validation humaine. L’agent peut lire, résumer et rédiger dans son périmètre, mais il n’envoie pas seul. ## 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. ## Comprendre le paiement Avec les **Modèles Diadems**, l’usage est décompté du crédit inclus, puis de la réserve rechargeable. Le crédit 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 les crédits 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 les crédits 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. --- # 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 volume de crédits 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 de crédits. :::caution[Consommation récurrente] Avant d’ajouter de nombreuses automatisations, testez chacune manuellement et surveillez **Activité** ainsi que la page **Crédits**. ::: --- # 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, des crédits 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 Crédits. | | **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 crédits, 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 ? Non. Il peut lire, résumer et préparer dans le périmètre autorisé, mais chaque envoi exige une validation humaine. ## 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 → Crédits & recharge**. 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. - Reconnectez Google si l’autorisation a été révoquée ou a expiré. - Consultez **Validations** : un brouillon peut attendre votre décision. ## 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 vos [crédits 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). ::: --- # 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. ## 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** ; - arrêter une réponse en cours. ## 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**. 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. ## Activer une compétence 1. Ouvrez votre agent. 2. Sélectionnez **Compétences**. 3. Parcourez le catalogue et activez uniquement les compétences utiles. 4. Désactivez celles dont l’agent n’a plus besoin. L’activation ne lance pas une mission : elle rend simplement le savoir-faire disponible lorsque votre consigne le nécessite. ## Structurer la mémoire L’onglet **Mémoire** sépare deux types d’informations : - **Mémoire de l’agent** : règles, décisions, contexte métier et projets suivis ; - **Ce que l’agent sait de vous** : identité, société et préférences de travail. É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. :::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 > Réveiller un agent lorsqu’un service externe envoie un événement. Un déclencheur web lance une consigne quand un autre service effectue une requête sur l’URL fournie. Contrairement à une tâche planifiée, il réagit à un événement : nouvelle commande, formulaire reçu ou changement de statut. ## Créer un déclencheur 1. Ouvrez **Agent → Tâches → Déclencheurs (événements)**. 2. Donnez-lui un nom stable, par exemple `Nouvelle commande`. 3. Rédigez la consigne que l’agent devra exécuter. 4. Si utile, indiquez les noms d’événements attendus, séparés par des virgules. 5. Choisissez une livraison dans le portail ou sur Telegram. 6. Enregistrez. Diadems affiche alors une **URL** et un **secret** propres au déclencheur. ## Connecter le service émetteur Configurez le service externe pour envoyer une requête `POST` à l’URL affichée. Pour une intégration générique : 1. calculez le HMAC-SHA256 du corps brut avec le secret ; 2. encodez le résultat en hexadécimal ; 3. placez-le dans l’en-tête `X-Webhook-Signature` ; 4. envoyez le même corps, sans le modifier après le calcul. ```text X-Webhook-Signature: Content-Type: application/json ``` Les intégrations GitHub, GitLab ou Svix peuvent utiliser leurs en-têtes de signature natifs. :::danger[Le secret est confidentiel] Ne placez jamais le secret dans une page publique, un ticket ou une capture d’écran. Une personne qui le possède peut tenter de déclencher votre agent. ::: ## Tester et exploiter Le bouton **Tester** envoie un événement signé de contrôle. Vérifiez ensuite le résultat dans **Sessions** ou sur Telegram, selon la livraison choisie. La charge utile de l’événement donne à l’agent le contexte de l’action. La consigne reste la règle principale : soyez explicite sur les contrôles à faire et sur le résultat attendu. Supprimez un déclencheur qui n’est plus utilisé. Son URL et son secret cessent alors d’être valides. --- # 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, ses contacts autorisés et les connexions de messagerie. ## 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 utiles et préparer une réponse. 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[Envoi sous contrôle humain] L’envoi d’un e-mail exige toujours votre validation. Relisez le destinataire, l’objet et le brouillon, modifiez-les si nécessaire, puis approuvez ou rejetez l’action. ::: ## Autoriser les bons contacts Dans **Contacts autorisés**, ajoutez le nom et l’adresse de chaque personne avec laquelle l’agent peut échanger. Cette liste définit le périmètre de sa boîte. - Ajoutez uniquement des adresses de confiance. - Retirez un contact qui ne doit plus interagir avec l’agent. - Une adresse absente de la liste n’entre pas dans le périmètre autorisé. ## Connecter Google Workspace Si l’option est disponible dans votre espace, utilisez **Connecter Google** puis suivez l’autorisation affichée. La connexion peut ensuite être révoquée depuis la même carte. La connexion donne accès au compte sélectionné dans les limites affichées au moment de l’autorisation. Les règles de contacts et de validation Diadems continuent de s’appliquer. ## Retrouver un résultat Les tâches e-mail exécutées dans le portail apparaissent dans **Sessions**. Une livraison choisie sur Telegram apparaît aussi dans la conversation Telegram de l’agent. --- # 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 **+** 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. ## 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 ; - 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é et leur source. ## 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. ## Supprimer une 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. 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**. ## 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. :::caution[E-mail] L’envoi d’un e-mail demande toujours une validation humaine, même si le destinataire figure parmi les contacts autorisés. ::: ## 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.