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

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

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

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

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

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

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

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

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

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

Поставьте интеграцию своего трекера в коннектор: Jira, GitLab, GitHub, Gitea, Bitbucket, Redmine. Команда пишет вопрос комментарием — ответ приходит туда же, а доступ к трекеру остаётся у вас.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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