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
2. Première installation, pas à pas
3. Chat, tâche planifiée, Pulsar ou chantier ?
4. Les profils et le partage des données
5. Outils, compétences, connecteurs et canaux
6. L'interface page par page
7. Recettes d'automatisation
8. Bien rédiger une instruction
9. Contrôler les actions et les coûts
10. Utiliser Pumaï par API
11. Dépannage
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 :

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 :

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.

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.

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 » :

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 :

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

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 :

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.

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

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 :

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.

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 :

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 <instruction> — force le traitement en tâche complexe ;
• /new — nouvelle session ;
• /profile — affiche le profil utilisateur ;
• /remember <texte> — 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.

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é.

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.

Objectif : détecter un problème avant qu'il ne devienne un incident.
Périmètre : le serveur nommé <alias de la connexion>.
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 :

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.

Objectif : me prévenir quand le prix de <produit> passe sous <montant>.
Source : <adresse de la page>.
À 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.

MISSION — produis une illustration de {{item}}.
Style : reprends exactement le style de l'image de référence <identifiant de l'Armoire>.
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.

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 :

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.

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

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 :

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.