# Pumaï — Mode d'emploi > Guide de prise en main de l'interface graphique, écrit pour l'utilisateur, sans prérequis > technique. État de l'application vérifié au 1ᵉʳ août 2026. Pumaï n'est pas un chatbot. C'est un assistant capable non seulement de répondre, mais **d'agir** : consulter le Web, traiter une boîte mail, produire des fichiers, générer des images, administrer un serveur, publier du contenu, appeler une API, ou mener une mission de façon autonome pendant que vous faites autre chose. Ce qu'il sait faire dépend entièrement de ce que **vous** lui donnez : des outils, des accès, des consignes et un cadre de contrôle. Ce guide explique comment passer d'un besoin concret à une automatisation fiable, uniquement depuis l'interface graphique. L'API est présentée à la fin comme un accès complémentaire. **Comment lire ce guide.** Si vous découvrez Pumaï, lisez les chapitres 1, 2 et 3 dans l'ordre : c'est le chemin le plus court vers une première automatisation qui marche. Les chapitres 4 à 6 sont la référence, à consulter au besoin. Les chapitres 7 à 12 sont des recettes, des conseils de rédaction et du dépannage. --- ## Sommaire 1. [Comprendre Pumaï en cinq minutes](#1-comprendre-pumaï-en-cinq-minutes) 2. [Première installation, pas à pas](#2-première-installation-pas-à-pas) 3. [Chat, tâche planifiée, Pulsar ou chantier ?](#3-chat-tâche-planifiée-pulsar-ou-chantier) 4. [Les profils et le partage des données](#4-les-profils-et-le-partage-des-données) 5. [Outils, compétences, connecteurs et canaux](#5-outils-compétences-connecteurs-et-canaux) 6. [L'interface page par page](#6-linterface-page-par-page) 7. [Recettes d'automatisation](#7-recettes-dautomatisation) 8. [Bien rédiger une instruction](#8-bien-rédiger-une-instruction) 9. [Contrôler les actions et les coûts](#9-contrôler-les-actions-et-les-coûts) 10. [Utiliser Pumaï par API](#10-utiliser-pumaï-par-api) 11. [Dépannage](#11-dépannage) 12. [Glossaire](#12-glossaire) --- ## 1. Comprendre Pumaï en cinq minutes ### 1.1 Le modèle mental le plus simple Imaginez que vous embauchez une petite équipe. Avant qu'elle puisse travailler, il faut lui donner une identité, des moyens, des consignes et un cadre. Pumaï fonctionne exactement pareil : - un **profil** définit *qui* travaille : sa personnalité, sa mémoire, ses droits ; - un **outil** lui donne le moyen d'agir : envoyer un mail, chercher sur le Web, créer un PDF ; - une **compétence** lui explique *comment* bien s'y prendre pour un type de tâche récurrent ; - un **déclencheur** décide *quand* il travaille : votre message, une heure, une ronde de surveillance, ou une file de production ; - le **contrôle des actions** décide si une action doit attendre votre accord ; - l'**Activité**, les **Logs** et l'**Armoire** vous permettent de vérifier ce qui a été fait. Le chemin habituel est donc : ```text Besoin → Profil → Outils et compétences → Déclencheur → Validation éventuelle → Résultat → Contrôle ``` Un exemple concret. « Vérifier la santé de mon serveur chaque matin » devient : ```text Profil « Supervision » + une connexion SSH autorisée, limitée aux commandes de lecture + une tâche planifiée à 08:00 + une instruction précise de diagnostic + une livraison par email + un contrôle dans Activité et Logs ``` Retenez cette phrase : **Pumaï ne devine pas vos accès.** Tant que vous n'avez pas configuré une boîte mail, il ne peut pas lire vos messages, même s'il vous répond très aimablement qu'il va s'en occuper. Le chapitre 2 sert précisément à lui donner ces moyens. ### 1.2 Ce que Pumaï fait réellement quand on lui confie une tâche Selon la demande, Pumaï choisit tout seul l'un de ces chemins : 1. **répondre directement**, quand aucune action n'est nécessaire ; 2. **aller vérifier** une information en lecture seule, puis répondre ; 3. **construire un plan** et répartir le travail entre plusieurs agents spécialisés qui travaillent en parallèle ; 4. **utiliser les outils** que vous avez autorisés ; 5. **produire** un résultat, un fichier, une image ou une action externe ; 6. **suspendre** une action sensible pour vous demander votre validation. Vous n'avez rien à choisir : c'est l'orchestrateur qui décide, en fonction du sens de votre demande. Ce que vous réglez, vous, c'est le **niveau d'effort** : plus il est élevé, plus Pumaï peut décomposer, déléguer et se relire — mais plus la tâche est longue et coûteuse. ### 1.3 Les espaces de l'interface Le menu du haut regroupe les pages en six familles. | Espace | À quoi il sert | |---|---| | **Dashboard** | Voir l'état de l'instance d'un coup d'œil. | | **Activité** | Comprendre ce que Pumaï a décidé, fait et produit. | | **Chat** | Demander quelque chose maintenant et suivre le raisonnement. | | **Automatisation** | Programmer des tâches, créer des surveillances, lancer des productions en série. | | **Mémoire & Profil** | Définir les agents, leurs données, leur personnalité et leurs partages. | | **Système** | Configurer outils, connexions, sécurité, API et réglages avancés. | Trois pages complètent l'ensemble et méritent d'être connues tôt : **Courrier** (la boîte mail de l'assistant), **Armoire** (les documents durables) et **À valider** (les actions en attente de votre accord). ### 1.4 L'interrupteur global des automatisations En haut de l'interface, un interrupteur **ON/OFF** suspend ou reprend **toutes** les automatisations en même temps : - les tâches planifiées ; - les missions Pulsar ; - les chantiers en cours. Utilisez-le avant une maintenance, pendant une phase de configuration, ou en urgence si une automatisation se comporte mal. Il ne désactive pas les tâches une par une, et il n'empêche pas d'utiliser le Chat manuellement — c'est un frein d'urgence, pas un interrupteur général de l'application. ### 1.5 Les quatre façons de faire travailler Pumaï C'est le point le plus important du guide, et celui qui provoque le plus d'erreurs. Il y a quatre manières de déclencher du travail, et elles ne sont pas interchangeables. | | Vous dites… | Ce qui déclenche | |---|---|---| | **Chat** | « Fais-le maintenant » | Vous | | **Tâche planifiée** | « Fais-le tous les jours à 8 h » | L'horloge | | **Pulsar** | « Surveille, et préviens-moi si ça change » | Une ronde régulière + un changement | | **Chantier** | « Fabrique-moi ces 36 éléments » | Une file de travail qui se vide | Le chapitre 3 détaille chacune. Si vous ne deviez retenir qu'une chose : **le Pulsar se souvient** d'un passage à l'autre, la **tâche planifiée** repart de zéro à chaque fois, et le **chantier** n'attend aucune horloge — il enchaîne. --- ## 2. Première installation, pas à pas Ce chapitre est le plus long, et c'est normal : la quasi-totalité des difficultés de prise en main viennent d'une configuration incomplète. Suivez l'ordre proposé, il évite les impasses. ### 2.0 Ce qu'il faut préparer avant de commencer Prévoyez une petite demi-heure et ayez sous la main : 1. **Une adresse email dédiée à l'assistant.** Pas la vôtre : une adresse à lui. Voir 2.4 — c'est le point qui demande le plus de préparation, car il faut la créer chez un fournisseur de messagerie avant de pouvoir la renseigner ici. 2. **Un compte chez un fournisseur de modèles d'IA**, si votre instance n'est pas déjà fournie avec des crédits. C'est ce qui permet à Pumaï de réfléchir. Selon votre formule, cette partie est peut-être déjà réglée pour vous : vérifiez la page **Crédits**. 3. **Une clé de recherche Web**, si vous voulez que l'assistant puisse chercher sur Internet. Voir 2.5. 4. **Vos identifiants d'accès à l'interface**, fournis à la création de l'instance. Vous n'avez pas besoin de tout avoir dès la première minute. Un assistant sans boîte mail et sans accès Web fonctionne déjà très bien pour discuter, analyser un document que vous lui déposez et produire des fichiers. Vous ajouterez les accès au fur et à mesure. ### 2.1 Étape 1 — La fiche du propriétaire Ouvrez **Mémoire & Profil → Profils**. Tout en haut de la page, avant la sélection d'un profil, se trouve la carte **Propriétaire de l'instance**. Renseignez : - votre nom ; - votre adresse email ; - votre rôle ou fonction ; - votre téléphone, si utile. Cette fiche décrit **la personne que Pumaï sert**. Elle est commune à tous les profils, et elle a deux effets très concrets : c'est l'adresse à laquelle partent les notifications qui vous sont destinées, et c'est ce qui permet à l'assistant de ne pas vous confondre avec un client. Ne confondez pas cette fiche avec une entrée de l'annuaire : l'annuaire liste vos contacts, la fiche propriétaire, c'est vous. ### 2.2 Étape 2 — L'assistant et son contexte métier Ouvrez **Mémoire & Profil → Assistant**. Vous décrivez ici le cadre général dans lequel l'assistant travaille : - son nom affiché ; - son rôle principal ; - sa mission générale, en quelques phrases ; - trois à six objectifs prioritaires ; - son style de communication ; - ses garde-fous — ce qu'il ne doit jamais faire ; - l'annuaire de l'entreprise, si vous en avez besoin. Écrivez ces champs comme vous les écririez pour une nouvelle recrue. « Tu es l'assistant d'un cabinet d'architecture de six personnes ; tu réponds en français, poliment mais sans flagornerie ; tu ne promets jamais un délai ou un prix qui ne figure pas dans nos documents » est bien plus utile que trois mots-clés. Cette page décrit le cadre **général**. Les réglages opérationnels propres à chaque agent (modèle, température, outils autorisés) se trouvent, eux, dans **Profils**. ### 2.3 Étape 3 — Les profils Un profil est une identité de travail complète, avec sa mémoire et ses droits. Ne créez pas un profil pour chaque petite tâche : créez-en un quand une activité a besoin d'au moins l'un de ces éléments : - une personnalité différente ; - une mémoire séparée ; - un ensemble d'outils particulier ; - un niveau d'autonomie différent ; - un métier ou un canal clairement distinct. Une structure de départ qui fonctionne bien : - **Assistant principal** — type Discussion, celui à qui vous parlez dans le Chat ; - **Secrétariat** — type Autonome, pour le courrier et le suivi des dossiers ; - **Veille** — type Autonome, pour les surveillances et les rapports. Le chapitre 4 détaille les profils et, surtout, ce qu'ils partagent ou non entre eux. ### 2.4 Étape 4 — Donner une boîte mail à l'assistant C'est l'étape la plus structurante, et celle qui demande le plus d'explications. Prenez le temps. #### Pourquoi une adresse à lui, et pas la vôtre Un assistant qui traite le courrier a besoin de **sa propre adresse**, pour trois raisons : 1. **La traçabilité.** Vous devez pouvoir distinguer d'un coup d'œil ce que vous avez écrit de ce que l'assistant a écrit. Avec une adresse partagée, c'est impossible. 2. **La sécurité.** Vous lui confiez un mot de passe de messagerie. S'il s'agit de votre boîte personnelle, vous lui confiez toute votre correspondance privée, vos réinitialisations de mot de passe et vos documents personnels. 3. **La réversibilité.** Le jour où vous voulez arrêter, vous fermez une adresse. Vous n'avez pas à changer le mot de passe de votre vie numérique. Une bonne pratique : une adresse au nom de l'assistant sur votre domaine, du type *assistant@ votre-domaine*, ou une adresse gratuite dédiée si vous n'avez pas de domaine. #### Créer l'adresse et récupérer ses réglages Créez l'adresse chez le fournisseur de messagerie de votre choix — celui de votre nom de domaine, ou un service grand public. Puis, dans l'espace de configuration de cette boîte, vérifiez deux choses. **1. Que l'accès IMAP est activé.** IMAP est le protocole qui permet à un logiciel extérieur de lire une boîte mail. Certains fournisseurs le désactivent par défaut ; il faut alors l'activer, souvent dans une section « accès externe », « clients de messagerie » ou « POP/IMAP ». **2. Qu'un mot de passe d'application est disponible.** La plupart des fournisseurs sérieux n'acceptent plus le mot de passe du compte pour un accès extérieur : ils demandent de générer un **mot de passe d'application**, un mot de passe secondaire réservé à un logiciel donné. C'est celui que vous donnerez à Pumaï. L'intérêt est important : il ne donne pas accès aux réglages du compte, et vous pouvez le révoquer sans changer votre mot de passe principal. Notez ensuite les quatre réglages techniques que votre fournisseur publie dans son aide, en général sous le titre « paramètres IMAP et SMTP » : | Réglage | Ce que c'est | Valeur habituelle | |---|---|---| | Serveur entrant (IMAP) | La machine qui détient les messages reçus | `imap.` suivi du nom du fournisseur | | Port entrant | Le « numéro de porte » du serveur entrant | **993**, en connexion chiffrée SSL | | Serveur sortant (SMTP) | La machine qui expédie les messages | `smtp.` suivi du nom du fournisseur | | Port sortant | Le « numéro de porte » du serveur sortant | **465**, en connexion chiffrée SSL | Ne cherchez pas à comprendre ces valeurs : recopiez celles que votre fournisseur indique. Si son aide propose plusieurs possibilités, choisissez systématiquement la variante **chiffrée** (SSL ou TLS), jamais la variante « non sécurisée ». #### Renseigner ces informations dans Pumaï Ouvrez **Système → Outils**. Les outils sont regroupés par famille ; cherchez la famille **mail** et ouvrez la fiche du bundle correspondant. Une fiche d'outil affiche un badge clair : **✔ Configuré** ou **⚠ Non configuré**. Dépliez la section de configuration et remplissez : - **le serveur et le port entrants** (IMAP) ; - **le serveur et le port sortants** (SMTP) ; - **l'identifiant** du compte — le plus souvent l'adresse email complète ; - **le mot de passe d'application** obtenu à l'étape précédente ; - **l'adresse d'expédition**, c'est-à-dire l'adresse qui apparaîtra comme expéditeur. Enregistrez, puis **activez** l'outil avec son interrupteur. #### Décider ce qu'il a le droit d'envoyer Deux réglages, sur la même fiche, gouvernent les envois. Ce sont les plus importants de toute l'installation, car ce sont eux qui empêchent une IA d'écrire à n'importe qui. **La liste des destinataires autorisés.** C'est un **droit d'envoi**, pas un simple filtre : une adresse qui figure dans cette liste peut recevoir un message ; une adresse absente ne le peut pas. Commencez par n'y mettre que votre propre adresse. Vous l'élargirez plus tard. **La politique d'envoi**, qui prend deux valeurs : - **Brouillon** — l'assistant ne peut jamais expédier lui-même. Tout ce qu'il rédige est déposé dans les brouillons de la boîte, et c'est vous qui décidez. C'est le réglage recommandé pour débuter. - **Envoi direct** — un message destiné à une adresse **autorisée** part réellement ; un message destiné à toute autre adresse **bascule automatiquement en brouillon**, et l'assistant vous dit clairement qu'il n'a pas envoyé. Il n'existe pas de configuration dans laquelle Pumaï écrit à une adresse que vous n'avez pas autorisée. Si vous videz la liste, plus rien ne part. #### Vérifier que ça marche Ouvrez la page **Courrier**. Si la configuration est bonne, vous voyez les dossiers réels de la boîte et ses messages. Si la page reste vide ou affiche une erreur, reprenez le dépannage au chapitre 11, section « Aucun email n'apparaît ». Faites ensuite un essai depuis le **Chat** : *« Résume-moi les trois derniers messages reçus. »* S'il vous les résume, la lecture fonctionne. Puis : *« Prépare un brouillon de réponse au dernier message, ne l'envoie pas. »* Le brouillon doit apparaître dans la page Courrier. ### 2.5 Étape 5 — Donner accès au Web Par défaut, l'assistant ne sait pas chercher sur Internet. Deux moyens existent, et ils ne se valent pas. **La recherche par moteur.** Elle interroge un vrai moteur de recherche et rend une liste de résultats. Elle demande une **clé d'API** auprès du fournisseur du moteur — l'outil de recherche livré avec Pumaï utilise l'API du moteur **Brave Search**. Le principe est toujours le même : 1. créez un compte sur le site du fournisseur du moteur ; 2. souscrivez à son offre d'API (il existe généralement un palier gratuit largement suffisant pour un usage d'assistant) ; 3. copiez la clé qu'il vous donne — une longue suite de caractères ; 4. dans **Système → Outils**, ouvrez la fiche de l'outil de recherche Web, collez la clé dans le champ prévu, enregistrez, activez. **La lecture de page.** L'outil qui récupère le contenu d'une adresse Web précise ne demande, lui, aucune clé. Si vous n'avez pas besoin de recherche mais seulement de suivre des pages que vous connaissez déjà, il suffit. > **Une clé d'API, c'est quoi ?** Un mot de passe destiné à un programme plutôt qu'à un humain. Le > fournisseur le génère, vous le collez dans Pumaï, et il sert à savoir que c'est bien votre compte > qui appelle le service. Comme tout mot de passe, il ne se partage pas, ne se met pas dans un > message, et se révoque s'il a fuité. ### 2.6 Étape 6 — Les autres outils : le principe est toujours le même Vous venez de configurer deux outils. Tous les autres suivent exactement la même logique, ce qui rend la suite beaucoup plus rapide. Sur la page **Système → Outils** : 1. **trouvez l'outil** — les outils sont groupés par famille : mail, Web, fichiers, mémoire, notifications, images, système, annuaire… ; 2. **lisez sa description** — elle dit ce qu'il fait vraiment, ce qui évite bien des malentendus ; 3. **renseignez sa configuration**, s'il en demande une. Un badge indique **✔ Configuré** ou **⚠ Non configuré** ; 4. **activez-le** — un outil désactivé n'est pas proposé à l'assistant du tout ; il ne peut donc ni l'utiliser, ni même savoir qu'il existe ; 5. **choisissez s'il doit demander votre validation** — l'interrupteur « Demander ma validation » suspend chaque utilisation de cet outil en attendant votre accord ; 6. si nécessaire, **restreignez-le à certains profils** depuis **Profils → Paramètres**. Quelques exemples de besoins et de l'outil correspondant : | Vous voulez… | Configurez… | |---|---| | Traiter les emails | le bundle **mail** (étape 2.4) | | Chercher sur le Web | l'outil de **recherche Web** (étape 2.5) | | Produire un PDF ou un document | la famille **fichiers** — aucune clé nécessaire | | Générer des images | la famille **image** — utilise vos crédits IA, pas de clé séparée | | Envoyer une alerte sur Telegram | un **gateway** Telegram (chapitre 5.6) | | Répondre au téléphone, ou appeler quelqu'un | un **gateway** Téléphone (Twilio) — compte Twilio requis (chapitre 5.6) | | Administrer un serveur | une connexion **SSH** (chapitre 5.7) | | Suivre des tickets et des projets | le bundle **Renkany** (chapitre 5.4) | **Un principe à retenir : n'activez que ce dont vous avez besoin.** Chaque outil actif est décrit à l'assistant, ce qui occupe de la place dans son raisonnement et lui offre une tentation de plus. Un assistant avec six outils bien choisis travaille mieux qu'un assistant avec quarante. ### 2.7 Étape 7 — Choisir le niveau de contrôle Ouvrez la page **À valider**. En haut se trouve le mode global : - **Mode supervisé** — les outils sur lesquels vous avez activé « Demander ma validation » s'arrêtent avant d'agir et déposent une proposition que vous devez accepter ou refuser ; - **Mode autonome** — tout s'exécute sans passer par cette file, mais tout reste journalisé. Pour un premier déploiement, restez en **mode supervisé**, et mettez sous validation les actions qui ont un effet sur le monde extérieur : envoi de mail, publication, modification sur un serveur distant, suppression, appel d'API qui engage quelque chose. Vous relâcherez ce contrôle progressivement, outil par outil, après avoir vu plusieurs exécutions correctes. C'est plus sûr, et surtout plus instructif : les propositions refusées vous apprennent précisément où votre instruction était ambiguë. ### 2.8 Étape 8 — Tester dans le Chat avant d'automatiser **Ne programmez jamais une automatisation que vous n'avez pas d'abord jouée à la main.** Ouvrez le Chat, sélectionnez le profil que l'automatisation utilisera, et donnez-lui exactement la même instruction. Vérifiez : - que l'outil nécessaire est bien disponible ; - que les identifiants fonctionnent ; - que le résultat a le bon format ; - que le bon destinataire, la bonne cible ou le bon dossier est utilisé ; - que les demandes de validation apparaissent comme prévu. Un test au Chat coûte deux minutes. Une tâche planifiée mal réglée peut se tromper toutes les nuits pendant une semaine avant que vous ne le remarquiez. ### 2.9 Étape 9 — Automatiser, puis contrôler Créez ensuite la tâche planifiée, le Pulsar ou le chantier (chapitre 3), lancez une **première exécution manuelle**, puis contrôlez : - **Activité** pour le résultat métier ; - l'**historique** de la tâche, de la mission ou du chantier ; - **À valider** pour les actions suspendues ; - **Courrier** si un mail devait partir ; - **Armoire** si un fichier devait être conservé ; - **Logs** en cas de problème technique. ### 2.10 La check-list de la première heure - [ ] Fiche propriétaire remplie - [ ] Assistant décrit : rôle, mission, style, garde-fous - [ ] Au moins un profil créé - [ ] Boîte mail dédiée créée chez un fournisseur, IMAP activé, mot de passe d'application généré - [ ] Bundle mail configuré, testé depuis la page Courrier - [ ] Liste des destinataires autorisés limitée à votre seule adresse - [ ] Politique d'envoi sur **Brouillon** - [ ] Recherche Web configurée si nécessaire - [ ] Mode supervisé actif, validation demandée sur les actions externes - [ ] Un aller-retour réussi dans le Chat - [ ] Une première automatisation créée, exécutée manuellement, et vérifiée --- ## 3. Chat, tâche planifiée, Pulsar ou chantier ? ### 3.1 Les quatre modes en une phrase - **Le Chat**, c'est une conversation. Vous demandez, il fait, vous voyez, vous corrigez. - **La tâche planifiée**, c'est un rendez-vous. À telle heure, telle instruction est exécutée — et elle repart d'une page blanche à chaque fois. - **Le Pulsar**, c'est une ronde de surveillance. À intervalles réguliers, il va voir, **compare avec ce qu'il avait vu la fois d'avant**, et ne vous dérange que s'il y a du nouveau. - **Le chantier**, c'est une file de production. Vous lui donnez une liste, il la déroule d'un bout à l'autre sans attendre aucune horloge, et s'arrête quand elle est vide. ### 3.2 L'arbre de décision ```text Est-ce que je veux le résultat maintenant, sous les yeux ? └── oui → CHAT Non. Est-ce que c'est une liste d'éléments à fabriquer ? └── oui → CHANTIER Non. Est-ce que je veux être prévenu seulement si quelque chose change ? └── oui → PULSAR └── non → TÂCHE PLANIFIÉE ``` ### 3.3 La tâche planifiée en détail C'est le mode le plus simple à comprendre : une instruction, un horaire, un résultat. Utilisez le **Planificateur** pour : - un rapport chaque matin ; - un rappel à une date donnée ; - une publication tous les lundis ; - une opération de routine toutes les deux heures ; - une action ponctuelle dans le futur. Trois façons de régler le déclenchement : - **Cron** — une heure fixe, éventuellement certains jours seulement. « Tous les jours à 8 h », « tous les lundis à 9 h 30 » ; - **Intervalle** — toutes les X heures, minutes ou secondes ; - **Date unique** — une seule exécution, à une date et une heure précises. **Le point à comprendre : une tâche planifiée n'a pas de mémoire de ses exécutions passées.** Elle redémarre à neuf chaque fois. Si vous lui demandez « signale-moi les nouveaux messages », elle n'a aucun moyen de savoir ce qui était déjà là hier : elle vous les signalera tous, tous les jours. C'est exactement pour ce besoin qu'existe le Pulsar. ### 3.4 Le Pulsar en détail Un Pulsar est une mission qui vit dans la durée. À chaque passage — on parle de **tick** — il fait son travail, puis écrit pour lui-même un petit résumé de ce qu'il a constaté : c'est son **état**. Au passage suivant, il relit cet état, le compare à ce qu'il voit, et décide s'il y a matière à vous prévenir. C'est cette mémoire entre deux passages qui fait toute la différence. Elle permet des consignes du type : « préviens-moi seulement si un nouveau concurrent apparaît », « suis cet incident jusqu'à sa résolution », « alerte-moi quand ce prix passe sous tel seuil ». **Les trois types de missions :** - **Permanente** — elle continue tant que vous la laissez active ; - **Conditionnelle** — elle se termine d'elle-même quand une condition est vérifiée assez longtemps ; - **Temporelle** — elle s'archive à une date d'expiration. **La nature de la mission**, réglée par le champ *Nature de la mission* : - **Veille — surveiller et signaler** (le réglage par défaut). Le protocole impose une collecte fraîche, une comparaison avec l'état précédent, et une notification en cas de détection. - **Production — fabriquer des artefacts**. Ce protocole convient à une mission qui *produit* quelque chose à chaque passage — une fiche, une image, un document — en déroulant une liste. La collecte et la comparaison n'ont alors aucun sens et ne sont pas imposées, et il n'y a pas de notification à chaque fois. > **Attention au niveau d'effort d'une mission de production.** Avec l'effort *Faible*, l'assistant > travaille seul et sans outils : il ne pourra donc *rien fabriquer*. Pour une mission qui doit > réellement appeler des outils, choisissez au minimum *Moyen*. **Ce qu'affiche la carte d'une mission :** le dernier passage, le verdict, un résumé, la consommation cumulée. Le bouton **Logs** montre l'historique, le bouton **État** montre ce que la mission se souvient d'un passage à l'autre — c'est le premier endroit à regarder quand une mission se comporte bizarrement. **Deux boutons à connaître :** - **⚡ Exécuter maintenant** — exécute *cette* mission tout de suite, sans attendre sa prochaine échéance. Il contourne la cadence et le délai d'attente après erreur, mais il respecte les arrêts que vous avez demandés : si les automatisations sont en pause, ou si la mission est en pause, il refuse et vous dit pourquoi. - **🏗 En chantier** — n'apparaît que sur une mission de type *Production*. Il recopie les réglages de la mission dans le formulaire d'un chantier ; il ne crée rien tout seul. Voir 3.6. Un badge **⌛** sur une carte signifie que la mission ne tournera pas au prochain réveil, et la carte dit pourquoi (elle est en pause, elle n'a pas atteint sa cadence, ou elle attend après une erreur). ### 3.5 Le chantier en détail Un **chantier** produit une série d'éléments d'un seul tenant. Vous lui donnez une consigne de production et une liste, il fabrique élément après élément jusqu'à ce que la liste soit vide. **Ce qui le distingue vraiment d'un Pulsar de production**, c'est qu'il **n'attend aucune horloge**. Un Pulsar fabrique un élément par ronde ; si votre instance fait sa ronde toutes les trois heures, 36 éléments demandent quatre jours et demi. Le même travail confié à un chantier s'enchaîne sans interruption. Deuxième différence, moins visible mais tout aussi importante : **la liste vit dans le chantier, pas dans la consigne**. C'est le logiciel qui tient le compte de ce qui est fait et de ce qui reste — pas l'assistant, qui pourrait l'oublier ou se tromper. C'est ce qui permet d'afficher une barre « 12 / 36 », de relancer précisément l'élément n° 7 qui a échoué, et de savoir avec certitude que le chantier est terminé. **Les deux modes de chantier :** - **Liste** — vous énumérez les éléments à produire, un par ligne. Le chantier connaît le total, affiche une progression exacte, et s'arrête tout seul quand la liste est épuisée. C'est le mode à utiliser dès que vous pouvez écrire la liste. - **Ouvert** — vous ne donnez pas de liste, seulement un **nombre d'itérations**. Le contenu s'invente au fil de l'eau. Le chantier s'arrête au nombre demandé, ou plus tôt si l'assistant déclare qu'il n'y a plus rien à produire. **La consigne de production et le mot `{{item}}`.** Vous écrivez une consigne unique, valable pour tous les éléments, et vous placez `{{item}}` à l'endroit où l'élément doit apparaître : ```text MISSION — produis une planche de coloriage de {{item}}. Trait encré noir, fond clair, format A4 portrait. Range le fichier dans l'Armoire avec une étiquette « coloriage ». ``` Vous pouvez aussi utiliser `{{rang}}` pour le numéro de l'élément. Si vous oubliez `{{item}}`, ce n'est pas grave : l'élément est ajouté en fin de consigne dans un bloc dédié. **Les garde-fous.** Un chantier engage des dépenses réelles, en série. Trois réglages les bornent : - **le plafond de coût** — le chantier s'arrête dès que la dépense atteint ce montant ; - **le plafond en tokens** — la même idée, mais comptée en unités de travail plutôt qu'en argent. Utile car certains fournisseurs de modèles ne publient pas leurs tarifs, auquel cas le coût affiché reste à zéro et un plafond en argent ne servirait à rien ; - **le nombre d'échecs consécutifs tolérés** — au-delà, le chantier s'arrête au lieu de s'entêter. Un quatrième réglage, la **pause entre deux éléments**, sert quand votre fournisseur limite la cadence des appels. **Un chantier créé ne démarre pas tout seul.** Vous relisez la liste et l'estimation, puis vous cliquez sur **Lancer**. De même, après un redémarrage du serveur, un chantier en cours est mis en pause et vous attend : personne n'a envie qu'une machine reprenne toute seule trente générations payantes. **Quand il s'arrête, il dit toujours pourquoi** : file vide, l'agent a déclaré la fin, plafond de coût atteint, plafond de tokens atteint, trop d'échecs consécutifs, quota épuisé, arrêt demandé, automatisations en pause, ou redémarrage du serveur. Un chantier arrêté par un plafond conserve ses éléments restants en attente : relevez le plafond et relancez, rien n'est perdu. ### 3.6 L'erreur la plus fréquente Vous voulez trente illustrations, ou quarante fiches produit, ou une série de documents. Le réflexe naturel est de créer un Pulsar de production et de le laisser tourner. Ne le faites pas : - il ne fabrique **qu'un élément par ronde**, et la cadence des rondes est partagée avec toutes vos autres missions — vous ne pouvez pas l'accélérer sans accélérer tout le reste ; - **rien ne l'arrête** : quand la liste est finie, il continue de se réveiller, de réfléchir, et de conclure qu'il n'y a rien à faire — chaque fois pour un coût réel ; - c'est **l'assistant** qui doit se souvenir de ce qu'il a déjà produit, et il peut se tromper. Le chantier a été conçu exactement pour ce cas. Si vous avez déjà une mission de production qui tourne, le bouton **🏗 En chantier** de sa carte recopie ses réglages dans un formulaire de chantier : il ne vous reste qu'à coller la liste. Inversement, ne mettez pas une **veille** dans un chantier : une surveillance n'a pas de liste et ne se termine pas, c'est un Pulsar. ### 3.7 Fréquences et cadences La cadence générale des rondes se règle dans **Système → Dev → Cadence des Pulsars**. C'est le rythme auquel Pumaï se réveille pour regarder ses missions. Chaque mission peut ensuite affiner : - **Chaque tick** — à chaque ronde générale ; - **Toutes les heures** ou **Quotidien** — un filtre supplémentaire ; - **Intervalle personnalisé**, en minutes, qui devient prioritaire. Par exemple 360 pour six heures, 1440 pour une journée, 10080 pour une semaine. Évitez les fréquences très courtes pour une information qui bouge rarement : chaque passage consomme des crédits et sollicite des services extérieurs. Une veille concurrentielle toutes les cinq minutes n'apprend rien de plus qu'une veille quotidienne, et coûte 288 fois plus cher. ### 3.8 Le niveau d'effort L'effort règle la profondeur du travail : combien d'agents peuvent être mobilisés, combien d'allers-retours ils s'autorisent, et s'ils se relisent. | Besoin | Effort conseillé | |---|---| | Vérification simple et récurrente | Faible | | Résumé, analyse standard, production d'un élément | Moyen | | Recherche approfondie, document important | Fort | | Travail complexe, avec critique et plusieurs spécialistes | Très fort | Deux pièges classiques : - **Faible** est parfait pour une veille qui regarde et conclut, mais il **interdit toute délégation** : un travail qui doit appeler des outils pour fabriquer quelque chose n'y arrivera pas. Prenez *Moyen* au minimum. - **Très fort** sur une tâche fréquente coûte très cher pour un bénéfice souvent nul. Réservez-le aux productions ponctuelles et importantes. ### 3.9 Le contrôle qualité avant livraison Les trois formulaires — tâche planifiée, Pulsar et chantier — proposent une case **Vérifier la cohérence avant livraison** (nommée *Contrôle qualité avant livraison* sur les chantiers). Quand elle est cochée, l'agent qui vient de produire le livrable le **relit** avant de conclure : il cherche les incohérences — dates qui se contredisent, chiffres qui ne tombent pas juste, promesses qui dépassent la consigne — et corrige les passages fautifs. Il ne réécrit pas tout, il corrige. Utilisez-la dès qu'un livrable est destiné à sortir de chez vous : un rapport envoyé à un client, un document publié, une fiche transmise. Elle est inutile pour une veille qui ne produit qu'une ligne de verdict. Ce réglage est **indépendant du niveau d'effort** : vous pouvez avoir un contrôle qualité avec un effort *Moyen*, sans payer la profondeur d'un effort *Fort*. ### 3.10 Choisir la livraison Une tâche planifiée peut livrer son résultat par email, par Telegram, dans l'interface Web, ou nulle part — le résultat reste alors consultable dans les journaux. **Le canal doit être configuré avant le premier lancement.** Choisir « Telegram » dans le formulaire ne crée pas le bot ; choisir « email » ne crée pas la boîte. Le formulaire vous laisse sélectionner un canal qui n'existe pas encore, et l'erreur n'apparaîtra qu'à l'exécution. --- ## 4. Les profils et le partage des données ### 4.1 Qu'est-ce qu'un profil ? Un profil est une identité de travail complète. Il possède : - un type, **Discussion** ou **Autonome** ; - une identité et une personnalité ; - une « âme », c'est-à-dire sa voix et sa posture ; - une mémoire durable qui lui appartient ; - des notes quotidiennes et des consolidations nocturnes ; - un annuaire ; - des dossiers en cours et une boîte de messages internes ; - un modèle, une température et un fuseau horaire ; - une liste d'outils autorisés ; - un mode de validation ; - des droits de lecture sur les données d'autres profils. ### 4.2 Profil Discussion et profil Autonome Un profil **Discussion** sert aux échanges directs. Dans l'interface, vous le choisissez depuis le Chat. Pour Telegram ou Discord, le canal relaie vers une session de chat qui porte elle-même un profil. Un profil **Autonome** sert aux tâches planifiées, aux Pulsars et aux chantiers : secrétaire, veilleur, analyste, superviseur technique. Le type aide à organiser les usages ; le profil exact reste choisi explicitement dans le Chat, le Planificateur, le Pulsar, le chantier ou la configuration du téléphone. ### 4.3 Les onglets d'un profil | Onglet | Usage | |---|---| | **Identité** | Contexte métier, rôle, périmètre. | | **Âme** | Voix, posture, continuité. À modifier avec précaution. | | **Mémoire** | Faits durables propres à ce profil. | | **Dreams** | Observations consolidées, avant promotion éventuelle en mémoire stable. | | **Notes** | Journal quotidien. | | **Annuaire** | Équipe, clients, prospects, prestataires, partenaires. | | **Dossiers** | Affaires ouvertes, statut, notes, résolution. | | **Inbox** | Messages laissés par les agents autonomes. | | **Missions** | États mémorisés des missions Pulsar. | | **Paramètres** | Modèle, température, mémoire, autonomie, fuseau, outils autorisés. | | **Partage** | Données d'autres profils que celui-ci peut lire. | | **Profil User** | Ce que l'assistant a mémorisé sur son interlocuteur. | ### 4.4 La règle de partage entre profils Par défaut, **les mémoires des profils sont isolées**. Dans l'onglet **Partage**, vous autorisez le profil sélectionné à lire la mémoire durable et les notes récentes d'un autre profil. Le partage est **à sens unique** : ```text A est autorisé à lire B ≠ B est autorisé à lire A ``` Si « Secrétariat » doit consulter la mémoire de « Assistant principal », ouvrez **Secrétariat → Partage** et cochez « Assistant principal ». Ne cochez l'autre sens que si le besoin existe vraiment. La personnalité, l'âme et le journal des consolidations restent toujours privés au profil. ### 4.5 Les données communes Certaines données échappent volontairement à cette isolation : - la **fiche propriétaire** est commune à toute l'instance ; - l'**Armoire** est un espace documentaire central, partagé par tous les profils ; - les documents de l'étagère **Référence** de l'Armoire sont consultables par tous les agents ; - l'étagère **Archive** conserve sans rendre consultable ; - l'annuaire principal peut servir de contexte transversal aux profils autonomes. Conséquence pratique : **ne déposez pas un document confidentiel dans l'Armoire** d'une instance utilisée par plusieurs activités qui doivent rester séparées. Placez-le dans la mémoire du profil concerné, ou utilisez une instance distincte si la frontière doit être stricte. ### 4.6 Les outils autorisés par profil Dans **Profils → Paramètres → Outils autorisés** : - une liste **vide** signifie « tous les outils globalement actifs » ; - une liste **remplie** devient une liste blanche stricte. Un profil de veille n'a besoin que du Web, de la mémoire, des fichiers et des notifications. Il n'a aucune raison de disposer d'un outil de suppression ou d'administration système. ### 4.7 Le mode de validation par profil Chaque profil peut hériter du réglage global, être **supervisé**, ou être **autonome**. Gardez supervisées les activités nouvelles ou risquées, et augmentez leur autonomie après avoir vérifié plusieurs exécutions correctes. --- ## 5. Outils, compétences, connecteurs et canaux ### 5.1 Les quatre notions Ces quatre mots répondent à quatre questions différentes, et les confondre est une source d'erreurs fréquente. | Notion | Question | Exemple | |---|---|---| | **Outil** | Que peut *faire* l'agent ? | Envoyer un mail, créer un PDF, générer une image. | | **Compétence** | Comment doit-il *bien* le faire ? | La procédure de votre revue de presse. | | **Connecteur MCP** | D'où viennent des outils *supplémentaires* ? | Un serveur externe qui expose ses propres outils. | | **Gateway** | Par quel *canal* un humain lui parle-t-il ? | Telegram, Discord, téléphone. | ### 5.2 Les outils Un outil est une fonction exécutable. La page **Outils** permet de voir son utilité, l'activer ou le désactiver, vérifier s'il est configuré, exiger une validation avant chaque usage, connaître son niveau de risque, et le restreindre par profil. Les outils sont regroupés en **familles** (ou *bundles*) : mail, Web, fichiers, mémoire, notifications, images, système, annuaire, planification, surveillance. Deux outils méritent une mention particulière, car ils sont récents et changent la façon de travailler : **La génération d'images.** L'assistant peut fabriquer une image à partir d'une description. Trois points à savoir : le modèle utilisé se choisit dans **Système → Dev**, et son tarif est affiché dans le sélecteur ; le nombre d'images produites par exécution est plafonné, pour éviter les mauvaises surprises ; et pour obtenir une **série cohérente** — même style d'un dessin à l'autre — il faut lui fournir une image de référence, en lui donnant l'identifiant d'un document de l'Armoire. La graine aléatoire, elle, sert à **rejouer** une image à l'identique, pas à rendre deux images différentes cohérentes entre elles. **La modification de fichier.** L'assistant peut remplacer un passage précis d'un document qu'il a produit, au lieu de le réécrire entièrement. C'est ce qui rend le contrôle qualité (3.9) réaliste : corriger deux dates incohérentes coûte deux modifications, pas une régénération complète du document — laquelle risquerait de casser ailleurs ce qu'elle répare. ### 5.3 Les compétences Une compétence est une **procédure réutilisable** : la bonne façon de faire un type de tâche, écrite une fois pour toutes. Elle peut définir quand l'utiliser, les étapes à suivre, les outils nécessaires, le niveau d'effort, le format attendu et les critères de réussite. Une compétence **ne donne aucun accès** : les outils qu'elle mentionne doivent rester actifs et autorisés pour le profil concerné. Vous pouvez laisser l'orchestrateur choisir la compétence adaptée au sens de la demande, ou en imposer une dans une mission, une tâche ou un chantier. Dans les champs de saisie compatibles, tapez `#` pour insérer une compétence et `/` pour insérer un outil : le nom s'insère sous forme de pastille colorée. C'est une **indication** donnée à l'orchestrateur, pas une garantie. ### 5.4 Le suivi de tickets et de projets (bundle Renkany) Pumaï peut se brancher sur **Renkany**, un outil de gestion de tickets et de projets, pour lire l'état réel du travail et agir dessus. Cette intégration est fournie sous forme d'un bundle d'outils dédié, et elle est **livrée désactivée** : elle ne fait rien tant que vous ne l'avez pas configurée et activée. Si vous n'utilisez pas Renkany, ignorez cette section — l'intégration n'a alors aucun effet et ne coûte rien. #### Ce qu'elle permet **En lecture** — l'assistant peut consulter : - les tickets, filtrés par statut, priorité, personne assignée, échéance, projet ; - le détail d'un ticket, avec son fil de commentaires et ses pièces jointes ; - la liste des projets et l'annuaire des personnes ; - la charge de travail par personne ; - le respect des délais de traitement ; - le temps passé ; - le journal d'activité. **En écriture** — il peut : - créer un ticket dans un projet ; - changer le statut d'un ticket, ce qui est la façon de le passer en « résolu » ; - le réassigner à quelqu'un d'autre ; - y ajouter un commentaire ; - y joindre un fichier. **Ce qu'elle ne permet pas, délibérément :** aucune suppression n'est exposée — ni ticket, ni projet, ni commentaire, ni pièce jointe — et l'assistant ne peut ni créer un projet, ni remplacer la liste des membres d'un projet. Ces gestes restent humains. #### La configurer Ouvrez **Système → Outils**, trouvez la famille correspondante, et renseignez : - **l'adresse de l'API** de votre instance de suivi ; - **le jeton d'accès** — l'équivalent d'une clé d'API, obtenu depuis votre outil de suivi ; - **la politique d'écriture** (voir ci-dessous). Puis activez le bundle. > **Prenez un jeton avec les droits d'administration de l'entreprise.** Un jeton de rôle plus > restreint répond *partiellement* — il rend les tickets auxquels il a droit — **sans le dire**. > Vous obtiendrez alors des comptages faux, sans le moindre message d'erreur. #### La politique d'écriture Trois valeurs, à choisir en connaissance de cause : - **Aucune écriture** (valeur par défaut) — lecture seule. Activer le bundle depuis la page Outils vous donne donc la consultation, et rien d'autre : l'écriture demande un geste séparé et volontaire. - **Commentaires seulement** — l'assistant peut annoter, pas modifier. - **Écriture complète** — il peut créer, changer de statut, réassigner, commenter, joindre. > **Créer un ticket envoie un email aux personnes assignées** et consomme un quota. Ce n'est jamais > une opération de test : essayez d'abord en lecture seule. #### Deux points de vigilance **Les notes internes.** Quand l'assistant ajoute un commentaire, il écrit par défaut une **note interne**, visible de votre équipe seulement — pas du client. C'est l'inverse du comportement habituel de ce type d'outil, et c'est délibéré : un agent écrit une note de travail, il n'envoie pas du texte au client sans qu'on le lui ait demandé. Pour un commentaire réellement visible du client, il faut le demander explicitement. En lecture, les notes internes sont signalées comme telles, chacune sur sa propre ligne, avec un avertissement. C'est le risque numéro un de cette intégration : un brief client qui recopierait une note interne serait un incident irrattrapable. **Le périmètre.** L'entreprise concernée est déterminée par le jeton, jamais par une demande de l'assistant : une instance Pumaï correspond à un client, donc à une entreprise. Conséquence importante à garder en tête quand vous lisez un résultat : **un comptage vide peut vouloir dire « hors de mon périmètre », pas « rien à signaler »**. L'assistant vous le rappelle à chaque comptage. ### 5.5 Les connecteurs MCP MCP est un standard qui permet à un serveur extérieur d'exposer ses propres outils. Brancher un connecteur MCP, c'est ajouter d'un coup un jeu d'outils que Pumaï ne possédait pas. Le parcours sûr : 1. ajoutez le serveur ; 2. laissez-le **désactivé** le temps de vérifier sa provenance et sa configuration — c'est ainsi qu'il arrive, et cette sécurité est volontaire ; 3. renseignez ses variables ou son autorisation ; 4. activez le serveur ; 5. découvrez les outils qu'il expose ; 6. n'activez que ceux dont vous avez besoin ; 7. réglez leur validation et leur accès par profil. Un serveur local exécute du code sur la machine de Pumaï. N'activez que des serveurs de confiance, et gardez sous validation les outils MCP qui écrivent ou agissent à l'extérieur pendant les premiers essais. ### 5.6 Les gateways Un gateway est une porte d'entrée conversationnelle, pour parler à Pumaï autrement que par l'interface Web : - **Telegram** — un bot, une liste d'utilisateurs autorisés, une session associée ; - **Discord** — un bot, des utilisateurs autorisés, éventuellement un canal, une session ; - **Téléphone (Twilio)** — un vrai numéro de téléphone. Voir ci-dessous. Un gateway ne remplace pas un outil métier : discuter avec Pumaï sur Telegram ne configure pas l'envoi d'emails. #### Le téléphone, en détail C'est la capacité la plus impressionnante et la plus mal comprise : **votre assistant peut décrocher, et il peut appeler.** Ce n'est pas un répondeur — c'est une conversation vocale, en temps réel, menée par le même assistant que dans le Chat, avec sa mémoire et ses outils. **Le fournisseur est Twilio**, et il n'y en a pas d'autre : Pumaï s'appuie sur son service de voix temps réel pour les appels entrants, et sur son API pour les appels sortants. Vous devez donc ouvrir un compte chez Twilio et y acheter un numéro. C'est un service payant, facturé à la minute et **indépendant de vos crédits d'IA** : vous paierez deux choses, la téléphonie chez Twilio et le raisonnement chez votre fournisseur de modèles. **Ce qu'il faut réunir :** | Élément | Où le trouver | |---|---| | **Account SID** | Sur le tableau de bord Twilio. Commence par `AC…`. | | **Auth Token** | Sur le même tableau de bord. C'est un secret : traitez-le comme un mot de passe. | | **Un numéro Twilio** | Acheté depuis leur console, au format international : `+33…`. | | **Une adresse publique en HTTPS** | L'adresse par laquelle Twilio joint **votre** instance. Elle doit être atteignable depuis Internet. | | **Le profil qui décroche** | Le profil Pumaï qui répondra aux appels entrants. | **Le point qui bloque le plus souvent : l'adresse publique.** Twilio est un service extérieur ; pour vous passer un appel, il doit pouvoir atteindre votre instance depuis Internet. Une instance qui n'est joignable que sur votre réseau local ne recevra jamais d'appel. Si votre instance est hébergée et possède déjà une adresse publique, utilisez-la ; sinon il faut exposer temporairement votre machine par un tunnel. **Les deux sens ne demandent pas le même travail :** - **Recevoir un appel** exige toute la configuration ci-dessus, adresse publique comprise, plus un réglage à faire **côté Twilio** : dans les paramètres de votre numéro, le webhook Voice doit pointer vers l'adresse que la page Gateways vous affiche, terminée par `/v1/voice/incoming`. Recopiez-la telle quelle. - **Passer un appel** ne demande que le compte, le jeton et le numéro. C'est plus simple, et c'est souvent par là qu'il vaut mieux commencer pour valider vos identifiants. **Deux outils, à ne pas confondre**, que vous activez comme les autres depuis la page Outils : - **`place_call`** — lance l'appel et rend la main aussitôt. L'assistant ne sait pas ce qui s'est dit ; il sait seulement que l'appel est parti. Pour « préviens-le », « confirme-lui ». - **`call_and_wait`** — lance l'appel **et attend qu'il se termine** pour rapporter ce qui a été dit. C'est celui qu'il faut quand vous attendez une réponse : « appelle-le et demande-lui si le rendez-vous de jeudi tient toujours ». Un appel dure des dizaines de secondes : cet outil est lent par nature, et le moteur en tient compte dans ses limites de temps. Les deux prennent un **numéro au format international**, un **objectif en une phrase** et éventuellement du **contexte**. Rédigez l'objectif comme vous le diriez à quelqu'un à qui vous tendez le téléphone : « savoir si la livraison de mardi est confirmée » vaut mieux que « appeler le fournisseur ». > **Un appel téléphonique est irréversible.** On ne rattrape pas un appel passé, contrairement à un > brouillon d'email. Gardez ces deux outils **sous validation** tant que vous n'avez pas vu > plusieurs appels se dérouler correctement, et n'ouvrez l'autonomie qu'ensuite. ### 5.7 Les connexions SSH La page SSH enregistre les serveurs distants que l'assistant pourra utiliser. Chaque cible possède un alias, un hôte, un port, un utilisateur, une authentification par clé ou par mot de passe, une autorisation d'élévation de privilèges éventuelle, et **une liste de commandes autorisées**. Des profils prédéfinis — Santé, Sécurité, Maintenance, Logs, Conteneurs — permettent de partir d'une liste raisonnable. Préférez toujours une liste blanche minimale à « toutes les commandes ». --- ## 6. L'interface page par page ### 6.0 Ce qu'on trouve sur toutes les pages La barre supérieure permet de suspendre ou reprendre toutes les automatisations, de changer la langue de l'interface, de passer du thème clair au thème sombre, de revenir au Dashboard et de se déconnecter. Plusieurs pages affichent un **bandeau d'aide repliable** qui explique la page en quelques lignes : lisez-le la première fois, il évite souvent une question. Un bouton **Support**, en bas de l'interface, permet de transmettre un retour ; décrivez la page, l'heure et le résultat attendu, cela permet de retrouver le run correspondant dans les Logs. ### 6.1 Dashboard Vue d'ensemble : actions en attente de validation, conversations enregistrées, tâches planifiées actives, missions actives, sources de connaissance, dossiers ouverts. C'est une page d'orientation, pas un journal d'audit. ### 6.2 Activité **C'est la meilleure page pour répondre à « qu'a fait mon assistant ? ».** Elle rassemble : - l'activité de la boîte mail ; - les actions, rapports, réponses et fichiers produits ; - la consommation réelle ; - une estimation, clairement identifiée comme telle, du temps humain économisé ; - une **chronologie des missions**, présentée comme un récit : objectif → déroulé → résultat ; - l'état de chaque profil ; - les propositions en attente ; - les dossiers en cours. Vous pouvez changer de période, et filtrer par profil ou par origine — Chat, tâche planifiée, mission, chantier. Cliquez sur une ligne pour déplier le détail. ### 6.3 Courrier La boîte utilisée par l'assistant : reçus, envoyés, brouillons. Elle dépend du bundle mail configuré au chapitre 2.4. C'est une vue de contrôle, en lecture. Une seule action d'écriture existe : quand un **brouillon** préparé par l'assistant est affiché, un bouton permet de l'envoyer réellement, après votre relecture. Cette validation humaine explicite n'est pas soumise à la liste des destinataires autorisés — c'est vous qui envoyez. Les correspondants sont étiquetés automatiquement : Direction, Équipe, Client, Fournisseur, Assistant ou Externe, et le sens du message (reçu ou envoyé) est déterminé par les adresses, pas par le nom du dossier. ### 6.4 Armoire L'Armoire centralise les fichiers durables de l'instance : documents que vous déposez, rapports et livrables rangés par l'assistant, pièces à transmettre, archives. **Deux étagères :** - **Référence** — le document est indexé, l'assistant peut le retrouver et le citer pour répondre ; - **Archive** — le fichier est conservé, mais n'alimente pas la recherche. **Ce que la fiche d'un document vous dit :** - son **origine** — d'où il vient réellement : une discussion, une mission de veille nommée, une tâche planifiée, un chantier, un envoi par mail, ou vous. C'est un classement fiable, que ni vous ni l'assistant n'avez à saisir ; un filtre permet de n'afficher qu'une origine ; - s'il est **indexé ou non**. Attention à ce point : un document rangé en *Référence* dont le texte n'a pas pu être extrait — une image, un PDF scanné — n'est indexé nulle part, et **aucune mission ne peut le retrouver**. La page le dit désormais explicitement ; - son **identifiant**, affiché et copiable d'un clic. C'est cette valeur que l'on colle dans une mission pour désigner une image de référence ; - ses **étiquettes**, modifiables depuis la fiche dépliée ; - sa **provenance** (vous ou l'assistant), son destinataire éventuel et son statut : à envoyer, envoyé, remplacé. Les documents visuels affichent une vignette. **L'Armoire est durable ; l'espace de travail d'une exécution est temporaire.** Si un fichier produit doit rester disponible après la conversation, demandez explicitement de le ranger dans l'Armoire. ### 6.5 Vitrine La Vitrine transforme le journal réel de l'instance en une page présentable : actions, productions, veilles, décisions, fichiers, affaires traitées. Elle est **privée par défaut**. Le bouton **Publier** crée un lien public contenant un jeton : toute personne qui possède ce lien peut consulter la page sans mot de passe. Les identités et les adresses email y sont masquées, et les fichiers ne sont pas téléchargeables en public — la page atteste leur existence sans livrer leur contenu. Vérifiez tout de même la page avant de la partager. Vous pouvez rédiger la présentation publique, publier, copier le lien, redevenir privé, ou régénérer le lien pour invalider l'ancien. ### 6.6 Chat Le Chat sert à poser une question, demander une action, joindre un document ou une image, suivre le raisonnement et les outils utilisés, récupérer les livrables, interrompre une exécution en cours, et revenir à une conversation antérieure. Avant d'envoyer : choisissez le **profil**, choisissez l'**effort**, joignez les fichiers, et décrivez le résultat attendu **et sa destination**. Changer de profil démarre une nouvelle session, pour éviter de mélanger les contextes. Quelques commandes : - `/task ` — force le traitement en tâche complexe ; - `/new` — nouvelle session ; - `/profile` — affiche le profil utilisateur ; - `/remember ` — demande de mémoriser une information. Tapez `/` pour insérer un outil ou `#` pour insérer une compétence. Les images et documents que vous collez dans le Chat sont récupérables par l'assistant : il peut les analyser, les joindre à un envoi, ou s'en servir comme référence pour générer une image. ### 6.7 À valider Toutes les actions suspendues avant exécution. Pour chacune, vous pouvez **Valider**, **Rejeter**, choisir **Plus tard**, indiquer **Je m'en charge**, corriger certains arguments avant de valider, ou ajouter une note. Vérifiez en priorité le destinataire, la cible, les pièces jointes et les paramètres d'une action irréversible. Un sélecteur permet de voir les propositions de **tous les profils**, et un bouton permet de nettoyer les propositions périmées — l'opération est réversible, rien n'est supprimé. ### 6.8 Planificateur Pour créer une tâche : 1. cliquez sur **Nouvelle tâche** ; 2. donnez un nom lisible ; 3. écrivez l'instruction complète ; 4. choisissez la catégorie : rappel, rendez-vous ou mission ; 5. choisissez Cron, Intervalle ou Date unique ; 6. réglez l'horaire ; 7. choisissez la livraison ; 8. sélectionnez le profil — c'est obligatoire ; 9. choisissez l'effort ; 10. cochez **Vérifier la cohérence avant livraison** si le résultat sort de chez vous ; 11. créez, puis lancez une première exécution manuelle. Depuis la liste, vous pouvez exécuter, modifier, désactiver, réactiver, supprimer et consulter l'historique. La section **Abonnement Calendrier** fournit des adresses ICS pour les rappels et rendez-vous. Ne les partagez pas : elles donnent accès à vos échéances. Régénérer le jeton invalide tous les abonnements précédents. ### 6.9 Pulsar Pour créer une mission : 1. cliquez sur **Nouvelle mission** ; 2. donnez-lui un nom ; 3. choisissez Permanente, Conditionnelle ou Temporelle ; 4. écrivez ce qu'il faut observer, comparer et signaler ; 5. réglez la fréquence, ou un intervalle personnalisé en minutes ; 6. choisissez la **nature** : Veille ou Production ; 7. choisissez l'effort — *Faible* pour une veille simple, *Moyen* au minimum pour une production ; 8. imposez éventuellement une compétence ; 9. cochez le contrôle qualité si nécessaire ; 10. sélectionnez le profil ; 11. enregistrez ; 12. cliquez sur **⚡ Exécuter maintenant** pour un premier essai. Chaque carte affiche le dernier passage, le verdict, un résumé et la consommation cumulée. Les boutons **Logs** et **État** montrent l'historique et la mémoire entre deux passages. Le bouton **Réveiller le heartbeat**, en haut de la page, réveille le mécanisme général : il ne force pas les cadences. Une mission qui n'a pas atteint son échéance ne tournera pas pour autant — la page vous dit d'ailleurs, mission par mission, ce qui sera réellement exécuté. Pour exécuter *une* mission hors cadence, utilisez son bouton **⚡ Exécuter maintenant**. Un Pulsar bien écrit distingue clairement ce qui existait au passage précédent, ce qui est nouveau, ce qui a disparu, ce qui justifie une alerte, et les cas où il doit rester silencieux. ### 6.10 Chantiers Troisième entrée du menu **Automatisation**. Les deux premières sont des horloges ; celle-ci est une file de travail. **Créer un chantier** — bouton **Nouveau chantier** : 1. un **nom** ; 2. la **nature** : *Liste* ou *Ouvert* (voir 3.5) ; 3. la **consigne de production**, avec `{{item}}` à l'endroit où l'élément doit apparaître ; 4. selon la nature, la **liste des éléments** (un par ligne) ou le **nombre d'itérations** ; 5. le **profil** ; 6. l'**effort** — *Moyen* au minimum si les éléments doivent appeler des outils ; 7. une **compétence**, si vous en avez une adaptée ; 8. le **plafond de coût** et/ou le **plafond en tokens** ; 9. le nombre d'**échecs consécutifs tolérés** ; 10. la **pause entre deux éléments**, si votre fournisseur limite la cadence ; 11. le **contrôle qualité avant livraison**, si le résultat doit être irréprochable. Enregistrez. **Le chantier ne démarre pas tout seul** : relisez la liste et l'estimation, puis cliquez sur **Lancer**. **Suivre un chantier.** Sa carte affiche une barre de progression du type « 12 / 36 », la dépense réelle, une estimation de ce qu'il reste à produire, un temps de fin approximatif, l'élément en cours, le nombre d'éléments en échec, et — s'il est arrêté — le motif exact. L'estimation du reste à produire est calculée sur les éléments **déjà** faits. Tant que rien n'a été produit, rien n'est affiché : un chiffre inventé serait pire que pas de chiffre. **Agir.** Les boutons **Éléments** et **Journal** dépliant le détail : chaque élément avec son état, ses fichiers produits, et un bouton **Relancer** pour rejouer précisément celui qui a échoué. Un élément relancé reproduit exactement le même élément, jamais « le suivant ». Les boutons **Pause** et **Arrêter** suspendent la production ; les éléments restants sont conservés en attente. Les chantiers terminés sont regroupés dans une section repliée en bas de page. ### 6.11 Assistant Deux usages : 1. la **configuration métier générale** : identité, mission, objectifs, style, contraintes, annuaire ; 2. les **plannings de mission** : objectif, audience, horizon, ressources, canaux, indicateurs, phases et points de contrôle. Un planning de mission n'est pas une tâche planifiée : il décrit un objectif en plusieurs phases et oriente l'activité dans la durée. Il peut être inactif, actif, en pause ou archivé. La page présente aussi les **dossiers en cours**. Un dossier sert à suivre une affaire jusqu'à sa clôture ; il ne déclenche rien à lui seul. ### 6.12 Mémoire Cette page gère la connaissance persistante d'un profil : sélectionner le profil, ajouter un texte ou un fichier, classer la source, tester une recherche, gérer les segments de conversation et explorer le graphe de connaissance. Elle est organisée en trois onglets : - **Souvenirs** — la liste de ce qui est mémorisé, conversations et documents, avec leur état (mémorisé ou écarté). Le bouton « Voir les faits » montre les éléments **réellement retrouvables**, qui sont l'unité de recherche — pas la conversation entière. Une barre de test permet d'essayer une recherche et de voir le score obtenu. - **Graphe de connaissance** — les entités et les liens que l'assistant a extraits. Cliquer sur une entité ouvre sa fiche. - **Entretien** — les opérations de maintenance. Chacune indique ce qu'elle fait **et ce qu'elle coûte**, car certaines déclenchent un appel au modèle par conversation. Les trois niveaux de mémoire, pour comprendre ce que vous manipulez : l'historique immédiat de la conversation, les résumés des échanges plus anciens, et la mémoire de long terme interrogée par similarité de sens. Si vous n'êtes pas à l'aise avec ces notions, restez sur l'ajout de source et le test de recherche : ce sont les deux seules opérations dont vous avez besoin au quotidien. ### 6.13 Profils Le centre de séparation des rôles et des données (chapitre 4). Commencez par la fiche propriétaire, en haut, puis créez ou sélectionnez un profil et parcourez ses onglets. À la création : un nom lisible, un identifiant stable en minuscules, le bon type, la mémoire longue activée si le profil doit chercher dans ses souvenirs, et le fuseau horaire correspondant à ses horaires de travail. Dans **Paramètres**, une **température** basse convient à un travail factuel, une température plus haute à un travail créatif. Le modèle global reste le meilleur choix tant qu'un besoin précis ne justifie pas une exception. ### 6.14 Outils Les capacités natives, personnalisées et MCP, groupées par famille. Des filtres permettent de chercher par famille, type, exposition, risque, validation et état. Pour un usage courant : ouvrez la fiche d'un outil, lisez sa description, configurez-le, activez-le, choisissez sa validation. Les sections de code et d'arborescence sont réservées aux utilisateurs avancés ; pour créer un outil sans écrire de code, passez par le **Studio**. ### 6.15 Gateways Pour Telegram ou Discord : créez le bot sur la plateforme, récupérez son jeton, renseignez les utilisateurs autorisés, choisissez une session existante, créez le gateway, testez-le, vérifiez qu'il est connecté. Pour le **téléphone**, choisissez le type **Téléphone (Twilio)**, puis : 1. ouvrez un compte sur Twilio et achetez-y un numéro ; 2. relevez l'**Account SID** (il commence par `AC…`) et l'**Auth Token** sur leur tableau de bord ; 3. saisissez-les ici, avec le **numéro** au format international (`+33…`) ; 4. renseignez l'**URL publique en HTTPS** de votre instance — celle par laquelle Twilio la joindra depuis Internet ; 5. choisissez le **profil qui décroche** les appels entrants ; 6. créez le gateway. L'interface affiche alors le **webhook Voice** à recopier **côté Twilio**, dans les paramètres de votre numéro : c'est votre URL publique suivie de `/v1/voice/incoming` ; 7. testez d'abord un appel **sortant** — il ne dépend pas du webhook, et il valide vos identifiants sans dépendre de la joignabilité de votre instance. Si les appels entrants ne fonctionnent pas alors que les sortants passent, le problème est presque toujours le même : votre instance n'est pas atteignable depuis Internet, ou le webhook n'a pas été collé côté Twilio. ### 6.16 SSH Pour ajouter un serveur : **Nouvelle connexion**, un alias sans ambiguïté, l'hôte, le port et l'utilisateur, l'authentification par clé ou par mot de passe, l'élévation de privilèges seulement si nécessaire, un profil de commandes, puis retirez les commandes inutiles. Enregistrez, et testez d'abord une commande de **lecture** depuis le Chat. La page configure la connexion ; la tâche elle-même se crée ensuite dans le Chat, le Planificateur ou le Pulsar. ### 6.17 Crédits Le solde, la consommation et l'historique, lorsque votre instance fonctionne avec des crédits fournis. Si ce mode n'est pas actif, la page vous l'indique. ### 6.18 Studio Le Studio crée un outil sur mesure à partir d'un entretien guidé : décrivez le but, les entrées et la sortie ; répondez aux questions ; relisez le code produit ; déclarez les capacités sensibles nécessaires ; fournissez des arguments de test ; testez en bac à sable ; enregistrez d'abord en version d'essai ; ne passez en version stable qu'après validation. Un outil qui utilise le shell, le réseau ou des écritures sensibles doit rester sous validation. Les versions antérieures peuvent être restaurées. ### 6.19 Compétences Une bibliothèque, un éditeur, une création guidée, un bac à sable comparatif « avec / sans », et un interrupteur global. Pour qu'une compétence soit utile, soignez surtout : un **déclencheur** clair (« quand l'utilisateur demande… »), une **procédure** ordonnée, les **outils** nécessaires, l'**entrée** et la **sortie** attendues, et des **critères de réussite** vérifiables. Le bac à sable exécute réellement deux variantes de la même tâche et consomme donc des crédits. Utilisez une tâche représentative, puis comparez la qualité, le nombre d'étapes et le coût. ### 6.20 Accès API La clé principale, les clés secondaires nommées, la révocation, des exemples et l'accès à la documentation interactive. Une clé secondaire n'est affichée en clair **qu'à sa création** : copiez-la immédiatement dans un gestionnaire de mots de passe. Renouveler la clé principale coupe toutes les intégrations qui utilisent l'ancienne. ### 6.21 Connecteurs MCP Plusieurs méthodes d'ajout : catalogue officiel, recherche dans un registre public, import, commande manuelle, serveur distant avec clé ou autorisation déléguée. Les serveurs arrivent **désactivés**. Après activation, contrôlez chaque outil découvert, ici puis dans **Outils**. ### 6.22 Dev La console des réglages techniques : fournisseurs et modèles, limites des agents, niveaux d'effort, mémoire, cadence des Pulsars, Vitrine, et diverses options avancées. Trois choses à savoir : - **les sélecteurs de modèle affichent le tarif** de chaque modèle. Ce n'est pas un détail : changer de modèle peut multiplier le coût d'une production par trois sans que rien d'autre ne change dans l'interface ; - **certains champs sont en lecture seule**, avec une pastille qui explique qui les pilote. Ce sont ceux que le niveau d'effort impose : les modifier ici n'aurait aucun effet, la page vous l'annonce plutôt que de vous laisser croire le contraire ; - **cette page réécrit la configuration de l'instance.** Si vous ne savez pas exactement ce que fait un réglage, ne le changez pas. ### 6.23 Logs La vue technique de diagnostic : les exécutions, leur origine, leur statut, leur durée et leur consommation ; les agents et sous-agents ; les entrées et sorties d'outils ; les appels au modèle hors exécution ; les appels téléphoniques ; les sessions et les événements d'authentification. Une exécution issue du Chat porte une icône 💬 qui ouvre directement la discussion correspondante. Une exécution en cours peut être interrompue depuis cette page. Règle simple : **Activité** pour contrôler le travail, **Logs** pour comprendre une erreur, une lenteur ou une consommation. ### 6.24 Dossiers Les dossiers — aussi appelés boucles ouvertes — représentent les affaires à ne pas oublier : demande client, devis en attente, incident, relance, action à terminer. Un dossier possède un titre, une description, un contact, une priorité, un statut, une dernière action et des notes. Il peut être mis à jour, clôturé ou annulé. La clôture enregistre la résolution ; la suppression doit rester exceptionnelle, car elle efface la trace du suivi. --- ## 7. Recettes d'automatisation ### 7.1 Trier les emails urgents **But :** surveiller la boîte, classer les messages, n'alerter que si nécessaire. 1. Configurez le bundle mail (2.4). 2. Définissez les destinataires autorisés. 3. Créez un profil autonome « Secrétariat ». 4. Limitez ses outils au mail, à la mémoire, aux dossiers et aux notifications. 5. Créez un **Pulsar** permanent, nature *Veille*. 6. Choisissez un intervalle de 15 ou 30 minutes. 7. Effort **Faible**. 8. Exécutez-le une fois à la main, puis contrôlez Courrier, Activité et Logs. ```text Objectif : repérer les messages qui demandent une réaction rapide. Périmètre : la boîte de réception, messages non lus des dernières 24 h. Considère urgent : une panne, une demande de devis, une relance de client, un message d'un contact de l'annuaire marqué prioritaire. À chaque passage : compare avec ce que tu avais retenu la fois précédente. Ne signale que ce qui est NOUVEAU depuis le dernier passage. S'il n'y a rien de nouveau : reste silencieux, n'envoie aucune notification. Mémorise : les identifiants des messages déjà signalés. ``` ### 7.2 Envoyer un résumé quotidien **Tâche planifiée**, Cron à 18 h, profil « Secrétariat », effort **Moyen**, livraison par email, contrôle qualité coché. ```text Objectif : un récapitulatif de la journée écoulée. Périmètre : messages reçus et envoyés depuis 00:00, dossiers modifiés aujourd'hui. Produis : un résumé de 10 lignes maximum, puis une liste des points en attente. Ne réclame jamais une action déjà traitée : si un dossier est clos, ne le redemande pas. S'il ne s'est rien passé, dis-le franchement — n'invente pas d'activité. Livre : par email au propriétaire. ``` La dernière consigne compte : sans elle, un rapport peut inventer une « journée calme » là où il n'a simplement pas réussi à lire les données. ### 7.3 Publier chaque semaine **Tâche planifiée**, Cron le lundi à 9 h, profil dédié, effort **Fort**, contrôle qualité coché, outil de publication **sous validation** au début. ### 7.4 Vérifier la santé d'un serveur Connexion SSH limitée aux commandes de lecture, profil « Supervision », **tâche planifiée** à 8 h, effort **Moyen**, livraison par email ou Telegram. ```text Objectif : détecter un problème avant qu'il ne devienne un incident. Périmètre : le serveur nommé . Vérifie : espace disque, charge, mémoire, services attendus, erreurs récentes des journaux. Alerte si : disque au-dessus de 85 %, un service attendu est arrêté, ou des erreurs répétées. Produis : un état en 5 lignes, puis le détail seulement en cas d'anomalie. N'exécute aucune commande de modification. ``` ### 7.5 Produire un rapport, le ranger, l'envoyer Dans le **Chat**, effort **Fort** : ```text Objectif : un rapport mensuel d'activité. Périmètre : le mois écoulé. Produis : un document structuré, puis convertis-le en PDF. Range le PDF dans l'Armoire, étagère Référence, étiquettes « rapport, mensuel ». Envoie-le ensuite au propriétaire, en pièce jointe. ``` Notez l'ordre : produire, ranger, **puis** envoyer. Demander l'envoi en premier donne souvent un mail sans pièce jointe. ### 7.6 Discuter depuis Telegram Créez le bot sur Telegram, récupérez son jeton, créez le gateway avec la liste des utilisateurs autorisés, associez une session portant le bon profil, testez. ### 7.7 Surveiller un prix jusqu'à un seuil **Pulsar** de type **Conditionnel**, nature *Veille*, effort **Faible**, intervalle de 6 heures. ```text Objectif : me prévenir quand le prix de passe sous . Source : . À chaque passage : relis la page, extrais le prix, compare-le au prix mémorisé. Signale : uniquement si le prix est passé sous le seuil, ou s'il a baissé de plus de 10 %. Mémorise : le dernier prix constaté et sa date. Reste silencieux dans tous les autres cas. La mission est terminée quand l'alerte de seuil a été envoyée. ``` ### 7.8 Produire une série d'images cohérentes C'est le cas d'usage typique du **chantier**. 1. Déposez dans l'**Armoire** une image qui servira de référence de style, et copiez son identifiant depuis sa fiche. 2. Créez un chantier, nature **Liste**. 3. Collez la liste des sujets, un par ligne. 4. Écrivez la consigne avec `{{item}}` et l'identifiant de l'image de référence. 5. Effort **Moyen**, plafond de coût raisonnable, 3 échecs tolérés. 6. Enregistrez, relisez, **Lancer**. ```text MISSION — produis une illustration de {{item}}. Style : reprends exactement le style de l'image de référence . Format : carré, fond clair. Range le fichier produit dans l'Armoire, étagère Archive, étiquette « série ». ``` Surveillez les trois premiers éléments avant de vous éloigner : si le style ne convient pas, mettez en pause, corrigez la consigne, et relancez. C'est bien moins coûteux que de découvrir trente-six images ratées. ### 7.9 Faire le point sur les tickets chaque semaine **Tâche planifiée**, Cron le vendredi à 17 h, profil dédié, effort **Moyen**, contrôle qualité coché, bundle de suivi de tickets en **lecture seule**. ```text Objectif : une revue hebdomadaire de l'état du travail. Périmètre : tous les projets, la semaine écoulée. Produis : les tickets résolus, les tickets ouverts par priorité, ceux dont l'échéance est dépassée, et la charge par personne. Rappelle que le périmètre dépend des droits : un comptage vide peut signifier « hors périmètre », pas « rien à signaler ». Ne recopie jamais le contenu d'une note interne. Livre : par email au propriétaire. ``` ### 7.10 Faire passer un appel téléphonique Configurez d'abord le gateway **Téléphone (Twilio)** (5.6), puis activez `call_and_wait` dans la page Outils, **sous validation** pour les premiers essais. Depuis le **Chat** : ```text Appelle le +33XXXXXXXXX. Objectif : savoir si la livraison prévue mardi est confirmée, et à quelle heure. Contexte : commande n° 1234, passée le 12 du mois, interlocuteur au service expédition. Rapporte-moi ce qui a été dit, sans interpréter. ``` L'action apparaîtra dans **À valider** avant de partir. Vérifiez le numéro — un appel, contrairement à un email, ne se rattrape pas. Une fois l'appel terminé, l'assistant vous restitue ce qui s'est dit ; le détail figure aussi dans les **Logs**, section des appels téléphoniques. Pour un simple message sans attente de réponse, `place_call` suffit et rend la main aussitôt. ### 7.11 Brancher un service externe Ajoutez le serveur MCP correspondant, laissez-le désactivé, vérifiez sa provenance, renseignez ses accès, activez-le, puis n'activez que les outils utiles, sous validation au début. ### 7.12 Intégrer une API qui n'a ni outil ni connecteur Passez par le **Studio** : décrivez l'API, ses entrées, sa sortie, et laissez l'entretien guidé produire l'outil. Testez-le en bac à sable avant de l'enregistrer. --- ## 8. Bien rédiger une instruction ### 8.1 La structure qui marche Une bonne instruction contient six éléments : 1. **Objectif** — ce qui doit être obtenu ; 2. **Périmètre** — sources, période, compte, serveur, dossier ; 3. **Règles** — ce qui est autorisé, ce qui est interdit ; 4. **Critères** — seuils, qualité, conditions de réussite ; 5. **Sortie** — format, longueur, structure ; 6. **Destination** — écran, email, Armoire, publication, ou rien. ```text Objectif : … Périmètre et sources : … Tu peux : … Tu ne dois jamais : … Considère la tâche réussie si : … Produis : … Livre le résultat : … S'il n'y a rien à signaler : … ``` ### 8.2 Pour une automatisation qui tourne sans vous Une automatisation ne peut pas vous poser une question au bon moment. Levez les ambiguïtés **avant** de la programmer : - nommez les destinataires ; - nommez les comptes et les connexions ; - donnez les seuils chiffrés ; - dites quoi faire si une information manque ; - dites s'il faut s'arrêter, se taire, ou produire un rapport partiel ; - dites si une action doit être **proposée** ou **exécutée**. ### 8.3 Pour un Pulsar Ajoutez toujours : ce qui constitue une nouveauté, ce qui constitue une alerte, ce qu'il faut mémoriser d'un passage à l'autre, comment éviter de signaler deux fois la même chose, quand rester silencieux, et quand la mission est terminée. ### 8.4 Pour un chantier La consigne d'un chantier est **la même pour tous les éléments**. Écrivez-la donc au singulier, en plaçant `{{item}}` là où l'élément doit apparaître, et **ne faites jamais référence à ce qui précède** : pas de « le suivant », pas de « comme le précédent », pas de « continue la série ». Chaque élément doit pouvoir être produit seul, et rejoué à l'identique en cas d'échec. Précisez aussi où ranger le résultat. Un élément produit et non rangé se retrouve dans un espace de travail temporaire. ### 8.5 Pour une action qui sort de chez vous Écrivez explicitement le destinataire ou la cible, si vous voulez un **brouillon**, une **proposition** ou un **envoi réel**, les pièces jointes, le compte à utiliser, et la conduite à tenir si la cible n'est pas autorisée. « Prépare un email » ne veut pas dire « envoie-le ». « Publie » demande une action réelle et peut déclencher une demande de validation. --- ## 9. Contrôler les actions et les coûts ### 9.1 Un démarrage prudent 1. testez dans le Chat ; 2. mettez les outils externes sous validation ; 3. choisissez une fréquence modérée ; 4. restez en effort Faible ou Moyen ; 5. lancez une première exécution manuelle ; 6. contrôlez le résultat ; 7. augmentez l'autonomie progressivement. ### 9.2 Où regarder | Question | Page | |---|---| | Qu'a réellement produit l'assistant ? | Activité | | Une action attend-elle mon accord ? | À valider | | Le mail est-il vraiment parti ? | Courrier | | Le fichier est-il conservé ? | Armoire | | La tâche a-t-elle tourné ? | Historique du Planificateur | | Que sait le Pulsar ? | Pulsar → État | | Où en est la production ? | Chantiers | | Pourquoi l'exécution a-t-elle échoué ? | Logs | | Combien cela a-t-il consommé ? | Activité, Logs, ou Crédits | ### 9.3 Éviter les dépenses inutiles - ne faites pas une ronde toutes les cinq minutes pour un signal quotidien ; - utilisez l'effort Faible pour les vérifications simples ; - imposez une compétence éprouvée : elle réduit les tâtonnements ; - limitez les outils de chaque profil ; - donnez des critères d'arrêt clairs ; - mettez en pause les missions en erreur plutôt que de les laisser réessayer ; - désactivez les fonctions avancées dont vous ne vous servez pas ; - utilisez l'interrupteur global pendant une maintenance ; - regardez le tarif affiché dans le sélecteur de modèle avant d'en changer. ### 9.4 Les plafonds d'un chantier Un chantier est le seul mode qui engage des dépenses en série sans que vous soyez devant l'écran. Fixez-lui **toujours** au moins un plafond : - un **plafond de coût** si votre fournisseur publie ses tarifs ; - un **plafond en tokens** dans tous les cas — il fonctionne même quand le coût affiché reste à zéro faute de tarif publié ; - un **nombre d'échecs consécutifs** tolérés, pour qu'un problème récurrent arrête la production au lieu de la répéter. Un chantier arrêté par un plafond n'a rien perdu : relevez le plafond et relancez. ### 9.5 La sécurité des secrets - ne mettez **jamais** une clé, un jeton ou un mot de passe dans un message, une mémoire ou l'Armoire ; - utilisez uniquement les champs de configuration prévus dans Outils, MCP, Gateway ou SSH ; - créez une clé d'API secondaire par intégration, jamais une clé unique partagée ; - révoquez la clé d'une intégration que vous supprimez ; - régénérez un lien public de Vitrine s'il a été diffusé trop largement ; - limitez les utilisateurs autorisés sur Telegram et Discord ; - limitez les destinataires email ; - accordez toujours le minimum de permissions. --- ## 10. Utiliser Pumaï par API Tout ce qui se configure dans l'interface possède une représentation en API, et les principales actions peuvent être déclenchées depuis une autre application. ### 10.1 Créer une clé **Système → Accès API → Nouvelle clé**. Donnez-lui le nom de l'intégration qui l'utilisera, et copiez immédiatement le secret affiché : il ne sera plus jamais montré en clair. Envoyez ensuite la clé dans l'en-tête de vos requêtes : ```http Authorization: Bearer VOTRE_CLE ``` ### 10.2 Usages courants Envoyer un message et recevoir la réponse ; ouvrir un flux de réponse progressive ; gérer les sessions ; choisir un profil et un effort ; gérer les tâches planifiées ; gérer les profils ; interroger la mémoire ; lister les outils ; traiter les propositions en attente ; utiliser le point d'entrée compatible avec les clients OpenAI existants. La page **Accès API** fournit des exemples déjà adaptés à l'adresse de votre instance, et un bouton ouvre la documentation interactive complète. ### 10.3 Bonnes pratiques Une clé par application et par environnement ; jamais de clé dans du code source public ou dans un navigateur ; un profil explicite dans chaque appel ; un identifiant de session conservé quand vous voulez maintenir le contexte ; un contexte neuf pour un autre utilisateur ou un autre métier ; une gestion des délais et des exécutions longues ; une révocation immédiate en cas de compromission. L'interface reste le meilleur point d'entrée pour configurer les profils, les outils, la sécurité et les connexions. L'API sert ensuite à exploiter Pumaï depuis un CRM, un portail client, un script ou une application métier. --- ## 11. Dépannage ### « L'assistant dit qu'il ne peut pas utiliser un outil » Vérifiez dans cet ordre : l'outil existe-t-il dans **Outils** ? est-il **activé** ? est-il **configuré** ? le profil l'autorise-t-il ? le connecteur qui le fournit est-il actif ? une validation est-elle en attente ? Un outil désactivé n'est pas seulement bloqué : il n'est pas proposé du tout à l'assistant. ### « La tâche planifiée ne s'exécute pas » Vérifiez l'interrupteur global, puis que la tâche est active, puis l'horaire, les jours et le fuseau horaire du profil. Cliquez sur **Exécuter** pour un test immédiat, puis ouvrez son historique et les Logs. ### « Le Pulsar ne signale rien » Cliquez sur **⚡ Exécuter maintenant** — pas sur le bouton de réveil général, qui ne force pas les cadences. Ouvrez **État** et **Logs**. Vérifiez la fréquence, l'intervalle personnalisé, que la mission est active et non expirée, et que l'instruction définit bien ce qui constitue une alerte. **Un verdict silencieux est souvent normal :** un bon Pulsar ne répète pas une information qui n'a pas changé. ### « Le Pulsar consomme trop » Effort **Faible**, intervalle plus long, compétence plus précise, périmètre réduit, règle de silence explicite et critère de fin. Mettez la mission en pause pendant le diagnostic. Si la mission **fabrique** quelque chose en série, ce n'est pas un réglage qu'il faut changer : c'est un chantier qu'il faut créer (3.6). ### « Le chantier ne démarre pas » Un chantier créé attend que vous cliquiez sur **Lancer** — c'est volontaire. Vérifiez ensuite que les automatisations ne sont pas en pause, et qu'il reste des éléments en attente. Après un redémarrage du serveur, un chantier en cours est mis en pause : relancez-le vous-même. ### « Le chantier s'est arrêté tout seul » Sa carte affiche toujours le motif : file vide, plafond de coût, plafond de tokens, trop d'échecs, quota épuisé, arrêt demandé, automatisations en pause, redémarrage. Dans le cas d'un plafond, relevez-le et relancez : les éléments restants sont conservés. ### « Aucun email n'apparaît » Le bundle mail est-il configuré et activé ? Les réglages entrants sont-ils ceux que votre fournisseur indique ? L'accès IMAP est-il bien activé côté fournisseur ? Le mot de passe utilisé est-il un **mot de passe d'application**, et non celui du compte ? Testez, puis consultez les Logs, qui donnent le message d'erreur exact du serveur de messagerie. ### « L'email n'est pas envoyé » Vérifiez d'abord qu'il ne s'agit pas d'un simple **brouillon** — c'est le cas le plus fréquent, et c'est le comportement attendu si la politique d'envoi est sur *Brouillon* ou si le destinataire ne figure pas dans la liste autorisée. Regardez ensuite **À valider**, puis les réglages sortants. Vérifiez enfin votre instruction : « prépare un email » ne demande pas un envoi. ### « Le fichier a disparu » Un fichier resté dans l'espace de travail d'une exécution est temporaire. Pour le conserver, demandez explicitement de le ranger dans l'**Armoire**. ### « L'assistant ne retrouve pas un document » Dans l'Armoire, vérifiez qu'il est sur l'étagère **Référence** *et* qu'il est marqué **indexé** — un PDF scanné ou une image ne le sont pas, et restent donc introuvables. Dans Mémoire, vérifiez le profil, l'état de la source et l'indexation. Testez une recherche avec des mots proches du contenu. Vérifiez enfin que la mémoire longue est activée pour ce profil, et le partage si la source appartient à un autre profil. ### « Telegram ou Discord ne répond pas » Testez le gateway, vérifiez son état de connexion, son jeton, l'identifiant de l'utilisateur ou du canal autorisé, et la session associée. Consultez les Logs. ### « Une connexion SSH échoue » Vérifiez l'hôte, le port, l'utilisateur, la clé ou le mot de passe, puis que la commande demandée figure bien dans la liste autorisée. Testez d'abord une commande de lecture simple. ### « Une automatisation se comporte mal » 1. passez l'interrupteur global sur **OFF** ; 2. interrompez l'exécution en cours depuis les Logs ; 3. désactivez la tâche, la mission, le chantier ou l'outil en cause ; 4. repassez le profil en mode supervisé ; 5. inspectez Activité et Logs pour comprendre ; 6. corrigez l'instruction, retestez dans le Chat, puis reprenez. --- ## 12. Glossaire **Agent** — Une instance de travail qui raisonne et utilise des outils. Une même demande peut en mobiliser plusieurs. **Armoire** — L'espace documentaire durable et central de l'instance, partagé par tous les profils. **Bundle** — Une famille cohérente d'outils : mail, Web, fichiers, images… **Chantier** — Une file de production qui déroule une liste d'éléments sans attendre d'horloge, et s'arrête quand la liste est vide. **Compétence** — Une procédure réutilisable décrivant comment bien accomplir un type de tâche. **Contrôle qualité** — Une relecture du livrable par l'agent qui vient de le produire, avant livraison. **Dossier (boucle ouverte)** — Une affaire à suivre jusqu'à sa résolution. **Effort** — Le niveau de profondeur, de délégation et de relecture appliqué à une exécution. **État (d'un Pulsar)** — Ce que la mission retient d'un passage au suivant. C'est ce qui lui permet de dire « ça n'y était pas la dernière fois ». **Gateway** — Un canal externe par lequel un humain converse avec Pumaï : Telegram, Discord ou le téléphone. **Gateway téléphone (Twilio)** — La passerelle qui donne un vrai numéro à l'assistant. Il décroche les appels entrants et peut en passer lui-même. Twilio est le seul fournisseur pris en charge, et sa facturation à la minute s'ajoute au coût de l'IA. **Item (élément)** — Une unité de production d'un chantier. **Liste des destinataires autorisés** — Le droit d'envoi de l'assistant. Une adresse absente de cette liste ne peut pas recevoir de message. **MCP** — Un standard qui permet à un serveur externe d'exposer ses outils à Pumaï. **Mémoire longue** — La recherche par similarité de sens dans les conversations et documents indexés. **Mot de passe d'application** — Un mot de passe secondaire, généré par votre fournisseur de messagerie pour un logiciel donné, révocable indépendamment du mot de passe du compte. **Outil** — Une fonction exécutable qui permet à l'agent de lire, produire ou agir. **Profil** — Une identité de travail, avec sa personnalité, sa mémoire, ses outils et son autonomie. **Pulsar** — Une mission autonome qui se réveille à intervalles réguliers et se souvient de ce qu'elle a vu au passage précédent. **Run (exécution)** — Le traitement complet d'une demande ou d'une automatisation, du début à la livraison. **Session** — Un fil de conversation qui conserve son contexte et son profil. **Tâche planifiée** — Une action exécutée selon un horaire, un intervalle ou une date, sans mémoire des exécutions précédentes. **Tick** — Un passage d'une mission Pulsar. **Token** — L'unité dans laquelle se compte le travail d'un modèle d'IA, et donc son coût. **Vitrine** — Une page publiable qui présente l'activité réelle et les productions de l'instance. **Workspace (espace de travail)** — L'espace temporaire d'une exécution. Ce qui doit durer va dans l'Armoire.