Спросить из документа или тикета
Как обратиться к ИИ-агенту в Notion, Google Документе, Confluence, Figma или трекере: формы обращения, куда приходит ответ, чего бот не делает.
Открывать приложение не обязательно. Если ваш ИТ-специалист подключил к пространству Notion, Google Диск, Confluence, Figma или трекер, вопрос задаётся комментарием к странице, документу, макету или тикету — и ответ приходит в то же обсуждение. Ответ считается по всем документам и знаниям пространства, а не только по той странице, где вы спросили.
Где и как обратиться
| Где вы работаете | Где написать | Как обратиться |
|---|---|---|
| Notion | комментарий к странице | @buff текстом (псевдоним из настроек подключения) или @ и имя интеграции; меню упоминаний Notion интеграцию не предлагает — наберите вручную |
| Google Документы, Таблицы, Презентации | комментарий к файлу | +адрес учётной записи бота — подсказка подставит имя — или @buff |
| Confluence | комментарий к странице | @buff или псевдоним из настроек подключения |
| Figma | комментарий, приколотый к месту на макете | @buff; ответ приходит в ту же ветку |
| Трекер — Jira, Jira Cloud, Redmine, GitLab, GitHub, Gitea и Forgejo, Bitbucket (в pull request) | комментарий к тикету | @buff … или команда /ask … |
| Папка на сервере, сетевая папка | нигде — у папки нет комментариев | вопрос задаётся в приложении, папка — источник для ответа |
Регистр не важен: @Buff, BUFF, /Research — всё это обращения. Текст вокруг обращения учитывается: можно сначала описать ситуацию, потом попросить. В любой системе работает и команда /ask … в начале строки. Повторное обращение в той же ветке или тикете продолжает тот же разговор — даже если пишет другой человек.
Что можно попросить
| Что написать | Что произойдёт |
|---|---|
@buff какой срок реакции обещан на тарифе «Бизнес»? | вопрос — ответ комментарием в ту же ветку |
@buff research расхождения регламента, FAQ и договоров по срокам или /research … | глубокое исследование — документ и ссылка придут туда же |
/ask … | то же, что вопрос без команды, только явно |
Команда task (@buff task …, /task …) в пространстве не работает: задачу разработки здесь поставить не во что, и бот так и ответит.
Что придёт в ответ
- Сразу — короткое «принял, работаю»: исследование идёт минутами, и без этого непонятно, услышал ли бот.
- Ссылка — на диалог или исследование в приложении Buff. В Jira она попадает в блок ссылок тикета, а не в ленту комментариев.
- Результат — готовый ответ комментарием в ту же ветку. Если данных не хватает, бот задаст уточняющий вопрос там же и дождётся ответа.
Как выглядит заказанное исследование
| Откуда заказали | Что появится |
|---|---|
| Notion | дочерняя страница под той, где спросили, — текстом, с приложенным PDF; в ветку — комментарий со ссылкой |
| Google Диск | новый документ Google в той же папке, что и документ, где спросили, и PDF рядом; в ветку — ответ со ссылкой |
| Confluence | PDF-документ, приложенный к странице, и комментарий со ссылкой |
| Figma | комментарий со ссылкой — к комментарию Figma файл приложить нельзя |
| Трекер | комментарий и PDF вложением к тикету там, где трекер принимает вложения (в Jira — в Data Center и в Cloud) |
Страница или документ создаются только внутри отмеченного раздела или папки. Существующие страницы и документы не меняются.
Чего бот не делает
- Отвечает только на прямое обращение. Метки, статусы, движение тикета по доске — не обращения; назначение задачи боту включается отдельно, если у вас назначает человек осознанно. Комментарии, написанные до включения подключения, бот не разгребает.
- Ничего не меняет. Не редактирует страницы, документы, таблицы и макеты, не двигает статусы и метки, не назначает исполнителей. Единственное, что он пишет, — комментарий-ответ и, для исследования, документ рядом.
- Отвечает только там, где работает подключение. Разделы, папки, файлы и проекты задаёт подключение. У трекеров пустой список — нигде; у Confluence, Notion, Google Диска и Figma пустой список — всё, что открыто учётной записи подключения. Если бот молчит — что попросить у администратора.
- Подписывает комментарии учётной записью подключения. Если Google Диск подключён входом через ваш аккаунт Google, а не сервисной учётной записью, ответы появятся от этого аккаунта.
Кто может спросить и кто видит ответ
- Спросить может любой, кто может оставить комментарий в отмеченном месте: бот не проверяет, участник ли человек Buff и есть ли у него доступ к пространству. Гость или подрядчик в Jira, Confluence или Notion тоже получит ответ.
- Ответ строится по всем подключениям пространства — вопрос из тикета может получить ответ из вики и Диска этого пространства.
- Ответ — обычный комментарий. Его видят все, кто видит страницу или тикет. В GitLab и Redmine ответ на внутреннюю или приватную заметку публикуется открытым комментарием.
- Расход — организации, как у любого вопроса.
Поэтому к пространству подключайте только разделы, которые не видят и не комментируют посторонние — клиенты, подрядчики, гости, а пространство с закрытыми документами — HR, юристов — не подключайте там, где страницы и тикеты видят другие отделы.
Подробности по каждой системе — на страницах Notion, Google Диск, Confluence и Figma, Трекеры, Jira.