Telegram-бот
Makion постачається з вбудованим Telegram-ботом: мобільним фронтендом до вашого власного сервера Makion. З бота ви можете обрати проєкт, вибрати роль, надіслати задачу з текстом або вкладеннями, спостерігати, як відповідь стримиться, отримувати файли, які створює агент, схвалювати й застосовувати елементи автономної черги змін (ship queue), а також керувати запитами Support / Consult — більшість того, що десктопний застосунок робить для щоденної роботи.
Бот працює на тому самому сервері, що й десктопний бекенд, і зіставляє ваш акаунт Telegram із тією самою ідентичністю розробника Makion, що використовується для входу. Окремих акаунтів немає: ваші проєкти, ролі, історія чатів і дозволи абсолютно однакові в обох.
Бот не може сам відкрити з'єднання з SAP. Тунель конектора SAP приєднується з десктопного застосунку; з телефона ви можете бачити його статус і керувати виконаннями, але встановлення тунелю — це десктопна дія. Див. Системи.
Запуск і прив'язка бота#
Бот — той самий, що використовується для входу через Telegram QR. Щоб ним скористатися:
- Відкрийте бота Makion вашої організації в Telegram і надішліть
/start(або/menu). Ваш адміністратор може підказати правильного бота. - Бот зіставляє ваш акаунт Telegram із розробником Makion. Якщо у вас ще немає ролі, він так і скаже — попросіть адміністратора надати вам роль і доступ до проєкту, точно як на десктопі. Див. Користувачі та доступ.
- Щойно ви отримаєте доступ, з'явиться головне меню з завжди видимою клавіатурою кнопок над полем введення.
Вхід на десктоп із бота#
Бот також може завершити вхід на десктопі без сканування QR-коду. На екрані входу на десктопі показано QR-код; замість того щоб його сканувати, натисніть 🔑 Увійти на комп'ютері в боті (або надішліть /login). Бот підтверджує очікуваний вхід десктопа, і застосунок входить під час свого наступного опитування.
Хто може ним користуватися#
Ідентичність і дозволи точно збігаються з десктопною моделлю:
- Найперша людина, яка відкриває бота, стає суперадміном.
- Усі після неї починають без доступу, доки суперадмін не надасть їм роль. До того бот ввічливо про це повідомляє.
- Ви бачите лише проєкти, до яких належите; суперадмін бачить усі проєкти.
Команди#
Кожна команда також є в меню / Telegram поруч із полем введення, тож вам ніколи не доведеться їх запам'ятовувати.
| Команда | Що робить |
|---|---|
/start, /menu |
Відкрити головне меню й клавіатуру кнопок. |
/login |
Підтвердити очікуваний вхід на десктопі (альтернатива QR). |
/projects |
Обрати проєкт. |
/mode |
Обрати роль для агента. |
/chats |
Перелічити й відновити нещодавні чати проєкту. |
/clear |
Очистити історію та контекст поточного чату. |
/cancel |
Зупинити задачу, що зараз виконується. |
/requests |
Відкрити меню запитів Support / Consult. |
/shipqueue |
Відкрити перегляд автономної черги змін. |
/support |
Надіслати одноразове повідомлення в підтримку Makion. |
/help |
Показати коротку довідкову картку. |
/admin |
Відкрити меню адміністрування (лише суперадмін; адміністратори проєкту бачать лише перемикач рушія для проєкту). |
Кнопки меню#
Головне меню показує постійну клавіатуру кнопок, тож поширені дії — за один дотик. Дотик до кнопки виконує її дію, а не надсилає її напис як задачу.
| Кнопка | Що робить |
|---|---|
| 📁 Проєкти | Обрати проєкт. Після вибору список ролей відкривається автоматично. |
| 🎭 Режим | Обрати роль (див. Ролі в списку вибору). |
| 🕘 Чати | Перелічити нещодавні чати проєкту; торкніться одного, щоб відновити його, або почніть новий чат. |
| 🗑 Очистити чат | Очистити історію та контекст поточного чату. |
| 🔑 Увійти на комп'ютері | Підтвердити очікуваний вхід на десктопі. |
| 🔌 SAP | Показати, чи приєднано конектор SAP для цього проєкту. |
| ❓ Допомога | Показати довідкову картку. |
| 🚀 Черга змін | Переглянути, схвалити й застосувати пропозиції автономного агента (див. Черга змін). |
| 📋 Запити | Створювати запити Support / Consult і керувати ними (див. Запити Support і Consult). |
| 🆘 Підтримка | Опишіть проблему одним повідомленням; воно надсилається в підтримку Makion. |
| ⚙️ Адмін | Відкрити меню адміністрування. Показується лише суперадміну. |
Надсилання задачі#
Просто надішліть текстове повідомлення — воно сприймається як задача для агента, виконується проти обраного проєкту з обраною роллю. Спершу можна прикріпити контекст:
- Прикріпіть документ або фото, потім надішліть текст задачі. Файл потрапляє в робочий простір задачі як вкладення (до приблизно 20 МБ на файл).
- Створені файли, які агент генерує під час виконання, повертаються в чат як документи.
Відповідь стримиться в одне повідомлення, оновлюючись наживо, поки агент працює, з «тікаючим» футером «working», щоб довгий крок ніколи не виглядав застряглим. Довгі відповіді розбиваються на кілька повідомлень. Якщо виконання повністю замовкає на кілька хвилин — майже завжди це застряглий виклик до AI-моделі — бот сам його зупиняє й пропонує спробувати ще раз. Надішліть /cancel, щоб зупинити виконання самостійно.
Історія розмови, відновлена сесія рушія та остання використана роль — це ті самі записи, що використовує десктоп (у межах вашої ідентичності розробника × проєкт), тож ви можете почати задачу на телефоні й продовжити її на десктопі, і навпаки.
Ролі в списку вибору#
Список вибору 🎭 Режим групує ролі так само, як десктоп, під 🛠 Розробка, 💼 Консалтинг і 🆘 Підтримка. Замок 🔒 позначає роль, що може змінювати SAP (роль із записом); роль без замка — лише для читання. Це віддзеркалює те, як працюють ролі: ролям лише для читання фізично видаються лише інструменти читання, тож вони не можуть змінити SAP незалежно від формулювання вашої задачі.
Якщо вам дозволено створювати проєкти, у списку проєктів з'являється ➕ Новий проєкт і запитує назву.
Черга змін на вашому телефоні#
Меню 🚀 Черга змін — це людський контроль для Автономного режиму, на вашому телефоні. Воно перелічує пропозиції автономного агента й керує тим самим потоком схвалення-й-застосування, що й десктоп — ніщо в черзі не торкалося SAP, доки людина це не застосує.
| Дія | Що робить |
|---|---|
| Дотик до пропозиції | Відкрити її, щоб побачити вимогу, обґрунтування та наповнення. |
| ✅ Схвалити | Записати схвалення для пропозиції, що очікує. Не пише в SAP. |
| ❌ Відхилити | Записати відхилення. Не пише в SAP. |
| 🗑 Видалити | Прибрати пропозицію з черги. |
| 🚀 Застосувати | Записати одну схвалену пропозицію в SAP через приєднаний конектор. |
| 🚀 Застосувати все | Записати й активувати кожну схвалену пропозицію, у двофазному процесі, після підтвердження. |
| 🧹 Очистити відхилені | Прибрати всі відхилені пропозиції. |
| 🧹 Очистити незастосовані | Прибрати кожну пропозицію, що не була застосована. |
| 🕘 Виконання | Перелічити нещодавні автономні виконання й відкрити одне, щоб побачити його кроки й підсумок. |
| 🔄 Оновити | Перезавантажити чергу. |
Застосування стримить свій прогрес у живе повідомлення й повідомляє чесний підсумковий результат (записано, пропущено чи не вдалося — із власною причиною SAP). Застосування — єдина дія, що пише в SAP, і воно потребує приєднаного конектора — див. Модель безпеки.
Запити Support і Consult#
Меню 📋 Запити керує життєвим циклом запитів Support / Consult із телефона, за тими самими правилами, що й черга Запитів на десктопі.
| Дія | Що робить |
|---|---|
| ➕ Новий запит | Створити запит: оберіть 🆘 Support або 💼 Consult, задайте вплив і терміновість, потім надішліть заголовок (з опційними деталями). |
| Дотик до запиту | Відкрити його, щоб побачити статус, тіло, висновки та нотатки. |
| 🔬 Дослідити (лише читання) | Розпочати дослідження запиту лише для читання; відкрийте його пізніше, щоб прочитати висновки. |
| 📝 Нотатка | Додати нотатку до запиту. |
| 📋 На тріаж / ⏸ Відкласти | Провести запит через його життєвий цикл (відкладення просить причину). |
| ✅ Схвалити / ❌ Відхилити / ⏸ Припаркувати | Записати рішення. Схвалення та відхилення просять код закриття й нотатки. Лише адміністратори проєкту. |
Меню адміністрування#
⚙️ Адмін відкриває дії конфігурації, які інакше недоступні з телефона. Суперадмін бачить усі з них; адміністратор проєкту бачить лише перемикач Рушій для проєкту. Кожна дія проходить через ті самі контролі дозволів, що й десктоп.
| Дія | Що робить |
|---|---|
| 🧠 Рушій | Змінити AI-рушій для поточного проєкту. |
| 🤖 Модель | Змінити глобальну модель (суперадмін). |
| ⬆️ Оновлення сервера | Перевірити наявність і запустити самооновлення сервера, після підтвердження (суперадмін). |
| 🧩 Пропозиції Retro | Переглянути, схвалити чи відхилити пропозиції навчання на помилках (суперадмін). Див. Retro. |
| 🛡 Аудит безпеки | Запустити аудит безпеки лише для читання й побачити його висновки (суперадмін). |
Що бот навмисно не може робити#
Бот покриває щоденну роботу, але кілька речей за задумом лишаються на десктопі:
- Відкрити з'єднання з SAP. Тунель конектора SAP приєднується з десктопної вкладки Системи. Кнопка 🔌 SAP лише повідомляє, чи приєднано конектор; задача або застосування, що пише в SAP, потребує, щоб цей десктопний конектор був активним.
- Керувати учасниками, ролями та доступом до проєктів. Надання ролей і додавання людей до проєктів — це десктопна дія. Див. Користувачі та доступ.
- Редагувати методологію та знання. Базові правила, методологія для кожної ролі та файли бази знань редагуються на десктопній вкладці Методологія.
- Задавати облікові дані рушія. Додавання API-ключа чи завершення входу за підпискою для рушія робиться на десктопі.
Мова#
Інтерфейс бота двомовний (українська / англійська) і слідує мові вашого Telegram, за замовчуванням — англійська.
Пов'язані сторінки#
- Вхід і проєкти — десктопний вхід, який бот може завершити.
- Як працюють ролі — лише читання проти запису, і замок 🔒 у списку вибору.
- Автономний режим — черга змін, яку бот дає змогу схвалювати й застосовувати.
- Запити — життєвий цикл Support / Consult.
- Модель безпеки — чому застосування потребують конектора і як контролюється запис.