Перейти к содержимому

Фоновые агенты: задачи без открытого чата

Фоновый агент (background agent) выполняет задачу, пока вы заняты другой работой. Его запускают вручную, по расписанию или по событию: появился pull request, завершилась сборка, поступила заявка. На выходе нужен проверяемый результат и понятный статус, иначе вместо сэкономленного времени появится очередь неизвестно чем закончившихся запусков.

Фоновый режим не обязательно означает облако. Агент может работать на вашей машине или в системе непрерывной интеграции (continuous integration, CI). От места запуска зависит, какие файлы, учётные записи и сетевые ресурсы он увидит.

Выберите задачу, которую можно принять отдельно

Заголовок раздела «Выберите задачу, которую можно принять отдельно»

Хорошие первые задачи: подготовить черновик списка изменений, разобрать падение теста, предложить исправление известного бага, найти устаревшие ссылки. У них есть исходные данные и результат, который можно проверить после завершения.

Плохо подготовленная задача требует решений по ходу работы: какой вариант интерфейса выбрать, кому отправить отчёт, какие данные разрешено удалить. До запуска определите, что агент делает при неопределённости: сохраняет частичный результат, отмечает вопрос и останавливается.

Пример постановки для тестового репозитория:

Разбери падение теста из приложенного лога.
Работай от указанного коммита в отдельной ветке.
Если воспроизводится ошибка продукта, подготовь исправление
и регрессионный тест. Не отключай проверки ради успеха.
Не отправляй изменения и не создавай внешних сообщений.
Лимит: 20 минут, не более двух попыток исправления.
Если не хватает данных или доступа, сохрани причину остановки.
Результат: diff, команды проверок, их исходы и ограничения.

Временной лимит из промпта продублируйте в планировщике или среде выполнения. Инструкция модели сама по себе не останавливает процесс.

У фонового запуска не будет незакоммиченного файла с вашего ноутбука или сервера, случайно оставшегося от вчерашней отладки. Проверьте запуск на чистой копии: установка зависимостей, сборка, тестовые данные, доступные сервисы и путь для результата.

Для параллельных задач выделяйте отдельные рабочие каталоги. Рабочее дерево git (git worktree) позволяет держать несколько веток в разных каталогах одного репозитория. Оно предотвращает смешивание правок, но не изолирует процессы, сеть и секреты. Для этого нужна песочница (sandbox) с настроенными ограничениями.

Проверяйте полномочия всех частей запуска: подготовка среды, команды агента, MCP-подключения и сохранение артефактов могут использовать разные учётные записи. Ключ, нужный только установке зависимостей, не должен автоматически переходить в окружение всех последующих команд.

Разделите подготовку результата и внешнее действие

Заголовок раздела «Разделите подготовку результата и внешнее действие»

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

Действие Техническое ограничение
Читать задачи из трекера Учётная запись только для нужного проекта и операций чтения
Менять код Отдельная рабочая копия и ограниченные каталоги
Публиковать изменения Отдельные права на ветку; запрет слияния без обязательных проверок
Работать с данными Тестовая база и искусственные записи
Отправлять уведомления Разрешённые получатели и проверка содержимого перед отправкой

Неинтерактивный запуск не может рассчитывать, что человек немедленно ответит на запрос разрешения. Заранее задайте поведение при блокировке; отключение всех подтверждений ради завершения задачи скрывает проблему с правами.

Ограничьте повторы и сохраните состояние

Заголовок раздела «Ограничьте повторы и сохраните состояние»

Событие может прийти дважды, а процесс оборваться после внешнего действия, но до записи об успехе. Для таких случаев нужна идемпотентность (idempotency): повтор одного задания не создаёт второй тикет, комментарий или платёж.

Назначайте запуску ключ из идентификатора события и версии входных данных. Перед повтором проверяйте, существует ли результат с этим ключом. Если сервер принял запрос, но ответ потерян, сначала выясните состояние операции; слепой повтор опасен.

Установите общий лимит времени, числа повторов и расходов, а также ограничение одновременных запусков. Сохраняйте статус «выполнено», «не выполнено» или «нужно решение человека» вместе с причиной. Завершение процесса с нулевым кодом ещё не доказывает, что задача принята: проверка результата остаётся отдельным шагом.

Для локальной автоматизации есть, например, codex exec: команда запускает агента из скрипта без интерактивного интерфейса. Для облачных сценариев Cursor Automations поддерживает расписания и события. Это разные среды; перенесённый промпт не переносит их права и настройки.

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

Автор учебника: Шахматов Алексей