--- title: Справочник url: https://platform.claude.com/docs/ru/managed-agents/reference description: Типы событий, флаги CLI самостоятельно размещаемого воркера, поддерживаемые типы серверов MCP, ограничения скорости и рекомендации по использованию бренда для Claude Managed Agents. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- На этой странице собраны справочные материалы по Claude Managed Agents. Руководства, ориентированные на конкретные задачи, доступны по ссылкам в каждом разделе. Операции над ресурсом сессии описаны в разделе [Операции с сессиями](https://platform.claude.com/docs/ru/managed-agents/session-operations). ## Типы событий Строки типов сохраняемых событий следуют соглашению об именовании `{domain}.{action}`; исключением являются дельты событий, передаваемые только в потоке (см. вкладку «Дельты событий»). Об отправке, потоковой передаче и получении списка событий см. [Поток событий сессии](https://platform.claude.com/docs/ru/managed-agents/events-and-streaming). Типы событий вебхуков перечислены отдельно в разделе [Подписка на вебхуки](https://platform.claude.com/docs/ru/managed-agents/webhooks#supported-event-types), и некоторые их названия отличаются от названий в потоке (например, `session.status_idled` вместо `session.status_idle`). | Тип | Описание | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user.message` | Сообщение пользователя с текстом, изображением или документом. | | `user.interrupt` | Остановить агента во время выполнения. Оно не завершает ни один [запуск рабочего процесса](https://platform.claude.com/docs/ru/managed-agents/workflow-runs#interrupt-a-session-with-runs-open). | | `user.custom_tool_result` | Ответ на вызов пользовательского инструмента агентом. | | `user.tool_confirmation` | Одобрить или отклонить вызов инструмента агента или MCP, когда политика разрешений требует подтверждения. | | `user.define_outcome` | Определить [результат](https://platform.claude.com/docs/ru/managed-agents/define-outcomes), к достижению которого должен стремиться агент. | | `user.tool_result` | Только для сессий с [окружениями](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes) типа `self_hosted`: ваша интеграция отвечает за предоставление результатов `agent_toolset`. Вспомогательные средства SDK и CLI делают это автоматически. | | Тип | Описание | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | Блоки содержимого ответа агента. | | `agent.thinking` | Сигнализирует о том, что агент продвигается в работе с помощью «extended thinking» (расширенных размышлений). Это только сигнал о ходе выполнения, и он не содержит самого содержимого размышлений. | | `agent.tool_use` | Агент вызывает встроенный инструмент агента (bash, файловые операции и так далее). Содержит `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) и, как правило, `evaluation` (csharp, go: `Evaluation`) (см. [как был оценён каждый вызов](https://platform.claude.com/docs/ru/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.tool_result` | Результат выполнения встроенного инструмента агента. | | `agent.mcp_tool_use` | Агент вызывает инструмент сервера MCP. Содержит `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) и, как правило, `evaluation` (csharp, go: `Evaluation`) (см. [как был оценён каждый вызов](https://platform.claude.com/docs/ru/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.mcp_tool_result` | Результат выполнения инструмента MCP. | | `agent.custom_tool_use` | Агент вызывает один из ваших пользовательских инструментов. Ответьте событием `user.custom_tool_result`. | | `agent.thread_context_compacted` | История разговора была сжата, чтобы уместиться в «context window» (контекстное окно). | | `agent.thread_message_received` | В [мультиагентной](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) сессии сообщение из другого потока поступило в поток, чей поток событий содержит это событие; в основном потоке агент отправил отчёт или вопрос запускаемому сессией агенту. | | `agent.thread_message_sent` | В [мультиагентной](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) сессии поток, чей поток событий содержит это событие, отправил сообщение другому потоку; в основном потоке запускаемый сессией агент отправил задачу или дополнительное сообщение другому агенту. | Содержимое сообщений в этих событиях может включать блок содержимого `redacted`, `{"type": "redacted"}`: заполнитель для содержимого, скрытого в соответствии с политикой моделей Anthropic. Блок не содержит других полей. Блоки redacted появляются только в содержимом, которое генерирует платформа; событие пользователя, содержащее такой блок, отклоняется с ошибкой 400. | Тип | Описание | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `session.status_running` | Агент активно выполняет обработку. | | `session.status_idle` | Агент завершил текущую задачу и ожидает ввода. Включает `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`), указывающий, почему агент остановился. | | `session.status_rescheduled` | Произошла временная ошибка, и сессия автоматически повторяет попытку. | | `session.status_terminated` | Сессия завершилась либо из-за неустранимой ошибки, либо потому, что была архивирована. | | `session.deleted` | Сессия была удалена. Завершает любой активный поток событий; для этой сессии больше не генерируются события. | | `session.updated` | Запрос на обновление сессии изменил как минимум одно поле. Включает только изменённые поля. Обновления применяются на следующем ходе. | | `session.error` | Во время обработки произошла ошибка. Включает типизированный объект `error` (csharp, go: `Error`) с `retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`). | | `session.usage` | Снимок совокупного использования сессии и отслеживаемой стоимости по прейскуранту. Содержит итоговые показатели использования сессии и, если он задан, её [бюджет](https://platform.claude.com/docs/ru/managed-agents/budgets). | | `session.thread_created` | Был создан [мультиагентный](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) поток. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`): ID запуска для потока [запуска рабочего процесса](https://platform.claude.com/docs/ru/managed-agents/workflow-runs#a-runs-threads) и `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) для любого другого потока. | | `session.thread_status_running` | Поток сессии начал работу. Каждая сессия генерирует это событие для своего основного потока; в [мультиагентных](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) сессиях переходы дочерних потоков также дублируются в основной поток событий. | | `session.thread_status_idle` | Поток сессии завершил свой ход и ожидает ввода. Включает `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`). | | `session.thread_status_rescheduled` | Поток выполнения сессии столкнулся с временной ошибкой и автоматически повторяет попытку. | | `session.thread_status_terminated` | Поток сессии завершился и больше не принимает ввод, например потому, что был архивирован или столкнулся с неустранимой ошибкой. Поток советника также завершается, когда заканчивается его консультация. Потоки запуска рабочего процесса сервер архивирует сам. | В сессии, у агента которой включены [динамические рабочие процессы](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration#dynamic-workflows), в поток событий сессии поступают следующие события `workflow_run.*`: | Тип | Описание | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | Был создан запуск рабочего процесса. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `name` (csharp, go: `Name`) и `description` (csharp, go: `Description`) запуска, а также `phases` (csharp, go: `Phases`) — фазы, объявленные для запуска. Затем следует событие статуса, хотя после прерывания его может не быть. | | `workflow_run.status_running` | Запуск рабочего процесса выполняется. Отправляется, когда запуск начинает выполняться, что может произойти через некоторое время после `workflow_run.created`, и снова, когда он возобновляется после паузы из-за бюджета. При возобновлении после прерывания оно может не отправляться. Запуск, который с самого начала простаивает, может сначала получить `workflow_run.status_idle`. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_idle` | Запуск рабочего процесса перешёл в состояние простоя: он был приостановлен, например из-за бюджета сессии. При паузе после прерывания оно может не отправляться. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_ended` | Запуск рабочего процесса завершился. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) и `result` (csharp, go: `Result`), чей `type` (csharp, go: `Type`) указывает, как завершился запуск. | | `workflow_run.error` | Ошибка запуска рабочего процесса или начало запуска, которое сервер отклонил. Запуск, завершающийся ошибкой, получает это событие с той же ошибкой перед своим `workflow_run.status_ended`. Включает `error` (csharp, go: `Error`) и `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), который равен `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`), если запуск не был создан. | | `workflow_run.phase_started` | Запуск рабочего процесса вошёл в одну из своих фаз. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) и `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`). | | `workflow_run.phase_ended` | Запуск рабочего процесса вышел из фазы. Включает `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`) и `phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`). | События span — это маркеры наблюдаемости, которые обрамляют активность для отслеживания времени и использования. | Тип | Описание | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `span.model_request_start` | Начался вызов инференса модели. | | `span.model_request_end` | Вызов инференса модели завершён. Включает `model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`) с количеством токенов. | | `span.outcome_evaluation_start` | Началась оценка [результата](https://platform.claude.com/docs/ru/managed-agents/define-outcomes). | | `span.outcome_evaluation_ongoing` | Сигнал активности во время продолжающейся оценки [результата](https://platform.claude.com/docs/ru/managed-agents/define-outcomes). | | `span.outcome_evaluation_end` | Цикл оценки [результата](https://platform.claude.com/docs/ru/managed-agents/define-outcomes) завершён. Результат `needs_revision` означает, что последует ещё один цикл; `satisfied`, `max_iterations_reached`, `failed` и `interrupted` являются терминальными. | | Тип | Описание | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `system.message` | Добавляет привилегированный контекст системного уровня, который применяется к сопутствующему ходу и всем последующим ходам. Модели, которые его принимают, перечислены в разделе [Поддерживаемые модели](https://platform.claude.com/docs/ru/managed-agents/events-and-streaming#supported-models). Если основная модель его не поддерживает, событие отклоняется с ошибкой `model_does_not_support_mid_conversation_system`. | Дельты событий — это события предварительного просмотра, доступные только в потоке. Они генерируются в потоковых подключениях (на уровне сессии или отдельного потока выполнения), которые включают их с помощью параметра `event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`), и никогда не сохраняются в истории событий сессии. О включении, накоплении и согласовании дельт см. [Предварительный просмотр ответов с помощью дельт событий](https://platform.claude.com/docs/ru/managed-agents/event-deltas). | Тип | Описание | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event_start` | Началась генерация предварительно отображаемого события. Содержит `type` (csharp, go: `Type`) и `id` (csharp, go: `ID`) предстоящего события. Только в потоке, никогда не сохраняется. | | `event_delta` | Инкрементальное содержимое предварительно отображаемого события, идентифицируемого по `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`). Только в потоке, никогда не сохраняется. | ## Самостоятельно размещаемый воркер Флаги CLI `ant beta:worker`, переменные окружения, пути файловой системы и параметры вспомогательных функций SDK для готовых воркеров, управляющих окружением `self_hosted`, описаны в разделе [Справочник по самостоятельно размещаемым воркерам](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-reference). ## Поддерживаемые типы серверов MCP Claude Managed Agents подключается к [удалённым серверам MCP](https://platform.claude.com/docs/ru/agents-and-tools/remote-mcp-servers), предоставляющим HTTP-эндпоинт, или к частным серверам MCP через [туннели MCP](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/overview). Сервер должен поддерживать транспорт streamable HTTP протокола MCP; серверы, поддерживающие только устаревший транспорт SSE, по-прежнему работают благодаря автоматическому резервному механизму. Об объявлении серверов для агента см. [Коннектор MCP](https://platform.claude.com/docs/ru/managed-agents/mcp-connector). Дополнительную информацию о MCP и создании серверов MCP см. в [документации MCP](https://modelcontextprotocol.io). ## Ограничения скорости Для эндпоинтов Managed Agents действуют «rate limits» (ограничения скорости) на уровне организации: | Операция | Лимит | | ------------------------------------------------------------------- | ----------------------- | | Эндпоинты создания (например, агентов, сессий и окружений) | 300 запросов в минуту | | Эндпоинты чтения (например, получение, список и потоковая передача) | 1 200 запросов в минуту | Также применяются [лимиты расходов и ограничения скорости по уровням использования](https://platform.claude.com/docs/ru/api/rate-limits) на уровне организации. ## Рекомендации по использованию бренда Для партнёров, интегрирующих Claude Managed Agents, использование бренда Claude необязательно. При упоминании Claude в вашем продукте: **Разрешено:** * «Claude Agent» (предпочтительно для раскрывающихся меню) * «Claude» (внутри меню, уже озаглавленного «Agents») * «\{YourAgentName} Powered by Claude» (если у вас уже есть название агента) **Не допускается:** * «Claude Code» или «Claude Code Agent» * «Claude Cowork» или «Claude Cowork Agent» * ASCII-арт в стиле Claude Code или визуальные элементы, имитирующие Claude Code Ваш продукт должен сохранять собственный бренд и не выглядеть как Claude Code, Claude Cowork или любой другой продукт Anthropic. По вопросам соблюдения требований к использованию бренда обращайтесь в [отдел продаж](https://www.anthropic.com/contact-sales) Anthropic.