March 6

📖 Документация Telegram-бота «Перлика»

Перлика — это Telegram-бот, который помогает разбираться в лоре игры Arknights, а также предоставляет инструменты для администрирования чатов.

Бот всё еще находится на стадии разработки. Вы можете подписаться на официальный телеграм канал, где будут публиковаться дальнейшие обновления.

Бот поддерживает:


👋 Команда /start

Описание

Запускает бота в личных сообщениях и выводит приветственное сообщение.

Где работает

✅ Личные сообщения
❌ В группах не используется

Пример

/start

Ответ бота

Привет, Доктор! 👋

Я Перлика — помощник по лору Arknights.
Помогаю разбираться в сюжете, персонажах, фракциях и событиях игры.

Иногда могу отвечать с ошибками — я всё ещё учусь 💙
Задавай любой вопрос по лору!

⚙️ Система триггеров

Триггеры позволяют боту автоматически отвечать на определённые слова или фразы в чате.

Например пользователь пишет:

что такое оригиниум

Бот может автоматически отправить заранее заданный ответ.

⚠ Управлять триггерами могут только администраторы чата.


/settriger

Описание

Добавляет новый триггер в чат.

Когда сообщение содержит указанный триггер — бот отправит заданный текст.

Где работает

✅ Только в группах
❌ Не работает в личных сообщениях

Кто может использовать

👮 Только администраторы

Формат команды

/settriger "триггер" текст

Пример

/settriger "оригиниум" Оригиниум — источник энергии в мире Arknights.

Ответ бота

✅ Триггер "оригиниум" добавлен.

/delltriger

Описание

Удаляет существующий триггер из чата.

Где работает

✅ Только в группах

Формат

/delltriger "триггер"

Пример

/delltriger "оригиниум"

Ответ бота

🗑 Триггер "оригиниум" удалён.

📋 /triggerlist

Описание

Показывает список всех триггеров в текущем чате.

Пример

/triggerlist

Ответ

📋 Список триггеров:
• оригиниум
• родос
• инфекция

👋 Система приветствия (Welcome)

Бот может автоматически отправлять приветственное сообщение, когда новый участник входит в чат.

Поддерживается:

  • 📝 текст
  • 🖼 фото
  • 🎥 видео
  • 🎞 GIF

⚙️ Переменные welcome

Можно использовать переменные:

Переменная

Значение

{user}

упоминание пользователя

{first_name}

имя пользователя

{id}

Telegram ID

Пример

Добро пожаловать {user}!

Бот отправит:

Добро пожаловать @username!

/setwelcome

Описание

Устанавливает приветственное сообщение для новых участников.

Кто может использовать

👮 Только администраторы

Где работает

✅ Только в группах


Способ 1 — текст

/setwelcome Добро пожаловать {user} в наш чат!

Способ 2 — ответ на сообщение

Можно ответить на сообщение с:

  • фото
  • видео
  • GIF
  • текстом

и написать:

/setwelcome

Способ 3 — медиа + текст

Ответьте на медиа и добавьте текст:

/setwelcome Добро пожаловать {user}!

Ответ бота

✅ Welcome успешно сохранён.

/delwelcome

Удаляет приветственное сообщение.

Формат

/delwelcome

Ответ

🗑 Welcome успешно удалён.

Если welcome не установлен:

⚠ Welcome не установлен.

🤖 Управление AI Перлики

Перлика может работать как ИИ-ассистент по лору Arknights.

Администраторы могут управлять её состоянием.


🧠 /clearai

Описание

Очищает память диалога.

После команды бот забывает контекст разговора.

Формат

/clearai

Ответ

🧠 Перлика всё забыла...

Альтернативные фразы

Можно написать:

забыть всё
перезагрузиться
перлика забудь

▶️ /onai

Описание

Включает AI-режим.

Кто может использовать

👮 Только администраторы

Формат

/onai

Ответ

🤖 Перлика включена.

/offai

Описание

Выключает AI-режим.

Формат

/offai

Ответ

🚫 Перлика выключена.

💬 Общение с Перликой

В личных сообщениях можно просто написать вопрос.

Пример:

кто такая кал'цит

Бот ответит напрямую.


👥 В группах

Бот отвечает если:

1️⃣ его упомянули

перлика кто такая кал'цит

2️⃣ ответили на сообщение бота

3️⃣ включён режим /onai


🧠 Память диалога

Перлика хранит:

  • последние сообщения пользователей
  • свои ответы

Максимум:

20 сообщений

Контекст:

10 последних сообщений

🔗 Привязка AI к теме форума

Команда позволяет закрепить работу ИИ Перлики только внутри одной темы форума в группе Telegram.

Это удобно, если в группе несколько тем и нужно, чтобы бот не отвечал везде.


📌 /bindtopic

Описание

Привязывает ИИ Перлики к текущей теме форума.

После этого бот будет реагировать только на сообщения внутри этой темы.

Все остальные темы будут игнорироваться.


Кто может использовать

👮 Только администраторы


Где работает

✅ Только в группах
✅ Только в темах форума


Формат команды

/bindtopic

Также можно написать:

Привязать тему

Важное условие

Команда должна быть отправлена внутри темы форума.

Если написать её вне темы, бот ответит:

Команду нужно написать внутри темы.

Успешный ответ

✅ Перлика теперь живёт только в этой теме.

Как использовать

1️⃣ Создайте тему форума в группе
2️⃣ Зайдите в неё
3️⃣ Напишите:

/bindtopic

После этого Перлика будет отвечать только там.


⏱ Ограничение частоты ответов

Чтобы бот не спамил в чатах, действует ограничение.

Перлика отвечает не чаще одного раза в 10 секунд на чат.

Но есть исключение.

Если пользователь ответил на сообщение бота, ограничение снимается.


📚 Использование базы лора

Если вопрос связан с лором игры Arknights, Перлика использует базу знаний.

В этом режиме бот:

  • отвечает строго по канону
  • не придумывает факты
  • если информации нет — сообщает об этом

💬 Обычный режим общения

Если вопрос не связан с лором, Перлика отвечает как обычный чат-ассистент.

Особенности:

  • дружелюбный стиль общения
  • короткие ответы
  • естественный диалог

👤 Определение адресата

Перлика может понимать, кому адресовано сообщение.

Например:

перлика скажи васе что он прав

Бот попытается определить пользователя Васю среди активных участников чата.


👥 Учёт участников чата

Бот хранит список последних активных пользователей, чтобы:

  • лучше понимать диалог
  • корректно обращаться к людям
  • находить адресатов сообщений

💬 Индикатор печати

Перед отправкой ответа бот показывает:

typing...

Это создаёт ощущение реального набора сообщения.


⚠️ Ошибки AI

Если возникает ошибка при работе ИИ, бот отвечает:

Перлика заебалась... 💭