Мануал по работе с Чатикусом
Что такое Чатикус? Зачем он нужен?
Чатикус (@chatikus_summary_bot) - это бот-суммаризатор сообщений. Иначе говоря - бот, создающий краткую выжимку из большого количества сообщений. Это экономит время - вы можете вместо, например, 500 сообщений, просмотреть одно саммари и понять, что обсуждалось в чате, нужно ли оно вам вообще и т.д.
Забегая вперед, надо сказать, что у бота функционал гораздо шире, о чем сейчас пойдет речь
Функционал
Начнем с команд. Команды Чатикуса условно можно разделить на две группы - "полезные" и "развлекательные". Конечно, можно использовать развлекательные функции с пользой и наоборот, но, повторимся, это условно, для понимания. Начнем с полезного.
Полезные команды
- /summary - самая основная команда. Бот после нее создаст саммари (краткую выжимку) на основе последних сообщений. Вам достаточно написать /summary в чат, чтобы она сработала.
Эта команда, как и многие другие, может принимать аргумент n - количество сообщений по которым будет создаваться саммари:
/summary [n]
Этот параметр вводить необязательно, поэтому он отмечен в квадратных скобках.
То есть, если вы захотите саммари по последним 100 сообщениям, то вы должны ввести в чат:
/summary 100
По умолчанию для бесплатного тарифа это число ограничено 150 сообщений - то есть, когда вы вводите число больше 150 или не вводите его вовсе, бот берет последние 150 сообщений.
Идем дальше
- /ask (ваш вопрос) - Эта команда отвечает на вопрос на основе сообщений в чате. Предположим, что в пределах последних 150 сообщений кто-то написал: "Антон выйдет на улицу в 15.30". Потом вы пишите:
/ask когда Антон выйдет на улицу?
Бот ответит:
Антон выйдет на улицу в 15.30
При этом важно понимать, что ответ на вопрос происходит исключительно на основе чата. Если вы спросите:
/ask сколько времен года?
То, как это ни странно, пусть это легкий вопрос, но если он в чате не обсуждался, бот на это ответит что-то в духе:
Информации о том, сколько времен года отсутствует в чате
Это сделано специально, чтобы исключить возможность ответа вне контекста чата. Для ответов на вопросы, которые с чатом не связаны есть другая команда
- /gpt (ваш вопрос) - Эта команда просто отвечает на ваш вопрос вне зависимости от контекста в чате. Здесь можно как раз задать вопрос:
/gpt сколько времен года?
Бот даст такой ответ:
На Земле традиционно выделяют четыре времени года: весна, лето, осень, зима
Важно! Вопрос можно задать разными способами. Первый - как в примере, когда вы пишите команду, будь то /ask или /gpt, а потом через пробел пишите вопрос:
Второй - вы можете написать сообщение с вопросом, ответить на него (reply), а после команды уже ничего не писать:
- /text ↩️ - команда, которая пишет расшифрованный текст с голосового сообщения/кружка/фотографии:
Важно: команды, которые работают только при ответе на другое сообщение будут далее помечаться знаком ↩️
- /help - кратко описывает команды бота. Если в чате установлены ограничения по командам для обычных пользователей (не администраторов), то также по этой команде будет отображено, какими командами пользоваться можно, а каким нельзя.
- /summary_thread - эта команда доступна только в чатах, в которых есть подчаты (также известны как топики, треды, темы). В отличие от просто /summary, которое делает саммари по абсолютно всем сообщениям, /summary_thread делает саммари только по сообщениям из треда, в котором эта команда была написана.
Развлекательные команды
- /opinion [n] ↩️ - высказывает мнение о пользователе, на ответ которого /opinion был отправлен. Можно также указать параметр n - число сообщений, на основе которых о пользователе будет сформировано мнение. По умолчанию бот формирует мнение о пользователе за счет одного сообщения - того, на которое был отправлен /opinion
- /comment ↩️ - похожая на /opinion команда, она комментирует то, что написал пользователь в сообщении, на которое вы ответили командой /comment.
Настройки
Бота можно очень сильно настраивать. Вы можете:
- Установить ежедневное саммари и его время - бот будет брать сообщения за последние 24 часа и в указанное вами время делать по этим сообщениям саммари. Имейте в виду, что ежедневное саммари произойдет, если в чате было хотя бы 10 сообщений за 24 часа.
- Установить закрепление саммари - вы можете настроить, нужно ли закреплять созданное ботом саммари в чате или нет
- Установить личность боту - бот будет отвечать так, будто он - эта та личность, которую вы ему установили
- Установить стиль общения - похожая на личность настройка, позволяющая более подробно описать, что вам нужно от бота. Имейте в виду, что бывает, когда стиль и личность несколько отличаются - в таком случае лучше пользоваться чем-то одним и не использовать одновременно и личность, и стиль бота.
- Включить саммари для подчатов - если у вас не просто чат, а чат с подчатами (говоря иначе - топиками, тредами, темами), то можно сделать так, чтобы саммари происходило по каждому подчату. Это касается и ежедневного саммари - оно будет отправляться во все подчаты.
- Настроить отображение ссылок на темы в саммари - если включено, то бот будет в заголовках саммари указывать ссылки, при нажатии на которые вы отправитесь именно на то сообщение в телеграме, с которого началась тема, указанная в саммари.
- Настроить отображение имен в саммари - в саммари бот может либо упоминать, либо не упоминать людей, которые участвовали в переписке. Вы можете настроить, отображать вам их имена или нет.
- Запрещать пользователям использовать выбранные вами команды - вы можете выбрать команды, которыми смогут пользоваться только администраторы. Под администратором подразумевается тот, у кого есть право банить участников.
- Настроить премодерацию ежедневного саммари - бот сначала вам будет отправлять саммари на одобрение, даст возможность отредактировать, и только потом отправит его в нужный чат.
О том, как это сделать, будет написано далее.
Как пользоваться ботом?
Итак, вы захотели добавить Чатикуса в свой чат. Как это сделать? Самый простой способ - написать /start в личные сообщения Чатикусу и нажать на кнопку "Добавить бота в чат".
После этого вам нужно выбрать чат из списка ваших чатов. Далее отобразится следующее окно:
Вам нужно нажать "Add bot as admin" (Добавить бота как администратора). Это нужно, чтобы бот мог читать сообщения в чате.
Альтернативно, вы также можете и добавить бота как обычного участника, а потом дать ему права админа - то, как именно вы добавите Чатикуса не принципиально.
В целом, готово! Ботом можно пользоваться. Но, возможно, вы захотите его настроить. Сделать это можно двумя способами: через специальные команды в общем чате или через интерфейс в личных сообщениях с ботом.
Разберем способ через интерфейс.
После добавления Чатикуса в чат, вы можете прописать команду /mychats, чтобы увидеть те чаты, в которые вы добавили Чатикуса.
Возможно, чата, в который вы добавили Чатикуса, нет в списке. Такое зачастую происходит тогда, когда в чате администраторы пишут от лица группы - бот не может связать конкретно вас с чатом, в который он был добавлен. Для этого просто пропишите команду /register_me *ваш id* в нужный чат, и бот добавит чат в список. Нужную команду с вашим id напишет бот в сообщение при команде /mychats (на скриншоте выше это id 111111110)
Далее, вы нажимаете на нужный вам чат. Здесь вы можете приобрести подписку или настроить чат:
Сейчас мы хотим настроить чат. Нажимаем, соответственно, "Настроить чат":
Такая панель с настройками доступна только если вы имеете право банить пользователей (то есть вы создатель или администратор, причем такой, у которого есть это право). Также нужно отметить, что большинство настроек доступно только с подпиской.
Так будет выглядеть экран после нажатия кнопки "Разрешенные команды:
Крестик - команда запрещена. Галка - команда разрешена. Когда вы нажимаете разрешенную команду, она становится запрещенной - и наоборот. После изменений не забудьте нажать на кнопку "Сохранить".
А вот такие настройки у вас откроются при нажатии на "Саммари"
Большинство настроек также доступно и через команды в общем чате. Например, время можно настроить как нажатием на "Время ежедневного саммари" на скриншоте выше, так и прописыванием в общий чат команды /settings_daily_time. Происходит одно и то же, разницы нет. Но пользователи также смогут участвовать в настройке бота. Список команд для настройки:
- /set_personality (личность) - устанавливает боту личность, которую он будет имитировать при саммари и ответах
- /clear_personality - очищает личность
- /set_tone_of_voice (стиль) - устанавливает боту стиль общения
- /clear_tone_of_voice - очищает стиль общения
- /settings_links - включает/отключает отображение ссылок в заголовках саммари на начало обсуждений темы заголовка
- /settings_daily_summary - включает/отключает ежедневное саммари
- /settings_daily_time (время в формате чч:мм) - устанавливает время ежедневного саммари
- /settings_pin - включает/отключает закрепление саммари
- /settings_threads - включает/отключает саммари в подчатах
- /settings_show_names - включает/отключает отображение имен в саммари
- /register_topic_name (название) - позволяет в чате с подчатами установить конкретное название подчату (оно будет отображать при премодерации саммари, что позволит легче понимать, в какой подчат пойдет то или иное саммари)
Частые вопросы
- Видит ли бот сообщения до его добавления?
Нет. Бот видит только те сообщения, которые появились после его добавления и назначения администратором.
По всем вопросам, предложениям, замечаниям пишите @chatikus_support