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

> Дорожка для отдела без кода: аккаунт и организация, пространство, документы отдела, первый вопрос, исследование и первая запись в базе знаний.

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

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

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

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

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

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

**Пространство** — рабочее место без кода: «Спросить», глубокое исследование, база знаний и подключения к документам. Создаётся по одному имени — [как именно](/docs/quickstart/space).

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

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

_Иллюстрация: Одно поле — имя. Пространство появляется сразу и открывается на «Спросить»._

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

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

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

1. ставит [коннектор](/docs/connector) — небольшую программу в сети компании; один коннектор обслуживает все отделы;
2. ставит нужное подключение [из каталога](/docs/connector/marketplace) — [Notion](/docs/connector/notion), [Confluence](/docs/connector/knowledge), [Google Диск](/docs/connector/google-drive), [файлы на сервере и сетевые папки](/docs/connector/files), [Figma](/docs/connector/knowledge), [трекер](/docs/connector/trackers), [интернет](/docs/connector/web) — или [свой инструмент](/docs/connector/custom-mcp) для системы, которой в каталоге нет;
3. указывает в подключении **ваше пространство** как место, куда попадает работа;
4. отмечает **разделы и папки**, которые можно читать.

Что ему передать, пункт за пунктом, — [Что попросить у администратора](/docs/for-admin).

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

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

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

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

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

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

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

_Иллюстрация: Пространство в меню слева: только «Спросить», «Глубокое исследование», «Коннекторы» и «База знаний». Ответ собран по четырём документам компании — с названиями файлов и разделов._

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

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

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

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

| Тип | Пример |
| --- | --- |
| **Правило** (пишет человек) | «Отвечаем клиенту в течение рабочего дня» |
| **Факт** | «Актуальный прайс — в папке Продажи/Прайсы» |
| **Ловушка** | «Регламент закупок 2024 устарел — смотреть редакцию 2026» |

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

## Дальше

- [Рецепты по ролям](/docs/roles) — что подключить и о чём спрашивать поддержке, продажам, юристам, HR, финансам, маркетингу, руководителю и продакту.
- [Спросить прямо в Notion, Google Документе или трекере](/docs/ask-from-your-tools) — без открытия приложения.
- [Сколько стоит вопрос](/docs/cost-of-a-question) — из чего складывается цена и где её видно.
- [Безопасность: что уходит, что нет](/docs/security#документы-что-уходит-что-нет) — для владельца документов.