Buff Development

Что попросить у администратора

Чек-лист для ИТ: коннектор, подключение к документам, пространство как место работы, разделы и папки, проверка связи; система не из каталога.

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

Чек-лист

Скопируйте, заполните пропуски и отправьте в ИТ.

  1. Коннектор установлен — на машине в сети компании, у которой есть доступ к документам и исходящий доступ в интернет; для Figma без списка файлов и проектов — ещё входящий доступ из интернета к приёмнику событий. Один коннектор обслуживает все отделы; если он уже стоит для другого отдела или для разработки, ставить второй не нужно. → Установка
  2. Нужное подключение поставлено из каталога — ___ (Notion / Confluence / Google Диск / файлы на сервере и сетевые папки / Figma / трекер / интернет). → Каталог, страницы источников: Notion, Google Диск, Файлы на диске, Confluence и Figma, Трекеры, Интернет
  3. В подключении указано пространство — в поле «Проект разработки» подключения стоит имя пространства ___ (да, поле называется так — в него вписывается и пространство). Без этого ИИ-агент в пространстве инструментов подключения не увидит. → Инструменты и модель
  4. Отмечены разделы и папки — корни подключения: ссылки на страницы Notion ___, ключи пространств Confluence ___, папки на Диске ___, пути на сервере ___, файлы или проекты Figma ___ (если оставить пусто — приёмник событий коннектора должен быть доступен из интернета и в Figma заведён вебхук FILE_COMMENT, иначе вопросы в комментариях к макетам не дойдут); исключения — папки, которые читать нельзя (личные дела, архив). У трекеров пустой список означает «нигде», у Notion, Confluence, Google Диска, Figma и файлов — «всё, что открыто учётной записи»; отметить разделы явно надёжнее в любом случае. → Область видимости
  5. «Проверить связь» пройдена — проверка отвечает не «ок», а тем, кто вошёл и сколько отмеченных разделов реально доступно; подключение в статусе «работает». → Управление

Что подготовить со своей стороны: где лежат документы (адреса разделов, папки), имя пространства, кому из отдела нужен доступ и с какой ролью (см. Роли).

Что сделать самому, без ИТ

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

Система не из каталога

CRM (Битрикс24, amoCRM), 1С, helpdesk, мессенджер, SharePoint, кадровая система — в готовом каталоге их нет, и это не значит «не поддерживается». Своя система подключается собственным инструментом — своим MCP-сервером (MCP — стандартный способ подключить программу к ИИ-агенту; это работа ИТ): ИТ скачивает готовый (сервер вендора или из открытого репозитория) или пишет сам, добавляет его в коннектор, отмечает инструменты, которые только читают, — и система доступна ИИ-агенту сразу, наравне с каталогом, в каждом вопросе и исследовании пространства.

Два отличия от каталога стоит знать: такой инструмент даёт ИИ-агенту только чтение из приложения — обращений комментарием из самой системы у него нет; и его код не проверялся Buff, поэтому ИТ подтверждает установку явно.

Если после подключения ответ «не нашла»

Три обычные причины — папка не отмечена корнем, подключение не запущено, у учётной записи нет доступа к папке — разобраны на странице Как задать хороший вопрос. Статус и последнюю ошибку каждого подключения видно в разделе «Коннекторы» приложения.

On this page