После того как сессия создана, используйте эти операции для её чтения, обновления, архивирования или удаления. См. раздел Запуск сессии, чтобы узнать, как создать сессию и отправить ей задачу.
Все запросы к Managed Agents API требуют бета-заголовка managed-agents-2026-04-01. SDK устанавливает бета-заголовок автоматически.
Сессии проходят через следующие статусы. См. раздел Запуск сессии для ознакомления с жизненным циклом сессии.
| Статус | Описание |
|---|---|
idle | Агент ожидает ввода, включая сообщения пользователя или подтверждения инструментов. Сессии начинаются в статусе idle. |
running | Агент активно выполняет работу. |
rescheduling | Произошла временная ошибка, выполняется автоматическая повторная попытка. |
terminated | Сессия завершена из-за невосстановимой ошибки. |
Вы можете обновить agent.tools и agent.mcp_servers сессии, включая политики разрешений, в середине сессии без создания новой версии агента. Обновления локальны для сессии и не распространяются обратно на базового агента.
Семантика обновления — полная замена: предоставленный массив становится новым значением. Чтобы сохранить существующие записи, выполните GET для сессии, измените массив и отправьте его обратно через POST.
Для обновления агента сессия должна находиться в статусе idle. Прервите сессию, если вам нужно обновить агента во время её выполнения.
Архивируйте сессию, чтобы предотвратить отправку новых событий, сохранив при этом её историю. Сессию в статусе running нельзя архивировать; отправьте событие прерывания, если вам нужно архивировать её немедленно.
Удалите сессию, чтобы безвозвратно удалить её запись, события и связанную песочницу. Сессию в статусе running нельзя удалить; отправьте событие прерывания, если вам нужно удалить её немедленно.
Файлы, хранилища памяти, хранилища секретов, навыки, окружения и агенты являются независимыми ресурсами и не затрагиваются удалением сессии.
Was this page helpful?
ant beta:sessions update --session-id "$SESSION_ID" <<'YAML'
agent:
tools:
- type: agent_toolset_20260401
- type: mcp_toolset
mcp_server_name: linear
mcp_servers:
- type: url
name: linear
url: https://mcp.linear.app/sse
YAMLant beta:sessions retrieve --session-id "$SESSION_ID"ant beta:sessions list --agent-id "$AGENT_ID"ant beta:sessions archive \
--session-id "$SESSION_ID"ant beta:sessions delete \
--session-id "$SESSION_ID"