Buff без репозитория: с чего начать

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

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

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

1. Аккаунт и организация

Зарегистрируйтесь и войдите — Регистрация и вход. Если у компании уже есть организация в Buff, регистрируйтесь и попросите владельца пригласить вас: он выдаст роль и область — обычно участника (в интерфейсе — Contributor) на ваше пространство (см. Управление участниками). Если организации ещё нет, создайте её — Организации.

2. Пространство

Пространство — рабочее место без кода: «Спросить», глубокое исследование, база знаний и подключения к документам. Создаётся по одному имени — как именно.

Создать пространство может владелец организации или участник, которому выдано право создавать проекты и пространства на всю организацию (в интерфейсе это право называется «Добавлять репозитории и синхронизировать проект» — да, пространства создаются им же). Если у вас такого права нет, попросите владельца создать пространство или выдать право.

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

3. Документы отдела

Документы остаются там, где лежат: в Notion, Confluence, на Google Диске, на сервере или в сетевой папке, в Figma. Ничего не копируется заранее — ИИ-агент читает только то, что понадобилось для ответа.

Что делает ваш ИТ-специалист один раз:

1. ставит коннектор — небольшую программу в сети компании; один коннектор обслуживает все отделы;
2. ставит нужное подключение из каталога — Notion, Confluence, Google Диск, файлы на сервере и сетевые папки, Figma, трекер, интернет — или свой инструмент для системы, которой в каталоге нет;
3. указывает в подключении ваше пространство как место, куда попадает работа;
4. отмечает разделы и папки, которые можно читать.

Что ему передать, пункт за пунктом, — Что попросить у администратора.

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

• на Google Диске — поделиться папкой с учётной записью, адрес которой назовёт ИТ, с правом «Комментатор»;
• в Notion — подключить интеграцию к разделу: на корневой странице раздела меню «…» → «Подключения» → выбрать интеграцию; всё вложенное откроется вместе с ней.

Что читается: документы Word, Excel, PowerPoint (новые и старые форматы), PDF с текстовым слоем, текстовые файлы; документы, таблицы (лист и диапазон) и презентации Google; страницы и базы данных Notion; страницы Confluence; параметры макетов Figma. Не читаются сканы без текстового слоя и картинки: распознавания текста нет.

4. Первый вопрос

Откройте пространство → «Спросить» → новый вопрос. Назовите документ, раздел или период, если знаете, и скажите, в каком виде нужен ответ. Примеры:

• «Какой срок первой реакции обещан клиенту на тарифе «Бизнес» по договору и совпадает ли он с FAQ?»
• «Как оформить отпуск и за сколько дней подать заявление?»
• «Какие платежи поставщикам приходятся на октябрь и где предоплата?»

Ответ придёт со ссылкой на документ и раздел; расхождения между документами будут названы. Файл, которого нет в источниках, приложите к вопросу — до 10 МБ. Если ответ «не нашла» — на странице Как задать хороший вопрос разобрано, что это значит.

5. Исследование

Когда нужен не ответ, а документ — свести несколько источников, найти все расхождения, подготовить то, что будут пересылать, — закажите глубокое исследование. Две роли ИИ-агента: аналитик пишет, проверяющий сверяет каждое утверждение с источниками. На выходе — документ со ссылками и названными расхождениями, выгрузка в PDF и текстовый файл. Чем это отличается от вопроса и когда что выбирать — Вопрос или исследование?.

6. Первая запись в базе знаний

База знаний — правила, факты и ловушки отдела; ИИ-агент видит их в каждом вопросе и исследовании. Заведите одну-две записи с областью «пространство»:

Писать в базу может участник с правом «Создавать, изменять, архивировать и восстанавливать знания» — по умолчанию у редактора пространства (в интерфейсе — Maintainer); читать — все участники пространства. Факты и ловушки ИИ-агент дописывает и сам, с пометкой, — Записи ИИ.

Дальше

• Рецепты по ролям — что подключить и о чём спрашивать поддержке, продажам, юристам, HR, финансам, маркетингу, руководителю и продакту.
• Спросить прямо в Notion, Google Документе или трекере — без открытия приложения.
• Сколько стоит вопрос — из чего складывается цена и где её видно.
• Безопасность: что уходит, что нет — для владельца документов.