# Спросить из документа или тикета

> Как обратиться к ИИ-агенту в 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 …`) в пространстве **не работает**: задачу разработки здесь поставить не во что, и бот так и ответит.

## Что придёт в ответ

1. **Сразу** — короткое «принял, работаю»: исследование идёт минутами, и без этого непонятно, услышал ли бот.
2. **Ссылка** — на диалог или исследование в приложении Buff. В Jira она попадает в блок ссылок тикета, а не в ленту комментариев.
3. **Результат** — готовый ответ комментарием в ту же ветку. Если данных не хватает, бот задаст уточняющий вопрос там же и дождётся ответа.

## Как выглядит заказанное исследование

| Откуда заказали | Что появится |
| --- | --- |
| Notion | **дочерняя страница** под той, где спросили, — текстом, с приложенным PDF; в ветку — комментарий со ссылкой |
| Google Диск | **новый документ Google** в той же папке, что и документ, где спросили, и PDF рядом; в ветку — ответ со ссылкой |
| Confluence | PDF-документ, приложенный к странице, и комментарий со ссылкой |
| Figma | комментарий со ссылкой — к комментарию Figma файл приложить нельзя |
| Трекер | комментарий и **PDF вложением** к тикету там, где трекер принимает вложения (в Jira — в Data Center и в Cloud) |

Страница или документ создаются только внутри отмеченного раздела или папки. Существующие страницы и документы не меняются.

## Чего бот не делает

- **Отвечает только на прямое обращение.** Метки, статусы, движение тикета по доске — не обращения; назначение задачи боту включается отдельно, если у вас назначает человек осознанно. Комментарии, написанные до включения подключения, бот не разгребает.
- **Ничего не меняет.** Не редактирует страницы, документы, таблицы и макеты, не двигает статусы и метки, не назначает исполнителей. Единственное, что он пишет, — комментарий-ответ и, для исследования, документ рядом.
- **Отвечает только там, где работает подключение.** Разделы, папки, файлы и проекты задаёт подключение. У трекеров пустой список — нигде; у Confluence, Notion, Google Диска и Figma пустой список — всё, что открыто учётной записи подключения. Если бот молчит — [что попросить у администратора](/docs/for-admin).
- **Подписывает комментарии учётной записью подключения.** Если Google Диск подключён входом через ваш аккаунт Google, а не сервисной учётной записью, ответы появятся от этого аккаунта.

## Кто может спросить и кто видит ответ

- **Спросить может любой**, кто может оставить комментарий в отмеченном месте: бот не проверяет, участник ли человек Buff и есть ли у него доступ к пространству. Гость или подрядчик в Jira, Confluence или Notion тоже получит ответ.
- **Ответ строится по всем подключениям пространства** — вопрос из тикета может получить ответ из вики и Диска этого пространства.
- **Ответ — обычный комментарий.** Его видят все, кто видит страницу или тикет. В GitLab и Redmine ответ на внутреннюю или приватную заметку публикуется открытым комментарием.
- **Расход — организации,** как у любого вопроса.

Поэтому к пространству подключайте только разделы, которые не видят и не комментируют посторонние — клиенты, подрядчики, гости, а пространство с закрытыми документами — HR, юристов — не подключайте там, где страницы и тикеты видят другие отделы.

Подробности по каждой системе — на страницах [Notion](/docs/connector/notion), [Google Диск](/docs/connector/google-drive), [Confluence и Figma](/docs/connector/knowledge), [Трекеры](/docs/connector/trackers), [Jira](/docs/connector/jira).