Telegram-Bot
Makion bringt einen eingebauten Telegram-Bot mit: ein mobiles Frontend zu Ihrem eigenen Makion-Server. Aus dem Bot können Sie ein Projekt wählen, eine Rolle auswählen, eine Aufgabe mit Text oder Anhängen senden, die Antwort im Stream verfolgen, vom Agenten erzeugte Dateien empfangen, Positionen in der autonomen Ship-Queue genehmigen und anwenden sowie Support-/Consult-Anfragen verwalten — den größten Teil dessen, was die Desktop-App für die tägliche Arbeit tut.
Der Bot läuft auf demselben Server wie das Desktop-Backend und ordnet Ihr Telegram-Konto derselben Makion-Entwickleridentität zu, die für die Anmeldung verwendet wird. Es gibt keine getrennten Konten: Ihre Projekte, Rollen, Chat-Historie und Berechtigungen sind auf beiden exakt gleich.
Der Bot kann die SAP-Verbindung nicht selbst öffnen. Der SAP-Connector-Tunnel wird aus der Desktop-App angebunden; vom Handy aus sehen Sie seinen Status und steuern Läufe, aber das Herstellen des Tunnels ist eine Desktop-Aktion. Siehe Systeme.
Den Bot starten und verbinden#
Der Bot ist derselbe, der für die Telegram-QR-Anmeldung verwendet wird. So nutzen Sie ihn:
- Öffnen Sie den Makion-Bot Ihrer Organisation in Telegram und senden Sie
/start(oder/menu). Ihr Administrator kann Ihnen den richtigen Bot nennen. - Der Bot ordnet Ihr Telegram-Konto einem Makion-Entwickler zu. Wenn Sie noch keine Rolle haben, sagt er das — bitten Sie Ihren Administrator, Ihnen eine Rolle und Projektzugriff zu gewähren, genau wie am Desktop. Siehe Benutzer & Zugriff.
- Sobald Sie Zugriff haben, erscheint das Hauptmenü mit einer stets sichtbaren Schaltflächen-Tastatur über der Eingabe.
Vom Bot aus am Desktop anmelden#
Der Bot kann auch eine Desktop-Anmeldung abschließen, ohne einen QR-Code zu scannen. Auf dem Desktop-Anmeldebildschirm wird ein QR-Code angezeigt; statt ihn zu scannen, tippen Sie im Bot auf 🔑 Log in on the computer (oder senden /login). Der Bot bestätigt die ausstehende Anmeldung des Desktops, und die App meldet sich beim nächsten Abruf an.
Wer ihn nutzen kann#
Identität und Berechtigungen entsprechen exakt dem Desktop-Modell:
- Die erste Person, die den Bot öffnet, wird zum Superadmin.
- Alle danach starten mit keinem Zugriff, bis ein Superadmin ihnen eine Rolle gewährt. Bis dahin sagt der Bot das höflich.
- Sie sehen nur die Projekte, zu denen Sie gehören; ein Superadmin sieht alle Projekte.
Befehle#
Jeder Befehl ist auch in Telegrams eigenem /-Menü neben der Eingabe aufgeführt, sodass Sie sie nie auswendig lernen müssen.
| Befehl | Was er tut |
|---|---|
/start, /menu |
Das Hauptmenü und die Schaltflächen-Tastatur öffnen. |
/login |
Eine ausstehende Desktop-Anmeldung bestätigen (die QR-Alternative). |
/projects |
Ein Projekt wählen. |
/mode |
Eine Rolle für den Agenten wählen. |
/chats |
Die letzten Chats des Projekts auflisten und fortsetzen. |
/clear |
Historie und Kontext des aktuellen Chats leeren. |
/cancel |
Die aktuell laufende Aufgabe stoppen. |
/requests |
Das Menü für Support-/Consult-Anfragen öffnen. |
/shipqueue |
Die Prüfung der autonomen Ship-Queue öffnen. |
/support |
Eine Ein-Nachricht-Meldung an den Makion-Support senden. |
/help |
Eine kurze Hilfekarte anzeigen. |
/admin |
Das Admin-Menü öffnen (nur Superadmin; Projekt-Admins sehen nur den projektbezogenen Engine-Umschalter). |
Menü-Schaltflächen#
Das Hauptmenü zeigt eine dauerhafte Schaltflächen-Tastatur, sodass die häufigen Aktionen einen Tipp entfernt sind. Das Tippen einer Schaltfläche führt ihre Aktion aus, statt die Bezeichnung als Aufgabe zu senden.
| Schaltfläche | Was sie tut |
|---|---|
| 📁 Projects | Ein Projekt wählen. Nach der Wahl öffnet sich die Rollenliste automatisch. |
| 🎭 Mode | Eine Rolle wählen (siehe Rollen in der Auswahl). |
| 🕘 Chats | Die letzten Chats des Projekts auflisten; einen antippen, um ihn fortzusetzen, oder einen neuen Chat starten. |
| 🗑 Clear chat | Historie und Kontext des aktuellen Chats leeren. |
| 🔑 Log in on the computer | Eine ausstehende Desktop-Anmeldung bestätigen. |
| 🔌 SAP | Anzeigen, ob ein SAP-Connector für dieses Projekt angebunden ist. |
| ❓ Help | Die Hilfekarte anzeigen. |
| 🚀 Ship-queue | Die Vorschläge des autonomen Agenten prüfen, genehmigen und anwenden (siehe Ship-Queue). |
| 📋 Requests | Support-/Consult-Anfragen erstellen und verwalten (siehe Support- & Consult-Anfragen). |
| 🆘 Support | Ein Problem in einer Nachricht beschreiben; sie wird an den Makion-Support gesendet. |
| ⚙️ Admin | Das Admin-Menü öffnen. Nur einem Superadmin angezeigt. |
Eine Aufgabe senden#
Senden Sie einfach eine Textnachricht — sie wird als Aufgabe für den Agenten behandelt, ausgeführt gegen das gewählte Projekt mit der gewählten Rolle. Sie können zuerst Kontext anhängen:
- Hängen Sie ein Dokument oder Foto an und senden Sie dann den Aufgabentext. Die Datei geht als Anhang in den Aufgaben-Arbeitsbereich (bis etwa 20 MB pro Datei).
- Erzeugte Dateien, die der Agent während des Laufs erstellt, kommen als Dokumente in den Chat zurück.
Die Antwort streamt in eine einzige Nachricht, live aktualisiert, während der Agent arbeitet, mit einer tickenden „working"-Fußzeile, sodass ein langer Schritt nie stehengeblieben aussieht. Lange Antworten werden auf mehrere Nachrichten aufgeteilt. Wenn ein Lauf mehrere Minuten völlig still wird — fast immer ein festhängender Aufruf an das KI-Modell — stoppt der Bot ihn von selbst und sagt Ihnen, es erneut zu versuchen. Senden Sie /cancel, um einen Lauf selbst zu stoppen.
Gesprächshistorie, die fortgesetzte Engine-Sitzung und die zuletzt verwendete Rolle sind dieselben Datensätze, die der Desktop nutzt (begrenzt auf Ihre Entwickleridentität × Projekt), sodass Sie eine Aufgabe auf dem Handy beginnen und am Desktop fortsetzen können, und umgekehrt.
Rollen in der Auswahl#
Die Auswahl 🎭 Mode gruppiert Rollen genauso wie der Desktop, unter 🛠 Development, 💼 Consulting und 🆘 Support. Ein Schloss 🔒 kennzeichnet eine Rolle, die SAP ändern kann (eine schreibende Rolle); eine Rolle ohne Schloss ist schreibgeschützt. Dies spiegelt So funktionieren Rollen: Schreibgeschützten Rollen werden physisch nur Lesewerkzeuge übergeben, sodass sie SAP nicht ändern können, unabhängig vom Wortlaut Ihrer Aufgabe.
Wenn Sie Projekte anlegen dürfen, erscheint ➕ New project in der Projektliste und fragt nach einem Namen.
Die Ship-Queue auf Ihrem Handy#
Das Menü 🚀 Ship-queue ist das menschliche Prüf-Gate für den autonomen Modus, auf Ihrem Handy. Es listet die Vorschläge des autonomen Agenten und steuert genau denselben Genehmigen-und-Anwenden-Ablauf wie der Desktop — nichts in der Queue hat SAP berührt, bis ein Mensch es anwendet.
| Aktion | Was sie tut |
|---|---|
| Einen Vorschlag antippen | Ihn öffnen, um Anforderung, Begründung und Payload zu sehen. |
| ✅ Approve | Genehmigung für einen ausstehenden Vorschlag protokollieren. Schreibt nicht in SAP. |
| ❌ Reject | Ablehnung protokollieren. Schreibt nicht in SAP. |
| 🗑 Delete | Einen Vorschlag aus der Queue entfernen. |
| 🚀 Apply | Einen genehmigten Vorschlag über den angebundenen Connector in SAP schreiben. |
| 🚀 Apply all | Jeden genehmigten Vorschlag im zweiphasigen Verfahren nach einer Bestätigung schreiben und aktivieren. |
| 🧹 Clear rejected | Alle abgelehnten Vorschläge entfernen. |
| 🧹 Clear not-applied | Jeden Vorschlag entfernen, der nicht angewendet wurde. |
| 🕘 Runs | Die letzten autonomen Läufe auflisten und einen öffnen, um seine Schritte und Zusammenfassung zu sehen. |
| 🔄 Refresh | Die Queue neu laden. |
Ein Anwenden streamt seinen Fortschritt in eine Live-Nachricht und meldet eine ehrliche Endzusammenfassung (geschrieben, übersprungen oder mit SAPs eigenem Grund fehlgeschlagen). Anwenden ist die einzige Aktion, die in SAP schreibt, und sie erfordert einen angebundenen Connector — siehe das Sicherheitsmodell.
Support- & Consult-Anfragen#
Das Menü 📋 Requests verwaltet den Lebenszyklus von Support-/Consult-Anfragen vom Handy aus, mit denselben Regeln wie die Desktop-Requests-Warteschlange.
| Aktion | Was sie tut |
|---|---|
| ➕ New request | Eine Anfrage erstellen: 🆘 Support oder 💼 Consult wählen, Impact und Urgency setzen, dann einen Titel senden (mit optionalen Details). |
| Eine Anfrage antippen | Sie öffnen, um Status, Text, Befunde und Notizen zu sehen. |
| 🔬 Investigate (read-only) | Eine schreibgeschützte Untersuchung der Anfrage starten; sie später erneut öffnen, um die Befunde zu lesen. |
| 📝 Note | Der Anfrage eine Notiz hinzufügen. |
| 📋 To triage / ⏸ Put on hold | Die Anfrage durch ihren Lebenszyklus bewegen (ein Halt fragt nach einem Grund). |
| ✅ Approve / ❌ Reject / ⏸ Park | Eine Entscheidung protokollieren. Approve und Reject fragen nach einem Close-Code und Notizen. Nur Projekt-Admins. |
Das Admin-Menü#
⚙️ Admin stellt die Konfigurationsaktionen bereit, die sonst vom Handy aus nicht erreichbar sind. Ein Superadmin sieht sie alle; ein Projekt-Admin sieht nur den projektbezogenen Engine-Umschalter. Jede Aktion läuft durch dieselben Berechtigungs-Gates wie der Desktop.
| Aktion | Was sie tut |
|---|---|
| 🧠 Engine | Die KI-Engine für das aktuelle Projekt ändern. |
| 🤖 Model | Das globale Modell ändern (Superadmin). |
| ⬆️ Server update | Ein Server-Selbstupdate nach einer Bestätigung prüfen und auslösen (Superadmin). |
| 🧩 Retro proposals | Lernen-aus-Fehlern-Vorschläge prüfen, genehmigen oder ablehnen (Superadmin). Siehe Retro. |
| 🛡 Security audit | Das schreibgeschützte Sicherheits-Audit ausführen und seine Befunde sehen (Superadmin). |
Was der Bot bewusst nicht kann#
Der Bot deckt die tägliche Arbeit ab, aber ein paar Dinge bleiben durch Design am Desktop:
- Die SAP-Verbindung öffnen. Der SAP-Connector-Tunnel wird aus dem Desktop-Reiter Systeme angebunden. Die Schaltfläche 🔌 SAP meldet nur, ob ein Connector angebunden ist; eine Aufgabe oder ein Anwenden, das in SAP schreibt, benötigt diesen Desktop-Connector aktiv.
- Mitglieder, Rollen und Projektzugriff verwalten. Rollen zu gewähren und Personen zu Projekten hinzuzufügen ist eine Desktop-Aktion. Siehe Benutzer & Zugriff.
- Methodik und Wissen bearbeiten. Basisregeln, rollenspezifische Methodik und Wissensdatenbank-Dateien werden im Desktop-Reiter Methodik bearbeitet.
- Engine-Anmeldedaten setzen. Einen API-Schlüssel hinzuzufügen oder eine Abonnement-Anmeldung für eine Engine abzuschließen erfolgt am Desktop.
Sprache#
Die Bot-Oberfläche ist zweisprachig (Ukrainisch / Englisch) und folgt Ihrer Telegram-Sprache, standardmäßig Englisch.
Verwandte Seiten#
- Anmelden & Projekte — die Desktop-Anmeldung, die der Bot abschließen kann.
- So funktionieren Rollen — schreibgeschützt vs. schreibend und das 🔒-Schloss in der Auswahl.
- Autonomer Modus — die Ship-Queue, die der Bot Sie genehmigen und anwenden lässt.
- Requests — der Support-/Consult-Lebenszyklus.
- Sicherheitsmodell — warum Anwendungen einen Connector brauchen und wie Schreibvorgänge abgesichert sind.