Вопросы и устранение неполадок

У нас нет репозитория — Buff нам подходит?

Да. Для отдела без кода есть пространство — рабочее место с вопросами по документам, исследованиями и базой знаний; репозиторий ему не нужен. Дорожка целиком — Buff без репозитория, примеры по отделам — Рецепты по ролям.

Кто может создать пространство и подключить Notion или Google Диск?

Пространство создаёт владелец организации или участник с правом на всю организацию. Подключения к документам делает ваш ИТ-специалист на коннекторе — один раз, для всех отделов. Самому можно поделиться папкой на Диске с учётной записью, которую он назовёт, и подключить интеграцию к разделу в Notion. См. Что попросить у администратора.

Что сделать мне, а что администратору?

Вы: создать или получить пространство, задать вопрос, вести базу знаний отдела, при необходимости поделиться папкой на Диске или подключить интеграцию к страницам Notion. Администратор: поставить коннектор, поставить подключение, указать в нём ваше пространство, отметить разделы и папки, нажать «Проверить связь». Чек-лист для передачи — Что попросить у администратора.

Как спросить по файлу, которого нет в подключённых источниках?

Приложите его к вопросу в «Спросить» — Word, Excel, PowerPoint, PDF или текст, до 10 МБ; агент прочитает содержимое. Скан без текстового слоя прочитать не получится. У исследования вложений нет — файл прикладывается к вопросу или кладётся в подключённую папку. См. Как задать хороший вопрос.

Почему ответ без ссылки или «не нашла»?

Обычно одно из четырёх: нужная папка или раздел не отмечены в подключении; подключение не запущено; у учётной записи, под которой читаются документы, нет доступа к папке; документ — скан без текстового слоя. Ответ без ссылки — повод спросить «по какому документу?». Разбор — Что значит «не нашла».

Сколько стоит вопрос и где это видно?

Оплата — за работу ИИ-агента, в рублях, по объёму прочитанного и написанного; подключение людей — 0 ₽. Стоимость диалога — сумма по всем его вопросам и ответам — видна в шапке диалога, расход организации — в карточке баланса и в истории биллинга у владельца. Ориентировочных цифр мы не называем — зависит от тарифа и от того, сколько документов пришлось прочитать. См. Сколько стоит вопрос.

Видит ли ИИ-агент документы, к которым у меня нет доступа?

Агент читает то, что открыто учётной записи коннектора в отмеченных разделах и папках, — а не то, что открыто лично вам. Поэтому подключайте к пространству отдела только его документы, а доступ к пространству выдавайте тем, кому положено читать эти документы: пространство HR не видит поддержка, пока ей не выдан грант. Вопрос из комментария во внешней системе — исключение: бот ответит любому, кто спросил в отмеченном месте, поэтому подключения с закрытыми документами не открывайте там, где страницы и тикеты видят и комментируют посторонние — клиенты, подрядчики, гости. Личные дела и другие персональные данные не подключать. См. Документы: что уходит, что нет.

Вопрос или исследование — что выбрать?

Ответ уместится на экран и его прочтёте вы сами — «Спросить». Результат будут пересылать, хранить или он должен сверить несколько документов между собой — исследование: второй агент проверит каждое утверждение по источникам. Таблица выбора — Вопрос или исследование?.

Работает ли с CRM, Битрикс24, 1С?

В готовом каталоге их нет — подключаются своим инструментом: ИТ скачивает готовый или пишет сам, добавляет в коннектор, отмечает читающие инструменты, и система доступна агенту сразу, наравне с каталогом. См. Система не из каталога.

Пишет «организация требует единый вход» — как войти?

Ваша организация включила режим «только SSO»: вход по паролю для участников закрыт. Нажмите на экране входа «Войти через SSO компании» и укажите рабочий email или имя организации — дальше вход подтвердит корпоративный провайдер. Подробно — Единый вход.

Не приходит код 2FA

Проверьте папку «Спам» — письма с кодом иногда туда попадают. Можно запросить код повторно.

При публикации «нет токена»

Добавьте токен доступа к upstream в Настройках → Репозитории. Без него публикация недоступна. Либо подключите репозиторий через коннектор — тогда токен остаётся у вас, в UI его вводить не нужно.

Мой git за фаерволом / self-hosted / не хочу отдавать токены

Запустите коннектор — лёгкий агент в вашей сети. Он подключает недоступный из интернета git и переносит репозитории к нам (и pull request'ы обратно), а токен доступа остаётся у вас. Работает и для облачных github.com / gitlab.com / bitbucket.org, если вы не хотите передавать нам токены.

Хотим спрашивать бота прямо в трекере

Поставьте интеграцию своего трекера в коннектор: Jira (Data Center, Server и Cloud), GitLab, GitHub, Gitea и Forgejo, Bitbucket (обращения в pull request), Redmine. Команда пишет вопрос комментарием — ответ приходит туда же, а доступ к трекеру остаётся у вас.

Бот не отвечает на упоминание в трекере

Три обычные причины: репозиторий или проект не входит в область видимости подключения (пустой список означает «нигде»); обращение написано не к боту — проверьте учётную запись и псевдоним; подключение не запущено — посмотрите его статус и журнал на локальной странице агента. Разбор по симптомам — в «Интеграциях с трекерами».

Ответ на вопрос из pull request посчитан «по основной ветке»

Значит, репозиторий не подключён к Buff как источник кода: ветку неоткуда прочитать, и бот об этом честно пишет. Подключите его тем же коннектором, в разделе «Репозитории».

Модель в «Спросить» не видит нашу вики / Notion / документы

Подключение источника должно указывать этот проект (или пространство) как «проект, куда попадает работа» и быть в статусе «работает» — тогда его инструменты появляются у модели в «Спросить» и в глубоком исследовании, в любом проекте. В разработке задач и аудите подключённые системы не читаются. См. Источники знаний и Свои MCP-серверы.

Интеграции не запускаются, а git работает

Либо у агента нет привилегий, чтобы поместить интеграцию под отдельного пользователя ОС (нужен root или CAP_SETUID), либо на машине нет подходящего Python. Локальная страница агента говорит, что именно из двух — см. «Установку».

Задача «застряла» или остановлена

Проверьте статус прогона: возможно, он остановлен — его можно возобновить.

Расхождение при синхронизации

Синхронизация односторонняя (upstream → зеркало). Проверьте состояние веток в разделе Репозитории.

Нельзя добавить задачу

Если проект ещё готовит инструменты разработки, обычные задачи временно скрыты — дождитесь готовности.

Чем знание отличается от постановки задачи?

Постановка описывает одну работу и живёт вместе с ней. Знание — это то, что верно для всех работ в проекте или организации: правило, факт или ловушка. Правило, которое вы дописываете в каждую вторую постановку, нужно перенести в базу знаний — оно дойдёт до каждого прогона само.

Почему модель проигнорировала мою запись?

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

В базе знаний появилась запись, которую я не писал

Её написал ИИ по итогам законченной работы — это проход извлечения. У каждой записи виден автор: значок ИИ и имя этапа. Такие записи можно править и убирать в архив как любые другие; фильтр по автору «ИИ» показывает их лентой. Правила ИИ не пишет и в область организации не пишет вовсе, а запись с признаком «перманентная» тронуть не может.