Telegram bot
O Makion inclui um bot de Telegram integrado: um front-end móvel para o seu próprio servidor Makion. A partir do bot pode escolher um projeto, escolher uma função, enviar uma tarefa com texto ou anexos, ver a resposta a chegar em fluxo contínuo, receber ficheiros que o agente produz, aprovar e aplicar itens na fila de envio autónoma e gerir pedidos de Support / Consult — a maior parte do que a aplicação de desktop faz para o trabalho do dia a dia.
O bot corre no mesmo servidor que o backend de desktop e associa a sua conta de Telegram à mesma identidade de programador Makion usada no início de sessão. Não há contas separadas: os seus projetos, funções, histórico de conversas e permissões são exatamente os mesmos em ambos.
O bot não consegue abrir a ligação SAP por si próprio. O túnel do conector SAP é ligado a partir da aplicação de desktop; a partir do telemóvel pode ver o seu estado e conduzir execuções, mas estabelecer o túnel é uma ação de desktop. Consulte Sistemas.
Iniciar e associar o bot#
O bot é o mesmo que é usado para o início de sessão por QR no Telegram. Para o usar:
- Abra o bot Makion da sua organização no Telegram e envie
/start(ou/menu). O seu administrador pode indicar-lhe o bot correto. - O bot associa a sua conta de Telegram a um programador Makion. Se ainda não tiver função, o bot indica-o — peça ao seu administrador que lhe conceda uma função e acesso ao projeto, exatamente como no desktop. Consulte Utilizadores e acesso.
- Assim que tiver acesso, o menu principal aparece com um teclado de botões sempre visível por cima do campo de introdução.
Iniciar sessão no desktop a partir do bot#
O bot também pode concluir um início de sessão no desktop sem digitalizar um código QR. No ecrã de início de sessão do desktop é mostrado um código QR; em vez de o digitalizar, toque em 🔑 Iniciar sessão no computador no bot (ou envie /login). O bot confirma o início de sessão pendente do desktop e a aplicação inicia sessão na sua próxima sondagem.
Quem o pode usar#
A identidade e as permissões correspondem exatamente ao modelo do desktop:
- A primeira pessoa a abrir o bot torna-se o superadmin.
- Todos os que vierem depois começam sem acesso até que um superadmin lhes conceda uma função. Até lá, o bot indica-o educadamente.
- Vê apenas os projetos a que pertence; um superadmin vê todos os projetos.
Comandos#
Todos os comandos estão também listados no próprio menu / do Telegram junto ao campo de introdução, por isso nunca tem de os memorizar.
| Comando | O que faz |
|---|---|
/start, /menu |
Abre o menu principal e o teclado de botões. |
/login |
Confirma um início de sessão pendente no desktop (a alternativa ao QR). |
/projects |
Escolhe um projeto. |
/mode |
Escolhe uma função para o agente. |
/chats |
Lista e retoma as conversas recentes do projeto. |
/clear |
Limpa o histórico e o contexto da conversa atual. |
/cancel |
Para a tarefa que está atualmente em execução. |
/requests |
Abre o menu de pedidos de Support / Consult. |
/shipqueue |
Abre a revisão da fila de envio autónoma. |
/support |
Envia um relatório de uma mensagem para o support Makion. |
/help |
Mostra um cartão de ajuda breve. |
/admin |
Abre o menu de admin (apenas superadmin; os administradores do projeto veem apenas o seletor de motor por projeto). |
Botões do menu#
O menu principal mostra um teclado de botões persistente para que as ações comuns fiquem a um toque de distância. Tocar num botão executa a sua ação em vez de enviar a etiqueta como uma tarefa.
| Botão | O que faz |
|---|---|
| 📁 Projects | Escolhe um projeto. Depois de escolher, a lista de funções abre automaticamente. |
| 🎭 Mode | Escolhe uma função (consulte Funções no seletor). |
| 🕘 Chats | Lista as conversas recentes do projeto; toque numa para a retomar, ou inicie uma nova conversa. |
| 🗑 Clear chat | Limpa o histórico e o contexto da conversa atual. |
| 🔑 Log in on the computer | Confirma um início de sessão pendente no desktop. |
| 🔌 SAP | Mostra se está ligado um conector SAP a este projeto. |
| ❓ Help | Mostra o cartão de ajuda. |
| 🚀 Ship-queue | Reveja, aprove e aplique as propostas do agente autónomo (consulte A fila de envio). |
| 📋 Requests | Cria e gere pedidos de Support / Consult (consulte Pedidos de Support e Consult). |
| 🆘 Support | Descreva um problema numa mensagem; é enviado para o support Makion. |
| ⚙️ Admin | Abre o menu de admin. Mostrado apenas a um superadmin. |
Enviar uma tarefa#
Basta enviar uma mensagem de texto — é tratada como uma tarefa para o agente, executada sobre o projeto selecionado com a função selecionada. Pode anexar contexto primeiro:
- Anexe um documento ou uma foto e depois envie o texto da tarefa. O ficheiro entra no espaço de trabalho da tarefa como um anexo (até cerca de 20 MB por ficheiro).
- Os ficheiros produzidos que o agente cria durante a execução regressam à conversa como documentos.
A resposta chega em fluxo contínuo numa única mensagem, atualizada em direto à medida que o agente trabalha, com um rodapé "a trabalhar" a avançar para que um passo longo nunca pareça bloqueado. As respostas longas são divididas por várias mensagens. Se uma execução ficar completamente em silêncio durante vários minutos — quase sempre uma chamada bloqueada ao modelo de IA — o bot para-a por si próprio e diz-lhe para tentar novamente. Envie /cancel para parar uma execução você mesmo.
O histórico da conversa, a sessão de motor retomada e a última função usada são os mesmos registos que o desktop usa (delimitados à sua identidade de programador × projeto), pelo que pode iniciar uma tarefa no telemóvel e continuá-la no desktop, e vice-versa.
Funções no seletor#
O seletor 🎭 Mode agrupa as funções da mesma forma que o desktop, sob 🛠 Development, 💼 Consulting e 🆘 Support. Um cadeado 🔒 marca uma função que pode alterar o SAP (uma função com escrita); uma função sem cadeado é apenas leitura. Isto reflete como as funções funcionam: as funções de leitura apenas recebem fisicamente apenas ferramentas de leitura, pelo que não conseguem alterar o SAP independentemente da forma como a sua tarefa é redigida.
Se tiver permissão para criar projetos, aparece ➕ New project na lista de projetos e solicita um nome.
A fila de envio no seu telemóvel#
O menu 🚀 Ship-queue é a barreira de revisão humana do Modo autónomo, no seu telemóvel. Lista as propostas do agente autónomo e conduz exatamente o mesmo fluxo de aprovar e aplicar que o desktop — nada na fila tocou no SAP até que um humano o aplique.
| Ação | O que faz |
|---|---|
| Tocar numa proposta | Abre-a para ver o seu requisito, justificação e conteúdo. |
| ✅ Approve | Regista a aprovação de uma proposta pendente. Não escreve no SAP. |
| ❌ Reject | Regista a rejeição. Não escreve no SAP. |
| 🗑 Delete | Remove uma proposta da fila. |
| 🚀 Apply | Escreve uma proposta aprovada no SAP através do conector ligado. |
| 🚀 Apply all | Escreve e ativa todas as propostas aprovadas, no processo de duas fases, após uma confirmação. |
| 🧹 Clear rejected | Remove todas as propostas rejeitadas. |
| 🧹 Clear not-applied | Remove todas as propostas que não foram aplicadas. |
| 🕘 Runs | Lista as execuções autónomas recentes e abre uma para ver os seus passos e resumo. |
| 🔄 Refresh | Recarrega a fila. |
Uma aplicação transmite o seu progresso numa mensagem em direto e apresenta um resumo final honesto (escrito, ignorado ou falhado com o motivo do próprio SAP). Aplicar é a única ação que escreve no SAP, e requer um conector ligado — consulte o Modelo de segurança.
Pedidos de Support e Consult#
O menu 📋 Requests gere o ciclo de vida dos pedidos de Support / Consult a partir do telemóvel, usando as mesmas regras que a fila Requests do desktop.
| Ação | O que faz |
|---|---|
| ➕ New request | Cria um pedido: escolha 🆘 Support ou 💼 Consult, defina o impacto e a urgência, e depois envie um título (com detalhes opcionais). |
| Tocar num pedido | Abre-o para ver o seu estado, corpo, conclusões e notas. |
| 🔬 Investigate (read-only) | Inicia uma investigação de apenas leitura do pedido; reabra-o mais tarde para ler as conclusões. |
| 📝 Note | Adiciona uma nota ao pedido. |
| 📋 To triage / ⏸ Put on hold | Move o pedido pelo seu ciclo de vida (uma suspensão pede um motivo). |
| ✅ Approve / ❌ Reject / ⏸ Park | Regista uma decisão. Aprovar e rejeitar pedem um código de fecho e notas. Apenas administradores do projeto. |
O menu de admin#
⚙️ Admin apresenta as ações de configuração que de outra forma seriam inacessíveis a partir do telemóvel. Um superadmin vê todas; um administrador do projeto vê apenas o seletor Engine por projeto. Todas as ações passam pelas mesmas barreiras de permissão que o desktop.
| Ação | O que faz |
|---|---|
| 🧠 Engine | Altera o motor de IA para o projeto atual. |
| 🤖 Model | Altera o modelo global (superadmin). |
| ⬆️ Server update | Verifica e desencadeia uma autoatualização do servidor, após uma confirmação (superadmin). |
| 🧩 Retro proposals | Reveja, aprove ou rejeite propostas de aprender-com-os-erros (superadmin). Consulte Retro. |
| 🛡 Security audit | Executa a auditoria de segurança de apenas leitura e vê as suas conclusões (superadmin). |
O que o bot deliberadamente não consegue fazer#
O bot abrange o trabalho do dia a dia, mas algumas coisas ficam no desktop por opção de conceção:
- Abrir a ligação SAP. O túnel do conector SAP é ligado a partir do separador Sistemas do desktop. O botão 🔌 SAP apenas indica se um conector está ligado; uma tarefa ou uma aplicação que escreva no SAP precisa que esse conector de desktop esteja ativo.
- Gerir membros, funções e acesso ao projeto. Conceder funções e adicionar pessoas a projetos é uma ação de desktop. Consulte Utilizadores e acesso.
- Editar metodologia e conhecimento. As regras base, a metodologia por função e os ficheiros da base de conhecimento são editados no separador Metodologia do desktop.
- Definir credenciais de motor. Adicionar uma chave de API ou concluir um início de sessão de subscrição para um motor faz-se no desktop.
Idioma#
A interface do bot é bilingue (ucraniano / inglês) e segue o idioma do seu Telegram, com o inglês por predefinição.
Páginas relacionadas#
- Início de sessão e projetos — o início de sessão do desktop que o bot pode concluir.
- Como as funções funcionam — leitura apenas vs escrita, e o cadeado 🔒 no seletor.
- Modo autónomo — a fila de envio que o bot lhe permite aprovar e aplicar.
- Requests — o ciclo de vida de Support / Consult.
- Modelo de segurança — porque é que as aplicações precisam de um conector, e como as escritas são controladas.