Перейти к содержанию

Политики write-back и approvals

Результат

Вы настроите, когда Threadory может писать во внешнюю систему автоматически, когда требуется решение человека и сколько предложений связей попадает в очередь approvals.

Что потребуется

  • Роль проекта Admin или Owner для изменения настроек и решения approvals.
  • Проверенное подключение к целевой системе до включения write-back.
  • Согласованный с владельцами очереди процесс approval.

Настроить review и reply

  1. Откройте Settings → Review.
  2. Переключателем Enable ticket / issue review управляйте автоматическим triage-комментарием для новых и обновлённых tickets и GitLab issues.
  3. Переключателем Reply to human follow-ups управляйте одним ответом bot человеку, который написал под review.
  4. Не включайте Auto-post reviews & replies (skip approval), пока сценарий не проверен в безопасном проекте.
  5. Нажмите Save.

При выключенном auto-post предложения review и reply ожидают администратора или владельца в Approvals. Включение auto-post требует подтверждения, потому что поддерживаемые skills смогут публиковать без предварительного approval.

Настроить выборочный контроль auto-post

  1. Включайте Auto-post reviews & replies (skip approval) только после проверки характерных одобренных и отклонённых предложений.

  2. Установите Auto-post audit rate:

  3. 0% — auto-post не выбираются для проверки качества;

  4. 100% — проверяется каждый auto-post, что практически соответствует полному ручному контролю качества;

  5. промежуточное значение — проверяется указанная доля публикаций.

  6. Нажмите Save.

  7. Во время пробного периода следите за Approvals, Activity и внешней системой.

Выбранная в audit sample публикация отправляется в Approvals вместо auto-post. Для этого sample approval блокирует публикацию заранее; остальные публикации по-прежнему отправляются автоматически.

Настроить approvals для найденных связей

Link Resolver ищет вероятные связи между источниками. Его параметры находятся в расширенных настройках.

  1. Откройте Settings → Advanced / Operator → Link Resolver.
  2. В Daily approval budget укажите максимальное число medium-confidence-предложений, которые могут попасть в Approvals за день.
  3. В Approval confidence threshold укажите значение от 0 до 1.
  4. Нажмите Save settings.
  5. Используйте Run now только для осознанного admin-triggered сканирования.

Граничное поведение:

  • daily budget 0 отбрасывает все medium-confidence-предложения вместо отправки в Approvals;
  • threshold 1.0 оставляет только автоматическое сохранение high-confidence-связей и не отправляет medium-confidence-связи на проверку;
  • понижение threshold увеличивает число пограничных предложений для человека;
  • low-confidence-предложения отбрасываются.

Безопасно применить рискованные policy changes

Auto-post может публиковать внешние comments без предварительного approval. Run now немедленно запускает scan. Daily approval budget 0 отбрасывает medium-confidence proposals вместо сохранения для последующего review.

  1. Запишите текущие settings и identity connector.
  2. Используйте safe project или quiet change window и не создавайте посторонние source events во время изменения policy.
  3. Измените один control, сохраните и создайте одно low-risk test event.
  4. Проверьте Activity, Approvals и внешнюю систему до возобновления triggers.

Выключение auto-post предотвращает будущие automatic publications, но не отзывает уже опубликованные comments. Для восстановления неверной конфигурации верните записанное setting; внешнюю запись исправляйте или удаляйте в source system по её policy. После исправления budget или threshold выполните новый осознанный scan: не считайте, что отброшенные proposals появятся автоматически.

Как проверить политику

  1. Создайте одно безопасное тестовое событие во внешней системе.

  2. В Activity убедитесь, что запустился ожидаемый skill.

  3. Проверьте выбранный путь:

  4. manual policy: в Approvals появилось pending-предложение, а до одобрения внешней записи нет;

  5. auto-post policy: внешний комментарий опубликован, а sample соответствует audit rate;

  6. link policy: medium-confidence-предложения соблюдают threshold и daily budget.

  7. Проверяйте source context и внешний результат, а не только статус run.

Частые проблемы

Симптом Вероятная причина Что сделать
Review опубликован без pending approval В проекте включён auto-post Выключите его, сохраните и проверьте последние runs
При auto-post появилось approval Публикация попала в audit sample или другой skill всегда требует approval Проверьте тип approval и текущий audit rate
Предложения связей не появляются Daily budget равен 0, threshold слишком высок или кандидатов нет Проверьте настройки Link Resolver и последний run
Слишком много слабых предложений Confidence threshold слишком низок Повышайте его постепенно и сравнивайте acceptance rate
Member не может решить approval Решение доступно только admin и owner Назначьте владельца очереди среди администраторов
Одобренная запись завершилась ошибкой Внешняя система отклонила действие или credential изменился Проверьте Activity, identity и permissions connector

Следующий шаг

Настройте бюджеты и модели, затем контролируйте изменения через audit log.