Справочник
Типы событий, флаги CLI самостоятельно размещаемого воркера, поддерживаемые типы серверов MCP, ограничения скорости и рекомендации по использованию бренда для Claude Managed Agents.
На этой странице собраны справочные материалы по Claude Managed Agents. Руководства, ориентированные на конкретные задачи, доступны по ссылкам в каждом разделе. Операции над ресурсом сессии описаны в разделе Операции с сессиями.
Типы событий
Строки типов сохраняемых событий следуют соглашению об именовании {domain}.{action}; исключением являются дельты событий, передаваемые только в потоке (см. вкладку «Дельты событий»). Об отправке, потоковой передаче и получении списка событий см. Поток событий сессии. Типы событий вебхуков перечислены отдельно в разделе Подписка на вебхуки, и некоторые их названия отличаются от названий в потоке (например, session.status_idled вместо session.status_idle).
| Тип | Описание |
|---|---|
user.message | Сообщение пользователя с текстом, изображением или документом. |
user.interrupt | Остановить агента во время выполнения. Оно не завершает ни один запуск рабочего процесса. |
user.custom_tool_result | Ответ на вызов пользовательского инструмента агентом. |
user.tool_confirmation | Одобрить или отклонить вызов инструмента агента или MCP, когда политика разрешений требует подтверждения. |
user.define_outcome | Определить результат, к достижению которого должен стремиться агент. |
user.tool_result | Только для сессий с окружениями типа self_hosted: ваша интеграция отвечает за предоставление результатов agent_toolset. Вспомогательные средства SDK и CLI делают это автоматически. |
| Тип | Описание |
|---|---|
agent.message | Блоки содержимого ответа агента. |
agent.thinking | Сигнализирует о том, что агент продвигается в работе с помощью «extended thinking» (расширенных размышлений). Это только сигнал о ходе выполнения, и он не содержит самого содержимого размышлений. |
agent.tool_use | Агент вызывает встроенный инструмент агента (bash, файловые операции и так далее). Содержит evaluated_permission и, как правило, evaluation (см. как был оценён каждый вызов). |
agent.tool_result | Результат выполнения встроенного инструмента агента. |
agent.mcp_tool_use | Агент вызывает инструмент сервера MCP. Содержит evaluated_permission и, как правило, evaluation (см. как был оценён каждый вызов). |
agent.mcp_tool_result | Результат выполнения инструмента MCP. |
agent.custom_tool_use | Агент вызывает один из ваших пользовательских инструментов. Ответьте событием user.custom_tool_result. |
agent.thread_context_compacted | История разговора была сжата, чтобы уместиться в «context window» (контекстное окно). |
agent.thread_message_received | В мультиагентной сессии сообщение из другого потока поступило в поток, чей поток событий содержит это событие; в основном потоке агент отправил отчёт или вопрос запускаемому сессией агенту. |
agent.thread_message_sent | В мультиагентной сессии поток, чей поток событий содержит это событие, отправил сообщение другому потоку; в основном потоке запускаемый сессией агент отправил задачу или дополнительное сообщение другому агенту. |
Содержимое сообщений в этих событиях может включать блок содержимого redacted, {"type": "redacted"}: заполнитель для содержимого, скрытого в соответствии с политикой моделей Anthropic. Блок не содержит других полей. Блоки redacted появляются только в содержимом, которое генерирует платформа; событие пользователя, содержащее такой блок, отклоняется с ошибкой 400.
| Тип | Описание |
|---|---|
session.status_running | Агент активно выполняет обработку. |
session.status_idle | Агент завершил текущую задачу и ожидает ввода. Включает stop_reason, указывающий, почему агент остановился. |
session.status_rescheduled | Произошла временная ошибка, и сессия автоматически повторяет попытку. |
session.status_terminated | Сессия завершилась либо из-за неустранимой ошибки, либо потому, что была архивирована. |
session.deleted | Сессия была удалена. Завершает любой активный поток событий; для этой сессии больше не генерируются события. |
session.updated | Запрос на обновление сессии изменил как минимум одно поле. Включает только изменённые поля. Обновления применяются на следующем ходе. |
session.error | Во время обработки произошла ошибка. Включает типизированный объект error с retry_status. |
session.usage | Снимок совокупного использования сессии и отслеживаемой стоимости по прейскуранту. Содержит итоговые показатели использования сессии и бюджет сессии, если он у сессии есть. |
session.thread_created | Был создан мультиагентный поток. Оно включает workflow_run_id: идентификатор запуска для потока запуска рабочего процесса и null для любого другого потока. |
session.thread_status_running | Поток сессии начал работу. Каждая сессия генерирует это событие для своего основного потока; в мультиагентных сессиях переходы дочерних потоков также дублируются в основной поток событий. |
session.thread_status_idle | Поток выполнения сессии завершил свой ход и ожидает ввода. Включает stop_reason. |
session.thread_status_rescheduled | Поток выполнения сессии столкнулся с временной ошибкой и автоматически повторяет попытку. |
session.thread_status_terminated | Поток сессии завершился и больше не принимает ввод, например потому, что был архивирован или столкнулся с неустранимой ошибкой. Поток советника также завершается, когда заканчивается его консультация. Потоки запуска рабочего процесса сервер архивирует сам. |
В сессии, у агента которой включены динамические рабочие процессы, в поток событий сессии поступают следующие события workflow_run.*:
| Тип | Описание |
|---|---|
workflow_run.created | Был создан запуск рабочего процесса. Включает workflow_run_id, name и description запуска, а также phases — фазы, объявленные для запуска. За ним следует событие состояния, хотя после прерывания его может не быть. |
workflow_run.status_running | Запуск рабочего процесса выполняется. Отправляется, когда запуск начинает выполняться, что может произойти через некоторое время после workflow_run.created, и снова, когда он возобновляется после приостановки из-за бюджета. При возобновлении после прерывания оно может не отправляться. Запуск, который с самого начала простаивает, может сначала получить workflow_run.status_idle. Включает workflow_run_id. |
workflow_run.status_idle | Запуск рабочего процесса перешёл в состояние простоя: он был приостановлен, например из-за бюджета сессии. При приостановке после прерывания оно может не отправляться. Включает workflow_run_id. |
workflow_run.status_ended | Запуск рабочего процесса завершился. Включает workflow_run_id и result, чей type указывает, как завершился запуск. |
workflow_run.error | Ошибка запуска рабочего процесса или начало запуска, которое сервер отклонил. Запуск, завершающийся ошибкой, получает это событие с той же ошибкой перед своим workflow_run.status_ended. Включает error и workflow_run_id, который равен null, если запуск не был создан. |
workflow_run.phase_started | Запуск рабочего процесса вошёл в одну из своих фаз. Включает workflow_run_id и workflow_run_phase_id. |
workflow_run.phase_ended | Запуск рабочего процесса вышел из фазы. Включает workflow_run_id, workflow_run_phase_id и phase_started_id. |
События span — это маркеры наблюдаемости, которые обрамляют активность для отслеживания времени и использования.
| Тип | Описание |
|---|---|
span.model_request_start | Начался вызов инференса модели. |
span.model_request_end | Вызов инференса модели завершён. Включает model_usage с количеством токенов. |
span.outcome_evaluation_start | Началась оценка результата. |
span.outcome_evaluation_ongoing | Сигнал активности во время продолжающейся оценки результата. |
span.outcome_evaluation_end | Цикл оценки результата завершён. Результат needs_revision означает, что последует ещё один цикл; satisfied, max_iterations_reached, failed и interrupted являются терминальными. |
| Тип | Описание |
|---|---|
system.message | Добавляет привилегированный контекст системного уровня, который применяется к сопутствующему ходу и всем последующим ходам. Модели, которые его принимают, перечислены в разделе Поддерживаемые модели. Если основная модель его не поддерживает, событие отклоняется с ошибкой model_does_not_support_mid_conversation_system. |
Дельты событий — это события предварительного просмотра, передаваемые только в потоке. Они генерируются в потоковых подключениях (на уровне сессии или отдельного потока выполнения), которые явно включают их с помощью параметра event_deltas[], и никогда не сохраняются в истории событий сессии. О том, как включать, накапливать и согласовывать их, см. в разделе Предварительный просмотр ответов с помощью дельт событий.
| Тип | Описание |
|---|---|
event_start | Началась генерация предварительно отображаемого события. Содержит type и id предстоящего события. Передаётся только в потоке и никогда не сохраняется. |
event_delta | Инкрементное содержимое предварительно отображаемого события, идентифицируемого по event_id. Передаётся только в потоке и никогда не сохраняется. |
Самостоятельно размещаемый воркер
Флаги CLI ant beta:worker, переменные окружения, пути файловой системы и параметры вспомогательных функций SDK для готовых воркеров, управляющих окружением self_hosted, описаны в разделе Справочник по самостоятельно размещаемым воркерам.
Поддерживаемые типы серверов MCP
Claude Managed Agents подключается к удалённым серверам MCP, предоставляющим HTTP-эндпоинт, или к частным серверам MCP через туннели MCP. Сервер должен поддерживать транспорт streamable HTTP протокола MCP; серверы, поддерживающие только устаревший транспорт SSE, по-прежнему работают благодаря автоматическому резервному механизму. Об объявлении серверов для агента см. Коннектор MCP.
Дополнительную информацию о MCP и создании серверов MCP см. в документации MCP.
Ограничения скорости
Для эндпоинтов Managed Agents действуют «rate limits» (ограничения скорости) на уровне организации:
| Операция | Лимит |
|---|---|
| Эндпоинты создания (например, агентов, сессий и окружений) | 300 запросов в минуту |
| Эндпоинты чтения (например, получение, список и потоковая передача) | 1 200 запросов в минуту |
Также применяются лимиты расходов и ограничения скорости по уровням использования на уровне организации.
Рекомендации по использованию бренда
Для партнёров, интегрирующих 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. По вопросам соблюдения требований к использованию бренда обращайтесь в отдел продаж Anthropic.
Was this page helpful?