Сеанс — это работающий экземпляр агента в окружении. Каждый сеанс ссылается на агента и окружение (оба созданы отдельно) и поддерживает историю разговора на протяжении нескольких взаимодействий.
Все запросы Managed Agents API требуют заголовка бета-версии managed-agents-2026-04-01. SDK автоматически устанавливает заголовок бета-версии.
Сеанс требует ID agent и ID environment. Агенты — это версионируемые ресурсы; передача ID agent в виде строки запускает сеанс с последней версией агента.
Was this page helpful?
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, требующие аутентификации, передайте 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"