Loading...
    • Разработка
    • Администрирование
    • Модели и цены
    • Клиентские SDK
    • Справочник API
    Search...
    ⌘K
    Первые шаги
    Введение в ClaudeБыстрый старт
    Разработка с Claude
    Обзор возможностейИспользование Messages APIОбработка причин остановки
    Возможности модели
    Расширенное мышлениеАдаптивное мышлениеУсилиеБыстрый режим (бета: предварительный просмотр)Структурированные выходные данныеЦитированияПотоковые сообщенияПакетная обработкаРезультаты поискаПотоковые отказыМногоязычная поддержкаЭмбеддинги
    Инструменты
    ОбзорКак работает использование инструментовИнструмент веб-поискаИнструмент веб-загрузкиИнструмент выполнения кодаИнструмент памятиИнструмент BashИнструмент управления компьютеромИнструмент текстового редактора
    Инфраструктура инструментов
    Поиск инструментовПрограммный вызов инструментовДетальная потоковая передача инструментов
    Управление контекстом
    Контекстные окнаСжатиеРедактирование контекстаКэширование промптовПодсчёт токенов
    Работа с файлами
    Files APIПоддержка PDFИзображения и зрение
    Навыки
    ОбзорБыстрый стартЛучшие практикиНавыки для предприятийНавыки в API
    MCP
    Удалённые MCP-серверыMCP-коннектор
    Инжиниринг промптов
    ОбзорЛучшие практики промптингаИнструменты промптинга в Console
    Тестирование и оценка
    Определение успеха и создание оценокИспользование инструмента оценки в ConsoleСнижение задержки
    Укрепление ограничений
    Снижение галлюцинацийПовышение согласованности выводаЗащита от джейлбрейковСнижение утечки промптов
    Ресурсы
    Глоссарий
    Примечания к выпуску
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Делегирование работы агенту

    Запуск сеанса

    Создайте сеанс для запуска вашего агента и начните выполнение задач.

    Сеанс — это работающий экземпляр агента в окружении. Каждый сеанс ссылается на агента и окружение (оба созданы отдельно) и поддерживает историю разговора на протяжении нескольких взаимодействий.

    Все запросы Managed Agents API требуют заголовка бета-версии managed-agents-2026-04-01. SDK автоматически устанавливает заголовок бета-версии.

    Создание сеанса

    Сеанс требует ID agent и ID environment. Агенты — это версионируемые ресурсы; передача ID agent в виде строки запускает сеанс с последней версией агента.

    Was this page helpful?

    • Создание сеанса
    • Аутентификация MCP через хранилища
    • Запуск сеанса
    • Статусы сеанса
    • Другие операции сеанса
    • Получение сеанса
    • Список сеансов
    • Архивирование сеанса
    • Удаление сеанса
    session=$(curl -fsSL https://api.anthropic.com/v1/sessions \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01" \
      -H "content-type: application/json" \
      -d @- <<EOF
    {
      "agent": "$AGENT_ID",
      "environment_id": "$ENVIRONMENT_ID"
    }
    EOF
    )
    SESSION_ID=$(jq -r '.id' <<< "$session")

    Чтобы привязать сеанс к определённой версии агента, передайте объект. Это позволяет вам контролировать точно, какая версия запускается, и поэтапно развёртывать новые версии независимо.

    pinned_session=$(curl -fsSL https://api.anthropic.com/v1/sessions \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01" \
      -H "content-type: application/json" \
      -d @- <<EOF
    {
      "agent": {"type": "agent", "id": "$AGENT_ID", "version": 1},
      "environment_id": "$ENVIRONMENT_ID"
    }
    EOF
    )
    PINNED_SESSION_ID=$(jq -r '.id' <<< "$pinned_session")

    Агент определяет, как Claude ведёт себя в сеансе, включая модель, системный запрос, инструменты и серверы MCP. Подробнее см. Настройка агента.

    Аутентификация MCP через хранилища

    Если ваш агент использует инструменты MCP, требующие аутентификации, передайте vault_ids при создании сеанса для ссылки на хранилище, содержащее сохранённые учётные данные OAuth. Anthropic управляет обновлением токенов от вашего имени. Подробнее см. Аутентификация с помощью хранилищ о том, как создавать хранилища и регистрировать учётные данные.

    vault_session=$(curl -fsSL https://api.anthropic.com/v1/sessions \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01" \
      -H "content-type: application/json" \
      -d @- <<EOF
    {
      "agent": "$AGENT_ID",
      "environment_id": "$ENVIRONMENT_ID",
      "vault_ids": ["$VAULT_ID"]
    }
    EOF
    )
    VAULT_SESSION_ID=$(jq -r '.id' <<< "$vault_session")

    Запуск сеанса

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

    curl -fsSL "https://api.anthropic.com/v1/sessions/$SESSION_ID/events" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01" \
      -H "content-type: application/json" \
      -d @- <<'EOF'
    {
      "events": [
        {
          "type": "user.message",
          "content": [{"type": "text", "text": "List the files in the working directory."}]
        }
      ]
    }
    EOF

    Подробнее см. События и потоковая передача о том, как передавать ответы агента потоком и обрабатывать подтверждения инструментов.

    Статусы сеанса

    Сеансы проходят через эти статусы:

    СтатусОписание
    idleАгент ожидает ввода, включая сообщения пользователя или подтверждения инструментов. Сеансы начинаются в idle.
    runningАгент активно выполняется
    reschedulingПроизошла временная ошибка, автоматический повтор
    terminatedСеанс завершился из-за неустранимой ошибки

    Другие операции сеанса

    Получение сеанса

    retrieved=$(curl -fsSL "https://api.anthropic.com/v1/sessions/$SESSION_ID" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01")
    echo "Status: $(jq -r '.status' <<< "$retrieved")"

    Список сеансов

    curl -fsSL https://api.anthropic.com/v1/sessions \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01" \
      | jq -r '.data[] | "\(.id): \(.status)"'

    Архивирование сеанса

    Архивируйте сеанс, чтобы предотвратить отправку новых событий при сохранении его истории:

    curl -fsSL -X POST "https://api.anthropic.com/v1/sessions/$SESSION_ID/archive" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01"

    Удаление сеанса

    Удалите сеанс, чтобы навсегда удалить его запись, события и связанный контейнер. Сеанс в статусе running не может быть удалён; отправьте событие прерывания, если вам нужно удалить его немедленно.

    Файлы, хранилища памяти, окружения и агенты — это независимые ресурсы и не затрагиваются удалением сеанса.

    curl -fsSL -X DELETE "https://api.anthropic.com/v1/sessions/$SESSION_ID" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: managed-agents-2026-04-01"