Отличия от размещённого сервиса

Самостоятельно размещаемый сервер Claude Managed Agents имеет тот же API, что и размещённый сервис Managed Agents от Anthropic, за исключением различий, описанных на этой странице. В таблицах указано, что делать в каждом случае. Ознакомьтесь с ними, прежде чем переносить приложение на ваш сервер. Из размещённого сервиса ничего не копируется, включая историю сеансов. Создайте своих агентов, навыки, учётные данные хранилища и хранилища памяти заново на вашем сервере.

Функции, которые есть только у вашего сервера

Недоступные функции

Функции, которые работают иначе

Функции, которым нужна настройка сервера

Каждая из этих функций отключена или отклоняет все хосты, пока вы не измените файл настроек сервера.

Серверам MCP нужна запись в списке разрешённых

Сервер подключается только к серверам MCP, хосты которых вы перечислили в mcp.allowed_hostnames в его файле настроек:

mcp:
  allowed_hostnames:
    - mcp.example.com

Хосты сопоставляются точно, без подстановочных знаков и без поддоменов, а по умолчанию список пуст. Пока хост сервера MCP не внесён в список, ваш сервер отказывается сохранять агента, который его указывает.

Серверу MCP внутри вашей частной сети не нужен туннель MCP. Укажите его URL в определении агента, как описано в разделе Коннектор MCP, и добавьте его хост в «allowlist» (список разрешённых). К URL применяются два правила:

• Он должен использовать https, если только сервер MCP не находится на адресе loopback.
• Если его хост — это имя, которое разрешается только в частные или зарезервированные адреса, ваш сервер по умолчанию отказывается подключаться. Выберите решение, подходящее для вашего случая:

Репозиториям Git нужна запись в списке разрешённых

В размещённом сервисе сеансы, использующие самостоятельно размещаемые песочницы, не могут иметь ресурсы github_repository. На вашем сервере — могут. Сервер отклоняет эти ресурсы, пока вы не перечислите их хосты Git в его файле настроек. Агенты могут отправлять изменения только в перечисленные вами ветки:

git:
  allowed_hostnames:
    - github.com
  allowed_push_refs:
    - refs/heads/agent/

Обратите внимание на следующее:

• URL: Хост не обязательно должен быть github.com, но URL должен использовать HTTPS.
• Токен: Токен, который отправляет ваш клиент, никогда не попадает в песочницу, поскольку трафик Git проходит через ваш сервер, который и добавляет токен.
• Ветки: Агентам не сообщается список веток, поэтому укажите ветку в своей подсказке.
• Принудительная отправка: Сервер не отклоняет «force push» (принудительную отправку), поэтому агент может перезаписать любую перечисленную вами ветку. Чтобы запретить принудительную отправку, защитите ветку на своём хосте Git.

В разделе Доступ к GitHub показан запрос и описано, как заменить токен. Если клонирование завершается ошибкой, сеанс получает событие session.error с указанием причины. Чтобы проверить отправку, найдите ветку на своём хосте Git. Журнал сервера сообщает ok даже для отправки, которую ваш хост отклонил.

Веб-инструментам нужна настройка сервера

Инструменты web_search и web_fetch по умолчанию отключены. Чтобы включить их, добавьте следующее в файл настроек сервера:

web_tools:
  enabled: true

Если задана только эта настройка, применяются собственные списки доменов и ограничение на содержимое каждого агента, как и в размещённом сервисе.

Чтобы ограничить инструменты для всех агентов, задайте web_tools.allowed_domains, web_tools.blocked_domains или web_tools.max_content_tokens. Каждая из этих настроек также включает инструменты. Сервер отказывается сохранять агента, который запрашивает больше, чем разрешают эти настройки. Например, он отклоняет агента, который разрешает домен за пределами web_tools.allowed_domains или задаёт большее ограничение на содержимое. Если такой агент уже существует, он не сможет запустить сеанс, пока вы его не обновите.

Пока инструменты отключены, то, что происходит с агентом, зависит от записей web_search и web_fetch в его наборе инструментов:

Набор доступных веб-инструментов также зависит от вашего поставщика инференса.

Различия, зависящие от вашего поставщика инференса

Некоторые функции работают только при определённых значениях настройки сервера inference.provider. В таблице показано, что происходит при других значениях. В некоторых из этих случаев ошибка не возвращается.

Строки web_search и web_fetch применяются после того, как вы включите веб-инструменты. До этого ни один из этих инструментов не работает ни у одного поставщика.

При anthropic сервер по умолчанию запрашивает резервный вариант на стороне сервера Claude API. Тогда, когда классификатор безопасности отклоняет запрос, на него может ответить другая модель Claude, возможно, менее мощная. Модель выбирает Anthropic, и ни одно событие не сообщает о смене, но при чтении сеанса отображается ID этой модели. Чтобы отключить резервный вариант, задайте inference.model_fallback: false. У других поставщиков такой запрос завершает ход с отказом.

В документации вашего поставщика указано, какие модели и регионы поддерживают каждую функцию. Пользовательские инструменты, инструменты MCP и инструменты, которые выполняет ваш воркер, одинаковы у всех поставщиков.

Модели, поддерживающие быстрый режим

По умолчанию в каталоге моделей сервера четыре модели указаны как поддерживающие быстрый режим: Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8 и Claude Opus 4.6. Для Claude Opus 4.6 Claude API принимает запрос, но выполняет его со стандартной скоростью. Следующие значения inference.provider являются исключениями:

• foundry: В каталоге указана только Claude Opus 5.5.
• gateway с format: vertex-raw-predict: В каталоге не указано ни одной модели.
• vertex: В каталоге не указано ни одной модели, и никакая настройка этого не меняет.

Чтобы изменить перечень моделей в каталоге, см. Записи моделей.

Если вы уже используете самостоятельно размещаемые песочницы

Программное обеспечение воркера то же самое, поэтому ваши воркеры могут подключаться к вашему серверу. В разделе Запуск собственных воркеров перечислены три значения для процесса, выполняющего опрос, и что нужно изменить в первую очередь. Воркер, который запускается по вебхуку, здесь не работает.