Эта страница собирает справочные материалы для Claude Managed Agents. Для руководств, ориентированных на задачи, переходите по ссылкам в каждом разделе. Для операций над ресурсом сессии см. Операции с сессиями.
Запросы к Managed Agents API требуют бета-заголовка managed-agents-2026-04-01, за исключением конечных точек хранилища памяти, которые вместо этого используют agent-memory-2026-07-22. 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. Проверка рабочего каталога — это защитный механизм только для файловых инструментов, а не песочница; она не ограничивает bash. |
--max-idle | Как долго ждать после перехода сессии в состояние простоя с причиной остановки end_turn перед завершением работы. По умолчанию 60s. |
--log-format | Формат вывода логов. Используйте json для структурированного приёма логов. По умолчанию text. |
Claude Managed Agents подключается к удалённым серверам MCP, которые предоставляют HTTP-эндпоинт, или к приватным серверам MCP через туннели MCP. Сервер должен поддерживать транспорт streamable HTTP протокола MCP; серверы, поддерживающие только устаревший транспорт SSE, по-прежнему работают благодаря автоматическому переключению. См. Коннектор MCP для объявления серверов у агента.
Для получения дополнительной информации о MCP и создании серверов MCP см. документацию MCP.
Эндпоинты Managed Agents имеют ограничение скорости на уровне организации:
| Операция | Лимит |
|---|---|
| Эндпоинты создания (такие как агенты, сессии и окружения) | 300 запросов в минуту |
| Эндпоинты чтения (такие как получение, список и поток) | 1 200 запросов в минуту |
Также применяются лимиты расходов и ограничения скорости уровня использования на уровне организации.
Для партнёров, интегрирующих Claude Managed Agents, использование брендинга Claude необязательно. При упоминании Claude в вашем продукте:
Разрешено:
Не разрешено:
Ваш продукт должен сохранять собственный брендинг и не выглядеть как Claude Code, Claude Cowork или любой другой продукт Anthropic. По вопросам соответствия требованиям брендинга обращайтесь в отдел продаж Anthropic.
Was this page helpful?