api ·14 июня 2026 ·6 мин

Claude Managed Agents API: cron-расписания и Vault для секретов — как запустить в 2026

Кратко

9 июня 2026 года Anthropic добавила в Managed Agents API два инструмента: cron-расписания для автономного запуска агентов и vault-хранилище для секретов, при котором модель никогда не видит реальные ключи API. Оба инструмента доступны в публичной бете через заголовок managed-agents-2026-04-01 и открывают возможность запускать production-агентов без внешней инфраструктуры планировщика.

Что такое Claude Managed Agents API

Claude Managed Agents API — это примитив Anthropic, позволяющий развернуть постоянно работающего AI-агента с заданными инструментами, разрешениями и памятью, при этом всю инфраструктуру (состояние сессии, контекстное окно, жизненный цикл задачи) берёт на себя Anthropic, а не разработчик.

Почему это важно для разработчиков в РФ

До этих изменений запуск периодических AI-агентов в production требовал двух слоёв собственной инфраструктуры: внешнего планировщика (cron на сервере, Cloud Functions, Airflow) и системы управления секретами (Vault, AWS Secrets Manager, вручную зашитые ключи). Обе задачи порождают операционный overhead и точки отказа.

Теперь Anthropic берёт эти слои на себя. Разработчик определяет задачу и расписание — платформа обеспечивает исполнение. Для команд в России, использующих Claude API через kosareva.cloud (доступ к зарубежным моделям за рубли без VPN), это означает меньше инфраструктуры, которую нужно поддерживать самостоятельно.

Экономия на инфраструктуре

По данным ChatForest, переход на Managed Agents с cron-расписанием убирает минимум два слоя: планировщик и систему инжекции секретов. Это особенно ценно для небольших команд, где каждый дополнительный сервис — это отдельная ответственность.

Безопасность ключей API

Vault-переменные решают реальную проблему: раньше API-ключи нужно было передавать в system prompt или переменные окружения, которые модель могла «видеть» и случайно вывести в ответе или в результате prompt injection. Новая механика исключает это структурно.

Как это работает

Scheduled Deployments: агент по расписанию

Scheduled deployment — это managed agent deployment, который запускается автоматически по cron-выражению. Каждый запуск создаёт новую сессию с нуля; когда задача выполнена, сессия закрывается. Между запусками никакой открытой сессии нет.

Для создания агента POST-запрос на /v1/agents:

import anthropic

client = anthropic.Anthropic(
    api_key="sk-ant-...",
    default_headers={"anthropic-beta": "managed-agents-2026-04-01"}
)

agent = client.beta.agents.create(
    name="weekly-digest-agent",
    model="claude-opus-4-7-20260416",
    system_prompt="Ты аналитик. Каждую неделю собирай дайджест новостей по AI API.",
    tools=["web_search", "file_writer"],
    task_budget={"max_tokens": 50000}
)
print(agent.id)  # "agt_01XYZ..."

Затем создаём расписание:

schedule = client.beta.agents.schedules.create(
    agent_id=agent.id,
    cron="0 9 * * 1",   # каждый понедельник в 09:00 UTC
    task="Собери дайджест новостей AI API за прошедшую неделю и сохрани в файл."
)
print(schedule.id)  # "sch_01ABC..."

Управление расписанием через API:

# Пауза расписания
curl -X POST https://api.anthropic.com/v1/agents/agt_01XYZ/schedules/sch_01ABC/pause \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01"

# Ручной запуск вне расписания (для тестирования)
curl -X POST https://api.anthropic.com/v1/agents/agt_01XYZ/schedules/sch_01ABC/trigger \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Vault Credentials: секреты без утечек

Vault — это именованное хранилище учётных данных для одного пользователя. Механика работы в два шага:

Секрет сохраняется в vault → в конфигурации деплоя хранится только ID ссылки, а не сам секрет.
При запуске сессии → сэндбокс получает placeholder-значение → реальный ключ подставляется на сетевой границе перед отправкой запроса наружу. Модель видит placeholder, который не работает вне авторизованного контекста.

Пример создания vault и добавления переменной окружения:

import anthropic

client = anthropic.Anthropic(
    api_key="sk-ant-...",
    default_headers={"anthropic-beta": "managed-agents-2026-04-01"}
)

# Создаём vault для пользователя
vault = client.beta.vaults.create(
    display_name="Alice",
    metadata={"external_user_id": "usr_abc123"}
)
print(vault.id)  # "vlt_01ABC..."

# Добавляем API-ключ как переменную окружения
env_credential = client.beta.vaults.credentials.create(
    vault_id=vault.id,
    auth={
        "type": "environment_variable",
        "secret_name": "NOTION_API_KEY",
        "secret_value": "sk-your-notion-secret",
        "networking": {
            "type": "limited",
            "allowed_hosts": ["api.notion.com"]  # ограничиваем область применения
        }
    },
    display_name="Notion API key for agent sandbox"
)

Затем при создании сессии передаём vault_id:

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    vault_ids=[vault.id],
    title="Alice's weekly Notion digest"
)

Сравнение: до и после 9 июня 2026

Аспект	До (старая схема)	После (Managed Agents)
Планировщик запусков	Собственный cron / Cloud Functions	Встроенный в платформу
Управление секретами	Vault-сервис или system prompt	Vault API Anthropic, инжекция на сетевой границе
Безопасность ключей	Модель видит ключ	Модель видит только placeholder
Инфраструктура разработчика	Планировщик + секрет-стор + мониторинг	POST-запрос + cron-выражение
Событийные триггеры	Да (через очереди)	Нет (только time-based)

Практические шаги: запуск агента с расписанием

Получите API-ключ Anthropic. Из России доступ к Claude API без VPN доступен через kosareva.cloud — оплата в рублях, ключ работает сразу.
Установите SDK: pip install anthropic. Убедитесь, что версия не ниже той, что поддерживает beta-заголовок managed-agents-2026-04-01.
Создайте агента через client.beta.agents.create() с указанием модели, system prompt и списка инструментов.
Создайте vault и добавьте credential для каждого внешнего сервиса, который использует агент (Notion, Slack, Ramp, Sentry, Browserbase).
Задайте расписание через client.beta.agents.schedules.create() с cron-выражением и текстом задачи.
Протестируйте ручным запуском через endpoint /trigger до того, как расписание сработает в production.
Настройте мониторинг: подпишитесь на webhooks событий сессии (доступны в public beta) для алертов на ошибки выполнения.

FAQ

Можно ли использовать Managed Agents API из России без VPN?
Да. Через kosareva.cloud доступен OpenAI-совместимый прокси к моделям Anthropic. API-ключ работает из РФ, оплата в рублях, без необходимости VPN.

Какие модели поддерживает Managed Agents API?
По документации на июнь 2026 поддерживаются claude-opus-4-7, claude-sonnet-4-6 и claude-haiku-4-5. Claude Fable 5 временно приостановлен по требованию регулятора.

Чем vault-переменные окружения отличаются от обычных env vars?
Обычные env vars модель может прочитать и вывести в ответе. Vault env vars заменяются на placeholder внутри сэндбокса — реальное значение подставляется только на сетевой границе при исходящем запросе.

Поддерживаются ли событийные триггеры в Managed Agents?
Список расписаний поддерживает только time-based cron. Для событийных триггеров (webhook, upload) по-прежнему нужна внешняя система, которая вызывает endpoint /trigger вручную.

Сколько credentials можно хранить в одном vault?
Максимум 20 учётных данных на vault. Ключи (mcp_server_url, secret_name) должны быть уникальными — дубликат вернёт ошибку 409.

Хотите подключить Claude Managed Agents API к вашему продукту из России?
На kosareva.cloud можно получить доступ к API Anthropic и других зарубежных моделей без VPN, с оплатой в рублях и технической поддержкой на русском языке. Оставьте заявку — поможем настроить интеграцию и запустить агентов в production.