Bot Telegram
Makion include un bot Telegram integrato: un front-end mobile per il tuo server Makion. Dal bot puoi scegliere un progetto, scegliere un ruolo, inviare un'attività con testo o allegati, guardare la risposta arrivare in streaming, ricevere i file che l'agente produce, approvare e applicare elementi nella coda di invio autonoma e gestire le richieste Support / Consult — gran parte di ciò che l'app desktop fa per il lavoro quotidiano.
Il bot gira sullo stesso server del backend desktop e mappa il tuo account Telegram sulla stessa identità di sviluppatore Makion usata per l'accesso. Non ci sono account separati: i tuoi progetti, ruoli, cronologia della chat e permessi sono esattamente gli stessi su entrambi.
Il bot non può aprire da solo la connessione SAP. Il tunnel del connettore SAP è collegato dall'app desktop; dal telefono puoi vederne lo stato e pilotare le esecuzioni, ma stabilire il tunnel è un'azione desktop. Vedi Systems.
Avviare e collegare il bot#
Il bot è lo stesso usato per l'accesso Telegram tramite QR. Per usarlo:
- Apri il bot Makion della tua organizzazione in Telegram e invia
/start(o/menu). Il tuo amministratore può indirizzarti al bot giusto. - Il bot mappa il tuo account Telegram su uno sviluppatore Makion. Se non hai ancora un ruolo, te lo dice — chiedi al tuo amministratore di concederti un ruolo e l'accesso ai progetti, esattamente come sul desktop. Vedi Utenti e accessi.
- Una volta che hai accesso, compare il menu principale con una tastiera di pulsanti sempre visibile sopra l'input.
Accedere al desktop dal bot#
Il bot può anche completare un accesso desktop senza scansionare un codice QR. Nella schermata di accesso desktop viene mostrato un codice QR; invece di scansionarlo, tocca 🔑 Log in on the computer nel bot (o invia /login). Il bot conferma l'accesso desktop in attesa e l'app effettua l'accesso al suo poll successivo.
Chi può usarlo#
Identità e permessi corrispondono esattamente al modello desktop:
- La prima persona ad aprire il bot diventa il superadmin.
- Chiunque dopo di lei parte con nessun accesso finché un superadmin non gli concede un ruolo. Fino ad allora il bot lo comunica educatamente.
- Vedi solo i progetti a cui appartieni; un superadmin vede tutti i progetti.
Comandi#
Ogni comando è elencato anche nel menu / di Telegram accanto all'input, così non devi mai memorizzarli.
| Comando | Cosa fa |
|---|---|
/start, /menu |
Apre il menu principale e la tastiera dei pulsanti. |
/login |
Conferma un accesso desktop in attesa (l'alternativa al QR). |
/projects |
Scegli un progetto. |
/mode |
Scegli un ruolo per l'agente. |
/chats |
Elenca e riprende le chat recenti del progetto. |
/clear |
Cancella la cronologia e il contesto della chat corrente. |
/cancel |
Ferma l'attività attualmente in esecuzione. |
/requests |
Apre il menu delle richieste Support / Consult. |
/shipqueue |
Apre la revisione della coda di invio autonoma. |
/support |
Invia un report in un solo messaggio al supporto Makion. |
/help |
Mostra una breve scheda di aiuto. |
/admin |
Apre il menu di amministrazione (solo superadmin; gli amministratori del progetto vedono solo il selettore del motore per progetto). |
Pulsanti del menu#
Il menu principale mostra una tastiera di pulsanti persistente così che le azioni comuni siano a un tocco di distanza. Toccare un pulsante esegue la sua azione invece di inviare l'etichetta come attività.
| Pulsante | Cosa fa |
|---|---|
| 📁 Projects | Scegli un progetto. Dopo la scelta, l'elenco dei ruoli si apre automaticamente. |
| 🎭 Mode | Scegli un ruolo (vedi Ruoli nel selettore). |
| 🕘 Chats | Elenca le chat recenti del progetto; toccane una per riprenderla, o avvia una nuova chat. |
| 🗑 Clear chat | Cancella la cronologia e il contesto della chat corrente. |
| 🔑 Log in on the computer | Conferma un accesso desktop in attesa. |
| 🔌 SAP | Mostra se un connettore SAP è collegato per questo progetto. |
| ❓ Help | Mostra la scheda di aiuto. |
| 🚀 Ship-queue | Esamina, approva e applica le proposte dell'agente autonomo (vedi Coda di invio). |
| 📋 Requests | Crea e gestisci richieste Support / Consult (vedi Richieste Support & Consult). |
| 🆘 Support | Descrivi un problema in un solo messaggio; viene inviato al supporto Makion. |
| ⚙️ Admin | Apre il menu di amministrazione. Mostrato solo a un superadmin. |
Inviare un'attività#
Basta inviare un messaggio di testo — viene trattato come un'attività per l'agente, eseguita sul progetto selezionato con il ruolo selezionato. Puoi allegare prima del contesto:
- Allega un documento o una foto, poi invia il testo dell'attività. Il file finisce nel workspace dell'attività come allegato (fino a circa 20 MB per file).
- I file prodotti che l'agente crea durante l'esecuzione tornano nella chat come documenti.
La risposta arriva in streaming in un singolo messaggio, aggiornato dal vivo mentre l'agente lavora, con un piè di pagina «al lavoro» che scorre così che un passo lungo non sembri mai bloccato. Le risposte lunghe vengono suddivise su più messaggi. Se un'esecuzione resta completamente silenziosa per diversi minuti — quasi sempre una chiamata bloccata al modello IA — il bot la ferma da solo e ti dice di riprovare. Invia /cancel per fermare un'esecuzione tu stesso.
La cronologia della conversazione, la sessione del motore ripresa e l'ultimo ruolo usato sono gli stessi record che usa il desktop (delimitati alla tua identità di sviluppatore × progetto), così puoi iniziare un'attività sul telefono e continuarla sul desktop, e viceversa.
Ruoli nel selettore#
Il selettore 🎭 Mode raggruppa i ruoli nello stesso modo del desktop, sotto 🛠 Development, 💼 Consulting e 🆘 Support. Un lucchetto 🔒 contrassegna un ruolo che può cambiare SAP (un ruolo con scrittura); un ruolo senza lucchetto è di sola lettura. Questo rispecchia come funzionano i ruoli: ai ruoli di sola lettura vengono fisicamente consegnati solo strumenti di lettura, quindi non possono cambiare SAP indipendentemente da come è formulata la tua attività.
Se sei autorizzato a creare progetti, ➕ New project compare nell'elenco dei progetti e chiede un nome.
La coda di invio sul telefono#
Il menu 🚀 Ship-queue è il gate umano di revisione per la Modalità autonoma, sul telefono. Elenca le proposte dell'agente autonomo e pilota lo stesso identico flusso di approvazione e applicazione del desktop — nulla nella coda ha toccato SAP finché un umano non lo applica.
| Azione | Cosa fa |
|---|---|
| Tocca una proposta | Aprila per vedere il suo requisito, la motivazione e il payload. |
| ✅ Approve | Registra l'approvazione per una proposta in attesa. Non scrive in SAP. |
| ❌ Reject | Registra il rifiuto. Non scrive in SAP. |
| 🗑 Delete | Rimuove una proposta dalla coda. |
| 🚀 Apply | Scrive una proposta approvata in SAP tramite il connettore collegato. |
| 🚀 Apply all | Scrive e attiva ogni proposta approvata, nel processo in due fasi, dopo una conferma. |
| 🧹 Clear rejected | Rimuove tutte le proposte rifiutate. |
| 🧹 Clear not-applied | Rimuove ogni proposta che non è stata applicata. |
| 🕘 Runs | Elenca le esecuzioni autonome recenti e ne apre una per vederne i passi e il riepilogo. |
| 🔄 Refresh | Ricarica la coda. |
Un'applicazione trasmette in streaming il suo avanzamento in un messaggio dal vivo e riporta un riepilogo finale onesto (scritto, saltato o fallito con il motivo di SAP stesso). Applicare è l'unica azione che scrive in SAP, e richiede un connettore collegato — vedi il Modello di sicurezza.
Richieste Support & Consult#
Il menu 📋 Requests gestisce il ciclo di vita delle richieste Support / Consult dal telefono, usando le stesse regole della coda Requests del desktop.
| Azione | Cosa fa |
|---|---|
| ➕ New request | Crea una richiesta: scegli 🆘 Support o 💼 Consult, imposta impatto e urgenza, poi invia un titolo (con dettagli facoltativi). |
| Tocca una richiesta | Aprila per vedere il suo stato, corpo, risultati e note. |
| 🔬 Investigate (read-only) | Avvia un'indagine in sola lettura della richiesta; riaprila più tardi per leggere i risultati. |
| 📝 Note | Aggiungi una nota alla richiesta. |
| 📋 To triage / ⏸ Put on hold | Sposta la richiesta lungo il suo ciclo di vita (una sospensione chiede un motivo). |
| ✅ Approve / ❌ Reject / ⏸ Park | Registra una decisione. Approvare e rifiutare chiedono un codice di chiusura e note. Solo amministratori del progetto. |
Il menu di amministrazione#
⚙️ Admin espone le azioni di configurazione altrimenti inaccessibili dal telefono. Un superadmin le vede tutte; un amministratore del progetto vede solo il selettore Engine per progetto. Ogni azione passa attraverso gli stessi gate di permessi del desktop.
| Azione | Cosa fa |
|---|---|
| 🧠 Engine | Cambia il motore IA per il progetto corrente. |
| 🤖 Model | Cambia il modello globale (superadmin). |
| ⬆️ Server update | Verifica e avvia un auto-aggiornamento del server, dopo una conferma (superadmin). |
| 🧩 Retro proposals | Esamina, approva o rifiuta le proposte impara-dagli-errori (superadmin). Vedi Retro. |
| 🛡 Security audit | Esegue l'audit di sicurezza in sola lettura e ne mostra i risultati (superadmin). |
Cosa il bot deliberatamente non può fare#
Il bot copre il lavoro quotidiano, ma alcune cose restano sul desktop per progettazione:
- Aprire la connessione SAP. Il tunnel del connettore SAP è collegato dalla scheda Systems del desktop. Il pulsante 🔌 SAP riporta solo se un connettore è collegato; un'attività o un'applicazione che scrive in SAP ha bisogno che quel connettore desktop sia attivo.
- Gestire membri, ruoli e accesso ai progetti. Concedere ruoli e aggiungere persone ai progetti è un'azione desktop. Vedi Utenti e accessi.
- Modificare metodologia e conoscenza. Le regole di base, la metodologia per ruolo e i file della base di conoscenza si modificano nella scheda Metodologia del desktop.
- Impostare le credenziali del motore. Aggiungere una chiave API o completare l'accesso a un abbonamento per un motore si fa sul desktop.
Lingua#
L'interfaccia del bot è bilingue (ucraino / inglese) e segue la lingua del tuo Telegram, con l'inglese come impostazione predefinita.
Pagine correlate#
- Accesso e progetti — l'accesso desktop che il bot può completare.
- Come funzionano i ruoli — sola lettura vs scrittura, e il lucchetto 🔒 nel selettore.
- Modalità autonoma — la coda di invio che il bot ti permette di approvare e applicare.
- Requests — il ciclo di vita di Support / Consult.
- Modello di sicurezza — perché le applicazioni hanno bisogno di un connettore, e come sono regolate le scritture.