Bot Telegram
Makion est livré avec un bot Telegram intégré : une interface mobile vers votre propre serveur Makion. Depuis le bot, vous pouvez choisir un projet, choisir un rôle, envoyer une tâche avec du texte ou des pièces jointes, regarder la réponse s'afficher en continu, recevoir les fichiers produits par l'agent, approuver et appliquer des éléments dans la file d'envoi autonome, et gérer les demandes Support / Conseil — l'essentiel de ce que fait l'application de bureau au quotidien.
Le bot s'exécute sur le même serveur que le backend de bureau et associe votre compte Telegram à la même identité de développeur Makion utilisée pour la connexion. Il n'y a pas de comptes séparés : vos projets, rôles, historique de chat et permissions sont exactement les mêmes des deux côtés.
Le bot ne peut pas ouvrir lui-même la connexion SAP. Le tunnel du connecteur SAP est rattaché depuis l'application de bureau ; depuis le téléphone, vous pouvez voir son statut et piloter les exécutions, mais l'établissement du tunnel est une action de bureau. Voir Systèmes.
Démarrer et lier le bot#
Le bot est le même que celui utilisé pour la connexion Telegram par QR. Pour l'utiliser :
- Ouvrez le bot Makion de votre organisation dans Telegram et envoyez
/start(ou/menu). Votre administrateur peut vous indiquer le bon bot. - Le bot associe votre compte Telegram à un développeur Makion. Si vous n'avez pas encore de rôle, il vous le signale — demandez à votre administrateur de vous accorder un rôle et un accès au projet, exactement comme sur le bureau. Voir Utilisateurs et accès.
- Une fois que vous avez accès, le menu principal apparaît avec un clavier de boutons toujours visible au-dessus de la zone de saisie.
Se connecter au bureau depuis le bot#
Le bot peut aussi finaliser une connexion de bureau sans scanner de code QR. Sur l'écran de connexion du bureau, un code QR est affiché ; au lieu de le scanner, appuyez sur 🔑 Se connecter sur l'ordinateur dans le bot (ou envoyez /login). Le bot confirme la connexion de bureau en attente et l'application se connecte lors de son prochain sondage.
Qui peut l'utiliser#
L'identité et les permissions correspondent exactement au modèle de bureau :
- La première personne à ouvrir le bot devient le superadmin.
- Toute personne après elle commence sans accès jusqu'à ce qu'un superadmin lui accorde un rôle. Jusque-là, le bot le signale poliment.
- Vous ne voyez que les projets auxquels vous appartenez ; un superadmin voit tous les projets.
Commandes#
Chaque commande est aussi répertoriée dans le propre menu / de Telegram à côté de la zone de saisie, de sorte que vous n'avez jamais à les mémoriser.
| Commande | Ce qu'elle fait |
|---|---|
/start, /menu |
Ouvre le menu principal et le clavier de boutons. |
/login |
Confirme une connexion de bureau en attente (l'alternative au QR). |
/projects |
Choisir un projet. |
/mode |
Choisir un rôle pour l'agent. |
/chats |
Lister et reprendre les chats récents du projet. |
/clear |
Effacer l'historique et le contexte du chat en cours. |
/cancel |
Arrêter la tâche en cours d'exécution. |
/requests |
Ouvrir le menu des demandes Support / Conseil. |
/shipqueue |
Ouvrir l'examen de la file d'envoi autonome. |
/support |
Envoyer un rapport en un message au support Makion. |
/help |
Afficher une courte fiche d'aide. |
/admin |
Ouvrir le menu d'administration (superadmin uniquement ; les administrateurs de projet ne voient que le sélecteur de moteur par projet). |
Boutons de menu#
Le menu principal affiche un clavier de boutons persistant afin que les actions courantes soient à portée d'un seul appui. Appuyer sur un bouton exécute son action au lieu d'envoyer le libellé comme tâche.
| Bouton | Ce qu'il fait |
|---|---|
| 📁 Projects | Choisir un projet. Après le choix, la liste des rôles s'ouvre automatiquement. |
| 🎭 Mode | Choisir un rôle (voir Rôles dans le sélecteur). |
| 🕘 Chats | Lister les chats récents du projet ; appuyez sur l'un d'eux pour le reprendre, ou démarrez un nouveau chat. |
| 🗑 Clear chat | Effacer l'historique et le contexte du chat en cours. |
| 🔑 Log in on the computer | Confirmer une connexion de bureau en attente. |
| 🔌 SAP | Indiquer si un connecteur SAP est rattaché à ce projet. |
| ❓ Help | Afficher la fiche d'aide. |
| 🚀 Ship-queue | Examiner, approuver et appliquer les propositions de l'agent autonome (voir File d'envoi). |
| 📋 Requests | Créer et gérer les demandes Support / Conseil (voir Demandes Support et Conseil). |
| 🆘 Support | Décrire un problème en un message ; il est envoyé au support Makion. |
| ⚙️ Admin | Ouvrir le menu d'administration. Visible uniquement par un superadmin. |
Envoyer une tâche#
Il suffit d'envoyer un message texte — il est traité comme une tâche pour l'agent, exécutée sur le projet sélectionné avec le rôle sélectionné. Vous pouvez d'abord joindre du contexte :
- Joignez un document ou une photo, puis envoyez le texte de la tâche. Le fichier va dans l'espace de travail de la tâche en tant que pièce jointe (jusqu'à environ 20 Mo par fichier).
- Les fichiers produits par l'agent pendant l'exécution reviennent dans le chat sous forme de documents.
La réponse s'affiche en continu dans un seul message, mise à jour en direct au fur et à mesure que l'agent travaille, avec un pied de page « en cours » qui égrène le temps pour qu'une étape longue ne paraisse jamais bloquée. Les réponses longues sont réparties sur plusieurs messages. Si une exécution devient totalement silencieuse pendant plusieurs minutes — presque toujours un appel bloqué au modèle d'IA — le bot l'arrête de lui-même et vous invite à réessayer. Envoyez /cancel pour arrêter une exécution vous-même.
L'historique de conversation, la session de moteur reprise et le dernier rôle utilisé sont les mêmes enregistrements que ceux utilisés par le bureau (limités à votre identité de développeur × projet), de sorte que vous pouvez démarrer une tâche sur votre téléphone et la poursuivre sur le bureau, et vice versa.
Rôles dans le sélecteur#
Le sélecteur 🎭 Mode regroupe les rôles de la même manière que le bureau, sous 🛠 Development, 💼 Consulting et 🆘 Support. Un cadenas 🔒 marque un rôle qui peut modifier SAP (un rôle en écriture) ; un rôle sans cadenas est en lecture seule. Cela reflète le fonctionnement des rôles : les rôles en lecture seule ne reçoivent physiquement que des outils de lecture, de sorte qu'ils ne peuvent pas modifier SAP quelle que soit la formulation de votre tâche.
Si vous êtes autorisé à créer des projets, ➕ New project apparaît dans la liste des projets et demande un nom.
La file d'envoi sur votre téléphone#
Le menu 🚀 Ship-queue est le contrôle humain de validation pour le Mode autonome, sur votre téléphone. Il liste les propositions de l'agent autonome et pilote exactement le même flux d'approbation et d'application que le bureau — rien dans la file n'a touché SAP tant qu'un humain ne l'a pas appliqué.
| Action | Ce qu'elle fait |
|---|---|
| Appuyer sur une proposition | L'ouvrir pour voir son exigence, sa justification et son contenu. |
| ✅ Approve | Enregistrer l'approbation d'une proposition en attente. N'écrit pas dans SAP. |
| ❌ Reject | Enregistrer le rejet. N'écrit pas dans SAP. |
| 🗑 Delete | Retirer une proposition de la file. |
| 🚀 Apply | Écrire une proposition approuvée dans SAP via le connecteur rattaché. |
| 🚀 Apply all | Écrire et activer chaque proposition approuvée, selon le processus en deux phases, après une confirmation. |
| 🧹 Clear rejected | Retirer toutes les propositions rejetées. |
| 🧹 Clear not-applied | Retirer toutes les propositions qui n'ont pas été appliquées. |
| 🕘 Runs | Lister les exécutions autonomes récentes et en ouvrir une pour voir ses étapes et son résumé. |
| 🔄 Refresh | Recharger la file. |
Une application affiche sa progression en continu dans un message en direct et rapporte un résumé final honnête (écrit, ignoré, ou échoué avec la raison propre de SAP). L'application est la seule action qui écrit dans SAP, et elle nécessite un connecteur rattaché — voir le Modèle de sécurité.
Demandes Support et Conseil#
Le menu 📋 Requests gère le cycle de vie des demandes Support / Conseil depuis le téléphone, en utilisant les mêmes règles que la file Demandes du bureau.
| Action | Ce qu'elle fait |
|---|---|
| ➕ New request | Créer une demande : choisir 🆘 Support ou 💼 Consult, définir l'impact et l'urgence, puis envoyer un titre (avec des détails facultatifs). |
| Appuyer sur une demande | L'ouvrir pour voir son statut, son corps, ses conclusions et ses notes. |
| 🔬 Investigate (read-only) | Démarrer une investigation en lecture seule de la demande ; la rouvrir plus tard pour lire les conclusions. |
| 📝 Note | Ajouter une note à la demande. |
| 📋 To triage / ⏸ Put on hold | Faire progresser la demande dans son cycle de vie (une mise en attente demande une raison). |
| ✅ Approve / ❌ Reject / ⏸ Park | Enregistrer une décision. L'approbation et le rejet demandent un code de clôture et des notes. Administrateurs de projet uniquement. |
Le menu d'administration#
⚙️ Admin fait apparaître les actions de configuration qui sont autrement inaccessibles depuis le téléphone. Un superadmin les voit toutes ; un administrateur de projet ne voit que le sélecteur Engine par projet. Chaque action passe par les mêmes contrôles de permission que le bureau.
| Action | Ce qu'elle fait |
|---|---|
| 🧠 Engine | Changer le moteur d'IA du projet en cours. |
| 🤖 Model | Changer le modèle global (superadmin). |
| ⬆️ Server update | Vérifier et déclencher une auto-mise à jour du serveur, après une confirmation (superadmin). |
| 🧩 Retro proposals | Examiner, approuver ou rejeter les propositions d'apprentissage-par-les-erreurs (superadmin). Voir Retro. |
| 🛡 Security audit | Exécuter l'audit de sécurité en lecture seule et voir ses conclusions (superadmin). |
Ce que le bot ne peut délibérément pas faire#
Le bot couvre le travail au quotidien, mais quelques éléments restent sur le bureau par conception :
- Ouvrir la connexion SAP. Le tunnel du connecteur SAP est rattaché depuis l'onglet Systèmes du bureau. Le bouton 🔌 SAP indique seulement si un connecteur est rattaché ; une tâche ou une application qui écrit dans SAP nécessite que ce connecteur de bureau soit actif.
- Gérer les membres, les rôles et l'accès aux projets. Accorder des rôles et ajouter des personnes aux projets est une action de bureau. Voir Utilisateurs et accès.
- Modifier la méthodologie et les connaissances. Les règles de base, la méthodologie par rôle et les fichiers de la base de connaissances se modifient dans l'onglet Méthodologie du bureau.
- Définir les informations d'identification des moteurs. Ajouter une clé d'API ou finaliser une connexion par abonnement pour un moteur se fait sur le bureau.
Langue#
L'interface du bot est bilingue (ukrainien / anglais) et suit la langue de votre Telegram, avec l'anglais par défaut.
Pages associées#
- Connexion et projets — la connexion de bureau que le bot peut finaliser.
- Fonctionnement des rôles — lecture seule vs écriture, et le cadenas 🔒 dans le sélecteur.
- Mode autonome — la file d'envoi que le bot vous permet d'approuver et d'appliquer.
- Demandes — le cycle de vie Support / Conseil.
- Modèle de sécurité — pourquoi les applications nécessitent un connecteur, et comment les écritures sont contrôlées.