На этой странице собраны справочные материалы по Claude Managed Agents. Руководства, ориентированные на конкретные задачи, доступны по ссылкам в каждом разделе. Операции над ресурсом сессии описаны в разделе Операции с сессиями.
Все запросы к Managed Agents API требуют бета-заголовка managed-agents-2026-04-01. SDK устанавливает бета-заголовок автоматически.
Строки типов сохраняемых событий следуют соглашению об именовании {domain}.{action}; исключение составляют дельты событий, доступные только в потоке (см. вкладку «Дельты событий»). Информацию об отправке, потоковой передаче и получении списка событий см. в разделе Поток событий сессии.
| Тип | Описание |
|---|---|
user.message | Сообщение пользователя с текстовым содержимым. |
user.interrupt | Остановить агента в процессе выполнения. |
user.custom_tool_result | Ответ на вызов пользовательского инструмента со стороны агента. |
user.tool_confirmation | Одобрить или отклонить вызов инструмента агента или MCP-инструмента, когда политика разрешений требует подтверждения. |
user.define_outcome | Определить результат, к которому должен стремиться агент. |
user.tool_result | Только для сессий с self_hosted окружениями: ваша интеграция отвечает за предоставление результатов agent_toolset. Вспомогательные функции SDK и CLI делают это автоматически. |
Ниже приведены флаги CLI ant beta:worker для предварительно собранного воркера, который управляет окружением self_hosted. Информацию о настройке окружения, запуске воркера и параметрах вспомогательных функций SDK см. в разделе Самостоятельно размещаемые песочницы.
| Флаг | Описание |
|---|---|
--environment-id | Окружение, которое опрашивается на наличие работы. Также считывается из ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Аутентифицирует воркер в данном окружении. Также считывается из ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Каталог, в который загружаются навыки и в котором инструменты читают и записывают файлы. По умолчанию . (текущий каталог); системный рабочий каталог по умолчанию — /workspace. |
--on-work | Скрипт, вызываемый для каждого полученного элемента работы вместо запуска инструментов внутри процесса. Получает сведения о сессии в виде переменных окружения. |
--unrestricted-paths | Разрешить вызовам инструментов доступ к путям за пределами --workdir. |
--max-idle | Время ожидания после перехода сессии в состояние простоя с причиной остановки end_turn перед завершением работы. По умолчанию 60s. |
--log-format | Формат вывода логов. Используйте json для приёма структурированных логов. По умолчанию text. |
Claude Managed Agents подключается к удалённым MCP-серверам, которые предоставляют HTTP-эндпоинт, или к приватным MCP-серверам через MCP-туннели. Сервер должен поддерживать потоковый HTTP-транспорт протокола MCP. Информацию об объявлении серверов для агента см. в разделе MCP-коннектор.
Дополнительную информацию о MCP и создании MCP-серверов см. в документации MCP.
Эндпоинты Managed Agents имеют ограничения скорости на уровне организации:
| Операция | Лимит |
|---|---|
| Эндпоинты создания (например, агенты, сессии и окружения) | 300 запросов в минуту |
| Эндпоинты чтения (например, получение, список и поток) | 1 200 запросов в минуту |
Также применяются лимиты расходов и ограничения скорости уровня использования на уровне организации.
Для партнёров, интегрирующих Claude Managed Agents, использование брендинга Claude является необязательным. При упоминании Claude в вашем продукте:
Разрешено:
Не разрешено:
Ваш продукт должен сохранять собственный брендинг и не выглядеть как Claude Code, Claude Cowork или любой другой продукт Anthropic. По вопросам соответствия требованиям брендинга обращайтесь в отдел продаж Anthropic.
Was this page helpful?