Справочник
Типы событий, флаги 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 делают это автоматически. |
Самостоятельно размещаемый воркер
Ниже приведены флаги 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. |
Воркер CLI не монтирует хранилища памяти: сессия, к которой подключено такое хранилище, всё равно запускается, но агент ничего не находит по пути mount_path хранилища, и никакие изменения не синхронизируются обратно в хранилище. Чтобы использовать хранилища памяти в сессиях на самостоятельно размещаемом окружении, запустите вместо этого воркер SDK; см. Использование хранилищ памяти.
Поддерживаемые типы серверов 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?