Документация

Автоматизации

Работа, которая запускается без необходимости каждый раз просить об этом, по расписанию или при возникновении определённых событий, а также место её поиска.

Каждая автоматизация начинает выполнение без дополнительных запросов от пользователей. Она запускается по расписанию или при возникновении определённых событий: открытии pull request, создании задачи, сбое проверки или развертывания.

Все автоматизации перечислены в разделе Factory под названием «Автоматизации» — там указано, что их запускает и что они делают. Создать автоматизацию можно в разделе «Новая работа»: выберите тип «Автоматизация», укажите время её запуска и действия, которые она должна выполнять, собственными словами.

  • РасписаниеВремя
  • Автоматизация событийПроисходит некое событие.

Обычная задача

Техническое задание, план, разработка, проверка, рецензирование. Использует слот агента; задайте ему более низкий приоритет.

P2P3

Запрос на объединение pull request

Оно не может самостоятельно объединить изменения или внести их в вашу базовую ветку.

Вы утверждаете

Автоматизация отличается лишь триггером. Она открывает обычную задачу по стандартному пути, используя реальные ресурсы и завершаясь созданием pull request, которую вы утверждаете.

Два типа триггеров

ТриггерЗапускиПример
РасписаниеКаждые несколько часов, ежедневно, еженедельно или ежемесячноЗапрашивайте у Sentry новые ошибки каждый час и создавайте задачу для каждой из них.
Возникает событиеКогда GitHub или Coroid отправляют соответствующее событиеЕсли задача завершается с ошибкой, система определяет причину и создаёт задачу для её исправления.

Используйте расписание, когда триггером является время, или когда нужный объект находится в другой системе, которая не отправляет события Coroid, например Sentry или Jira. Расписание запрашивает данные из этой системы через ваши настройки. Серверы MCP и создаёт задачи на основе найденных данных. См. Расписания.

Используйте триггер события, когда Coroid может сообщить о событии мгновенно. Такой подход экономит ресурсы по сравнению с расписанием, которое постоянно запрашивает данные.

События, которые можно выбрать в разделе «Новая работа»

От GitHub, для чего требуется GitHub App:

  • открытие, обновление или слияние pull request
  • создание задачи
  • упоминание Coroid в комментарии; учитывается только если автор имеет права на запись в репозиторий

От Coroid:

  • сбой задачи, плана, проверки качества, развертывания или проверки состояния развертывания
  • успешное развертывание
  • откат релиза

Для событий из собственных систем требуется учётная запись службы, а для событий Slack, Telegram и Jira — фильтр: измените параметры события автоматизации в её редакторе. См. Хуки.

Что она делает

Агент следует вашим инструкциям. Он может читать код проекта и создавать задачи, но ничего не меняет напрямую. Созданные им задачи проходят тот же путь спецификации, планирования, сборки, проверки и рецензирования, что и все остальные, и в итоге попадают на утверждение в pull request.

По расписанию автоматизация также может запускать браузерные тесты на тестовой среде.

Готовые автоматизации, созданные Coroid для вас, представляют собой переключатели в разделе Quality Control, а не элементы, которые создаются в «Новая работа»:

  • Рецензирование пулл-реквестов. Раздел Quality Control Пулл-реквесты группа запускает проверки проекта для каждого pull request (Coroid Quality Control) и добавляет комментарий Coroid Review.
  • Преобразование сообщений и задач в запросы. Сообщения в Slack и Telegram, комментарии GitHub с упоминанием Coroid и новые задачи в Jira превращаются в запросы, если соответствующие опции включены в Quality Control в разделе «Перед началом работы». См. Системы отслеживания задач для Jira.
  • Обработка сбоев. Сбой задачи, сбой развертывания или откат релиза имеют соответствующий переключатель в разделе Когда что-то идёт не так.
  • Устранение существующего технического долга. Проект Еженедельная очистка технического долга — это переключатель в строке «Против засорения».

На странице автоматизации в разделе Factory указано, что она управляется переключателем, и есть ссылка на этот переключатель. Вы можете приостановить или отключить автоматизацию; изменив её инструкции, вы сделаете её своей после подтверждения.

Ранее созданные автоматизации, создающие запросы, продолжают работать и перечислены в разделе «Автоматизации». Автоматизации, рецензирующие пулл-реквесты, были приостановлены после того, как Quality Control взяла на себя функции Coroid Review.

Шаблоны «Новая работа»

Ранее в «Новая работа» были доступны шаблоны. Их функции перешли к вышеупомянутым переключателям; два шаблона для отправки сообщений в Slack можно настроить самостоятельно, указав канал. Отправка осуществляется через Сервер MCP который вы подключаете в разделе «Настройки» в категории «Подключения»: его может использовать расписание, а также автоматизация с событием после разрешения использования инструментов MCP в редакторе автоматизации в разделе Factory. Автоматизации, созданные из шаблонов, продолжают работать в прежнем виде. Старая ссылка на шаблон ведёт либо на соответствующий переключатель, либо в «Новая работа».

Отслеживание автоматизации

Откройте автоматизацию в разделе Factory, чтобы увидеть каждый запуск: когда он произошёл, сколько ресурсов затратил, какие задачи создал и почему запуск не завершился. Владельцы и администраторы могут приостановить, протестировать, отредактировать или удалить автоматизацию. Все сотрудники организации могут видеть автоматизации и их запуски.

Поддержание полезности автоматизаций

Задачи, созданные автоматизацией, конкурируют за те же слоты агентов, что и всё остальное. Часто срабатывающая автоматизация может незаметно исчерпать ваш ресурс.

  1. Установите для неё более низкий приоритет, чем для задач, запрошенных людьми. P2 или P3.
  2. Сделайте триггер более конкретным. Сообщение «Проверка завершилась неудачно» постоянно появляется в загруженном репозитории. Сообщение «Эта проверка завершилась неудачно в базовой ветке» возникает, когда действительно есть ошибка.
  3. Посмотрите, что она создала. Если автоматизация создала двадцать задач, а вы объединили лишь две, это приводит к лишнему шуму и затратам, а не к ценности.

Честная мера эффективности автоматизации — это доля открытых ею задач, которые были объединены, а не частота её срабатывания.

Sentinel

В более ранних версиях этих документов описывался Sentinel — монитор, отслеживающий определённые условия. Это не отдельная функция. Условие — это либо событие, на которое может реагировать автоматизация, либо параметр, проверяемый расписанием.