TRIBLY
Документация Tribly → Личный ИИ-секретарь

Личный ИИ-секретарь

Личный ИИ-секретарь выполняет действия в мессенджере от вашего имени — по команде текстом или голосом. Каждое его действие помечено: видно, что это сделал ассистент и какой моделью.

Пузырь на экране ассистента

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

Жесты:

  • Нажатие во время озвучки останавливает озвучку. Нажатие на молчащий пузырь толкает его в сторону от точки касания; на место он возвращается сам.
  • Удержание останавливает озвучку.
  • Быстрое ведение пальцем или курсором через пузырь разрезает его надвое; половинки сходятся сами.

Озвучка ответов

Кнопка динамика в шапке экрана ассистента включает и выключает авто-озвучку ответов. Пока ответ печатается, справа внизу у него стоит отметка «будет озвучен»; нажатие на неё переключает отметку в «без озвучки» и обратно. У готового ответа на том же месте — кнопка динамика: нажатие озвучивает ответ. При выключенной авто-озвучке у каждого ответа стоит отметка «без озвучки».

Готовая озвучка хранится на сервере вместе с историей чата и открывается с любого устройства, пока сообщение остаётся в истории. Глубина истории задаётся в настройках ассистента.

Кому доступен

Уровень доступа Что даёт
Пользоваться ассистентом Открывает кнопку ассистента и чат с ним
Настраивать ассистента Менять настройки секретаря и сценарии (включает и обычный доступ)

Дополнительно доступ можно сузить до определённых ролей — тогда секретарь доступен только людям с этими ролями.

Включение

По умолчанию секретарь выключен. Включает его пользователь с правом настраивать ассистента: он указывает адрес модели, ключ доступа и параметры модели. Если параметры модели не заданы, секретарь использует настройки ИИ-бота (см. «ИИ-бот в чатах»).

Слово пробуждения по умолчанию — «Мария»; его можно поменять и для всех сразу, и лично для себя.

Возможности ассистента

По вашей команде секретарь может:

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

Подключение папки проекта: задачи по коду

Ассистент читает ваш проект и создаёт по нему задачи на доске — с техническим заданием, оценкой сложности и исполнителями.

Порядок работы

  1. В чате ассистента нажмите «Подключить папку проекта» (иконка папки слева от поля ввода). Обзор папки работает в приложении Tribly для Windows, Android, macOS и Linux.

  2. Выберите каталог проекта — приложение покажет, сколько файлов и сколько кода уйдёт ассистенту.

  3. Напишите задание своими словами, например:

    «На этом проекте сделай техническое ТЗ для Павла с учётом сложности и трудозатрат: встроить телеграм-бота. Для Семёна: реализовать новое API для платёжной системы.»

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

Состав слепка

Папку сканирует клиент, на вашем компьютере. На сервер уходит «слепок»:

  • дерево файлов (пути и размеры);
  • содержимое текстовых файлов — по приоритету: сначала README и манифесты (package.json, go.mod, pubspec.yaml и т.п.), затем точки входа, затем остальной код;
  • сводка: языки, точки входа, размер.

Остаётся на компьютере: служебные каталоги (.git, node_modules, build, dist, target, .venv и другие), бинарники, медиа, архивы.

Лимиты: до 3000 файлов в дереве, до 1.5 МБ исходников суммарно, до 32 КБ на файл (на сервере — свои страховочные лимиты). Что не поместилось — отсекается с конца, «хвостом»; README и манифесты попадают всегда.

Хранение: слепок живёт только на время обработки запроса и уходит выбранной вами модели ИИ. Всё, что в него попало, видит поставщик модели — не подключайте папки с боевыми ключами (.env) и приватными ключами.

Ход разбора

Секретарь разбирает проект, подбирает доску и читает её регламент, находит названных вами людей и создаёт по задаче на каждый пункт. Лимит шагов — тот, что задан в настройках ассистента.

Описание доски: регламент для ассистента

Поле «Описание» у канбан-доски ассистент читает перед созданием задач и соблюдает буквально. Опишите там, как устроена работа команды, — и задачи придут сразу в вашем формате.

Что имеет смысл там задать:

  • Назначение доски — «доска разработки», «маркетинг», «поддержка». По этому ассистент и выбирает, куда класть задачи.
  • Стартовая колонка для новых задач.
  • Шаблон ТЗ — какие разделы обязательны в описании карточки.
  • Шкала сложности — например, story points по Фибоначчи (1, 2, 3, 5, 8, 13) и что означает каждая цифра.
  • Роли — кто ревьюер, кто тестировщик, кого назначать по умолчанию.
  • Метки, которые приняты в команде.

Пример описания доски:

Доска разработки. Новые задачи — в колонку «Бэклог».

Шаблон ТЗ (обязательные разделы описания карточки):
1. Контекст — что в проекте есть сейчас, со ссылками на конкретные файлы.
2. Что сделать — по пунктам.
3. Точки интеграции — конкретные файлы и функции.
4. Критерии приёмки.
5. Риски.

Сложность: story points по Фибоначчи (1, 2, 3, 5, 8, 13). 1 ≈ час работы, 8 ≈ несколько дней. Оценку обосновывать в ТЗ.
Ревьюер по умолчанию — Пётр. Тестировщик — Анна.
Метки: backend, frontend, инфраструктура, срочно.

Если описание доски пустое, ассистент применит общий шаблон ТЗ (Контекст / Что сделать / Точки интеграции / Критерии приёмки / Риски) и предупредит, что регламент доски не описан.

ИИ-интеграция: реакция на сообщения ботов

Секретарь умеет автоматически реагировать на сообщения ботов в каналах — например, разбирать ошибки из систем мониторинга и сразу принимать меры по вашим регламентам.

Условия подключения интеграции

Реакцию запускает любое сообщение бота-участника с заполненным полем «ИИ-контекст», а действует ассистент правами владельца канала. На решение влияет всё, что попало к нему в контекст: текст сообщений, содержимое подключённых вики-папок, название канала. Отсюда два условия:

  • Доверенный состав участников канала. Бота заводит тот, кому это позволяет его роль, и сообщение такого бота становится поводом для действий ассистента.
  • Узкий круг редакторов у подключённых вики-папок. Текст страницы уходит ассистенту как инструкция.

Порядок:

  1. Владелец канала открывает настройки канала → «ИИ советник» и включает секцию «ИИ Интеграция»: подключает вики-папки с инструкциями (как реагировать на какие события, куда подключаться, кого привлекать) и при желании добавляет промпт.

  2. Бот отправляет сообщение через Bot API с заполненным служебным полем «ИИ-контекст» (ai_context). Например, текст сообщения: «Error: превышено время ожидания», а в ai_context — «ошибка при связи с БД, сервер db-1, доступ по SSH порт 22». Реакция запускается, только когда поле заполнено.

    Под таким сообщением появляется плашка «Вызов ИИ» — разворачивается и показывает, что именно бот передал ассистенту. Плашка появляется и при выключенной интеграции — видно, что бот просил ассистента. Показывается она сотрудникам.

  3. Секретарь собирает общий контекст: текст сообщения бота + ИИ-контекст + инструкции из подключённых вики-папок + промпт канала — и действует своими инструментами от лица владельца канала строго в рамках его прав: может создать задачу, написать в канал, найти и привлечь нужных специалистов.

  4. Отчёт (что произошло, что сделано, что рекомендуется) прикрепляется к сообщению бота сворачиваемым блоком «ИИ интеграция» и показывается сотрудникам канала.

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

Важно:

  • Интеграция работает только при включённом ИИ-ассистенте; выключили ассистента — реакция останавливается (в настройках канала об этом предупреждает иконка, настройки сохраняются).
  • Вики-папки читаются с правами владельца канала: в контекст идут страницы, открытые ему матрицей доступа.
  • Прогоны расходуют дневной лимит ассистента владельца канала и пишутся в журнал аудита, как обычные действия секретаря.
  • Опасные действия (удаление и подобные) автоматический прогон пропускает: они перечисляются в отчёте, и при необходимости владелец выполняет их сам — командой ассистенту в его чате.
  • Сценарии заводит человек — та же защита от зацикливания, что и у плановых.

Безопасность

  • Секретарь действует в ваших правах. Каждое действие проверяется по ним: доступ к чату, к доске, к базе знаний.
  • Исполнителем задачи он назначит того, кто видит доску. Если человека нет в команде доски, секретарь скажет об этом в ответе.
  • Разбор проекта — только чтение: секретарь работает с присланным слепком.
  • Опасные действия (удаление, массовые изменения) секретарь выполняет только после подтверждения — для самых рискованных нужно ввести точную фразу «Да, для подтверждения».
  • Все действия секретаря записываются в журнал аудита: кто, что просил, какой инструмент был вызван, разрешалось ли действие и чем всё закончилось. По журналу всегда можно разобрать, что происходило.

Лимиты

  • За одну команду секретарь делает ограниченное число шагов-действий — столько, сколько задано в настройках ассистента. Шаг — это один вызов инструмента: найти человека, выбрать доску, создать задачу.
  • Длину ответа задаёт «Лимит ответа (токенов)» в настройках ассистента, по умолчанию 16000. Это потолок, а не расход: списывается написанное. У думающих моделей (glm, minimax, qwen-thinking) из этого же лимита идут внутренние рассуждения, и на малом лимите они забирают его целиком — тогда секретарь отвечает, что лимит израсходован на рассуждения, и называет число.
  • Не более 100 сценариев на пользователя.
  • Сценарии выполняются по расписанию сами; новые сценарии заводит человек — защита от зацикливания.

Голосовой ввод

Команду секретарю можно продиктовать голосом. Сервис распознавания задаёт администратор в настройках ассистента на сервере.

Смежные страницы: «ИИ-бот в чатах (botai)», «Роли и права (RBAC)», «Голосовые, видео, распознавание и озвучка».