Назовите своего агента в Telegram¶

В Telegram ваш агент отображается под общим именем — главный бот называется просто mintbot.ai, а каждый дополнительный контакт — mintbot.ai (2), mintbot.ai (3) и так далее. Telegram не даёт переименовать контакт бота (ограничение для общих ботов), поэтому изменить это имя напрямую нельзя — даже если у вас всего один агент.

Есть простой обходной путь, ведь имя группы выбираете вы: поместите бота в отдельную группу и назовите её как угодно. Тогда агент будет отображаться в вашем списке чатов под этим именем.

💡 Хотите настоящего бота под собственным именем? Можно также подключить бота, который полностью ваш — созданного через @BotFather в Telegram, со своим именем, @username и картинкой, — и ваш агент будет отвечать там от своего имени. См. Свой бот в Telegram. Трюку с группой ниже новый бот не нужен — он работает с контактом, который у вас уже есть.

Как это сделать¶

Создайте новую группу в Telegram
Дайте группе любое имя (например, «Murr» или «Бот продаж»)
Добавьте бота агента в группу

Вот и всё. Агент отвечает в группе так же, как в личной переписке с ним, а имя группы — это то, что отображается в вашем списке чатов Telegram, так что фактически у агента теперь то имя, которое вы выбрали.

Полезно знать:

Работает и с одним агентом. Несколько агентов не нужны — так вы дадите своё имя и единственному боту mintbot.ai.
До него доходят только ваши сообщения. Если добавить в группу других людей, их сообщения агенту игнорируются — никто другой не сможет потратить ваш кредит.
При желании оставьте её приватной. Группа из вас и бота работает прекрасно.
Какой бот? Используйте того же бота, с которым уже общаетесь — главный @mintbot_ai_bot или собственный контакт агента, если он есть. Каждый агент отвечает в своей группе, со своей историей.

Закреплённое имя агента¶

Агент держит вверху чата закреплённое сообщение со своим именем, номером и названием текущей сессии, например 🤖 Murr (#1069) и затем название. Когда начинается новая сессия, оно обновляется само.

В группе боту нужны два права администратора — одно для закрепления, другое для скрытия паролей (см. ниже):

Откройте настройки группы → Администраторы → Добавить администратора
Выберите бота агента
Оставьте включённым Закрепление сообщений (Pin messages), включите также Удаление сообщений (Delete messages) и сохраните

То же касается группы с темами. Без этого права агент отвечает как обычно — нет только закреплённого сообщения. Когда вы дадите право, оно появится в течение часа, когда вы в следующий раз напишете агенту.

Удаление сообщений нужно для паролей. Когда вы отправляете агенту в чате пароль (или другой секрет), он использует его для задачи, а затем скрывает: ваше сообщение удаляется и публикуется заново от вашего имени, а пароль заменяется на 🔒••••••. В личном чате это работает само; в группе бот может удалить ваше сообщение только с правом Удаление сообщений. Без него агент всё равно выполнит задачу, но пароль останется на виду, и бот попросит вас удалить сообщение самостоятельно.

Панель и Telegram вместе¶

То, что вы пишете агенту в веб-панели, и его ответ появляются и в Telegram, когда там открыт тот же разговор — сессия, в которую ушло бы ваше следующее сообщение в Telegram. Они приходят беззвучно, под заголовком 🖥 Введено в веб-панели и вместе с файлами агента; телефон не звонит — вы ведь и так сидите за панелью. Разговор, начатый в панели, попадает в Telegram, как только вы откроете его там командой /sessions. Группа, которую читают другие, никогда не получает этих копий.

Изображения и файлы, отправленные вместе с сообщением, приходят следом за ним, а пока агент готовит ответ, в чате видно «печатает…» — как при сообщении из Telegram.

Вернуться к прежнему разговору¶

Выберите прежний разговор командой /sessions — и его последние 10 сообщений появятся прямо под подтверждением, беззвучно, чтобы ещё до того, как вы начнёте писать, было видно, на чём он остановился. Файл, который прислал агент, показан там по имени (📎). Под каждым ответом агента, как всегда, указаны модель и поставщик, которые его написали. Кнопка 📜 Открыть всю историю в панели открывает весь разговор в панели агента. Группа, которую читают другие, получает только подтверждение, сообщения — никогда.

Закреплённые сообщения¶

Закрепите сообщение — и оно будет под рукой и в веб-панели, и в Telegram. В чате панели наведите курсор на сообщение (на телефоне — коснитесь его) и нажмите 📌 рядом с его временем; в Telegram закрепите его как обычно. Через секунду закреплённое сообщение появится и на другой стороне: полосой над чатом панели — нажатие ведёт к сообщению — и закреплённой копией в вашем личном чате с ботом.

В группы копии не попадают никогда: группа — общее пространство, и сказанное вами наедине остаётся между вами и агентом. Сообщение, которое вы закрепили вручную в группе, всё равно попадает в панель и в ваш личный чат. Закрепить можно только сообщения самого разговора — меню или уведомление бота, закреплённое в Telegram, остаётся закреплённым только в Telegram. Пароль, который агент скрыл, остаётся скрытым и в закреплённом сообщении.

Закреплённые сообщения принадлежат сессии. Когда вы открываете в личном чате более старую сессию (/sessions), её закреплённые сообщения (10 самых новых) снова публикуются и закрепляются, а копии прежней сессии уходят в сторону; сообщение, которое вы закрепили сами, остаётся на месте.

Чтобы открепить, используйте панель или кнопку 📌✖ под копией — любой из способов открепляет везде. Telegram не сообщает ботам об откреплении через собственное меню: в личном чате копия так открепляется только с вашей стороны, поэтому используйте кнопку. Сообщение, которое вы закрепили сами, остаётся закреплённым в Telegram, пока вы не открепите его там, — это может сделать только тот, кто закрепил, — и панель заметит это, когда вы в следующий раз напишете агенту, если это было самое новое закрепление в чате (в группе с темами — никогда); иначе открепите его и в панели.

💡 Используете несколько агентов и хотите каждому своё место? См. Несколько агентов одновременно.