Запланированные развертывания

Запланированное развертывание (scheduled deployment) позволяет агенту автономно запускать сессии, обеспечивая выполнение задач с предсказуемой периодичностью.

Создание запланированного развертывания

При создании развертывания вы передаете конфигурации сессии, необходимые для выполнения, в дополнение к schedule.

• Развертывания требуют конфигурацию агента и конфигурацию окружения, а также опционально принимают файлы, GitHub, хранилища памяти и хранилища секретов.
• Развертывания также требуют начальное событие user.message, которое запускает работу сессии.
• В schedule вы определяете cron-выражение expression и часовой пояс timezone. Максимальная поддерживаемая гранулярность — на уровне минут.

DEPLOYMENT_ID=$(ant beta:deployments create <<YAML | jq -er '.id'
name: Weekly compliance scan
agent: $AGENT_ID
environment_id: $ENVIRONMENT_ID
initial_events:
  - type: user.message
    content:
      - type: text
        text: Run the weekly compliance scan.
schedule:
  type: cron
  expression: "0 20 * * 5"
  timezone: America/New_York
YAML
)

Ответ включает объект развертывания с заполненным полем schedule.upcoming_runs_at, содержащим время следующих предстоящих срабатываний, чтобы подтвердить, что ваше расписание было установлено правильно.

{
  "id": "depl_01xyz",
  "status": "active",
  "paused_reason": null,
  "schedule": {
    "type": "cron",
    "expression": "0 20 * * 5",
    "timezone": "America/New_York",
    "last_run_at": null,
    "upcoming_runs_at": [
      "2026-05-09T00:00:00Z",
      "2026-05-16T00:00:00Z",
      "2026-05-23T00:00:00Z"
    ]
  }
}

Временные метки предстоящих запусков основаны на точно настроенном расписании. Однако для распределения нагрузки развертывания могут применять джиттер (jitter) до 10 секунд.

Поддерживается максимум 1 000 запланированных развертываний на организацию. Свяжитесь со службой поддержки Anthropic, если вам нужно больше.

Семантика cron и часовых поясов

• Expression: Стандартный POSIX cron (minute hour day-of-month month day-of-week). Вы можете генерировать и проверять эти cron-выражения в Claude Console.
• Timezone: Идентификатор часового пояса IANA (например, "America/Los_Angeles").
• DST: Расписания cron используют буквальное сопоставление по местному времени, поэтому "0 20 * * *" в America/New_York срабатывает в 20
  по местному времени независимо от того, действует EST или EDT.

Запуски развертывания

Развертывания могут не сработать по разным причинам: например, если ресурс environment был архивирован или если создание сессии ограничено по скорости. Каждая попытка выполнения развертывания создает запись запуска развертывания (deployment run), позволяя вам отслеживать успехи и сбои независимо от жизненного цикла сессии.

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

Список всех запусков развертывания для развертывания можно получить следующим образом:

ant beta:deployment-runs list --deployment-id "$DEPLOYMENT_ID"

Вы также можете отфильтровать запуски развертывания с ошибками:

ant beta:deployment-runs list --deployment-id "$DEPLOYMENT_ID" --has-error

Неудачный запуск включает error с полем type, описывающим, почему создание сессии было отклонено (например, environment_archived_error, agent_archived_error или session_rate_limited_error).

{
  "type": "deployment_run",
  "id": "drun_01abc124",
  "deployment_id": "depl_01xyz",
  "trigger_context": { "type": "schedule", "scheduled_at": "2026-05-09T00:00:00Z" },
  "session_id": null,
  "error": {
    "type": "environment_archived_error",
    "message": "environment `env_01abc` is archived"
  },
  "agent": { "type": "agent", "id": "agent_01ghi789", "version": 3 },
  "created_at": "2026-05-09T00:00:01Z"
}

Управление жизненным циклом развертывания

Pause (пауза) подавляет запланированные срабатывания с текущего момента; выполняющиеся сессии от предыдущего запуска развертывания продолжают работать. Ручные запуски через конечную точку run по-прежнему разрешены во время паузы. Приостановка устанавливает paused_reason в значение {"type": "manual"}; снятие паузы очищает его.

ant beta:deployments pause --deployment-id "$DEPLOYMENT_ID"

Unpause (снятие паузы) возобновляет расписание со следующего запланированного момента. Пропущенные срабатывания не выполняются задним числом.

ant beta:deployments unpause --deployment-id "$DEPLOYMENT_ID"

Archive (архивирование), в отличие от pause, является окончательным: расписание завершается, и развертывание не может быть изменено.

ant beta:deployments archive --deployment-id "$DEPLOYMENT_ID"

Поведение при сбоях

Ответы об ограничении скорости при создании сессии немедленно записываются как запуск с ошибкой session_rate_limited_error без повторной попытки; расписание пытается снова в следующий запланированный момент. Ограничения скорости для базовых вызовов API внутри сессии обрабатываются самой сессией.

Если агент развертывания был архивирован или удален, развертывание автоматически архивируется в той же операции; запуск развертывания не записывается. Если субагент, на который ссылается агент, был архивирован, следующее срабатывание записывает неудачный запуск с error.type: "agent_archived_error", и развертывание автоматически приостанавливается, чтобы вы могли обновить агента и возобновить работу.

Запуск вручную

Чтобы запустить развертывание вне его расписания, вызовите конечную точку run. Это немедленно создает сессию и записывает запуск развертывания с trigger_context.type: "manual". Это позволяет вам протестировать развертывание перед тем, как зафиксировать расписание.

ant beta:deployments run --deployment-id "$DEPLOYMENT_ID"