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

> Частые вопросы и что делать, если что-то идёт не так.

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

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

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

## При публикации «нет токена»
Добавьте токен доступа к upstream в [Настройках → Репозитории](/docs/settings). Без него публикация недоступна. Либо подключите репозиторий через [коннектор](/docs/connector) — тогда токен остаётся у вас, в UI его вводить не нужно.

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

## Хотим спрашивать бота прямо в трекере
Поставьте интеграцию своего трекера в коннектор: [Jira, GitLab, GitHub, Gitea, Bitbucket, Redmine](/docs/connector/trackers). Команда пишет вопрос комментарием — ответ приходит туда же, а доступ к трекеру остаётся у вас.

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

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

## Интеграции не запускаются, а git работает
Либо у агента нет привилегий, чтобы поместить интеграцию под отдельного пользователя ОС (нужен root или `CAP_SETUID`), либо на машине нет подходящего Python. Локальная страница агента говорит, что именно из двух — см. [«Установку»](/docs/connector/install#что-нужно-на-машине).

## Задача «застряла» или остановлена
Проверьте статус прогона: возможно, он остановлен — его можно [возобновить](/docs/pipeline/run-control).

## Расхождение при синхронизации
Синхронизация односторонняя (upstream → зеркало). Проверьте состояние веток в разделе [Репозитории](/docs/repositories).

## Нельзя добавить задачу
Если проект ещё готовит [инструменты разработки](/docs/quickstart/devprep), обычные задачи временно скрыты — дождитесь готовности.

## Чем знание отличается от постановки задачи?
Постановка описывает **одну** работу и живёт вместе с ней. Знание — это то, что верно для **всех** работ в проекте или организации: правило, факт или ловушка. Правило, которое вы дописываете в каждую вторую постановку, нужно перенести в [базу знаний](/docs/knowledge) — оно дойдёт до каждого прогона само.

## Почему модель проигнорировала мою запись?
Три обычные причины. **Описание не отвечает на её вопрос** — модель решает по описанию одной строкой, открывать ли тело; перепишите его как «когда эта запись пригодится». **Запись противоречит коду** — модели прямо сказано, что при расхождении верен код. **Запись в архиве** — тогда она до модели не доходит вовсе. Если запись должна соблюдаться всегда, поставьте признак «показывать модели сразу»: модель получит её целиком в каждой задаче — см. [как это доходит до модели](/docs/knowledge/prompt).

## В базе знаний появилась запись, которую я не писал
Её написал ИИ по итогам законченной работы — это [проход извлечения](/docs/knowledge/passes). У каждой записи виден автор: значок ИИ и имя этапа. Такие записи можно править и убирать в архив как любые другие; фильтр «Написано ИИ» показывает их лентой. Правила ИИ не пишет и в область организации не пишет вовсе, а запись с признаком «перманентная» тронуть не может.