Claude Platform Docs
Управляемые агентыСамостоятельно размещаемый Managed Agents

Использование консоли на вашем сервере

Настройте вход в консоль на вашем самостоятельно размещённом сервере Claude Managed Agents, а затем создавайте агентов и запускайте сеансы в браузере.

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

Это не Claude Console на platform.claude.com. Она показывает только то, что находится на вашем сервере.

Настройка входа

Администратор настраивает вход один раз. Чтобы вместо этого опробовать консоль на одном компьютере, следуйте инструкциям из раздела Опробуйте консоль на вашем сервере, в котором используется фиктивный поставщик входа из выпуска.

  1. Настройте единый вход и вход из терминала

    Выполните инструкции из раздела Единый вход, включая Вход разработчиков из терминала. Консоль выполняет вход пользователей через приложение, которое вы зарегистрировали для входа из терминала. Она проверяет каждый токен по первой записи audiences в записи издателя, поэтому укажите аудиторию этого приложения первой.

  2. Предоставляйте консоль по HTTPS

    Разместите прокси, завершающий TLS, перед портом 8400. В разделе Размещение TLS перед сервером перечислено, что должен делать прокси. По обычному HTTP вход работает только на localhost или 127.0.0.1.

  3. Добавьте адрес консоли в приложение

    В вашем поставщике удостоверений добавьте HTTPS-адрес вашего сервера в качестве второго URI перенаправления для этого приложения, с завершающей косой чертой: https://cma.example.com/. Также разрешите его источник, https://cma.example.com, для межсайтовых (CORS) запросов.

Чтобы проверить настройку, откройте консоль и выполните вход.

Открытие консоли

Если ваши приложения обращаются к https://cma.example.com, откройте https://cma.example.com/ в браузере и нажмите Continue with SSO.

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

Запуск агента из консоли

Встроенные инструменты пустого агента, такие как bash, выполняются на рабочем процессе, поэтому выберите среду, которую опрашивает рабочий процесс. В разделе Что где выполняется объясняется, что такое рабочий процесс. Если рабочего процесса нет, первый вызов инструмента ожидает, пока какой-либо рабочий процесс его не выполнит. Среды создают администраторы, и они могут видеть рабочие процессы среды на её вкладке Workers.

  1. Создайте агента

    На боковой панели выберите Agents и нажмите Create agent. Выберите начальную точку, например Blank agent, и введите имя.

    Нажмите Create agent. Откроется страница агента.

  2. Запустите сеанс

    На странице агента нажмите Start session. Выберите среду и нажмите Create session. Откроется страница сеанса.

  3. Отправьте сообщение

    Введите сообщение в поле внизу страницы и отправьте его. Страница обновляется по мере работы агента. Если вызов инструмента ожидает вашего решения, на его карточке отображаются кнопки Approve и Deny.

Пока вызов инструмента ожидает вашего решения, значок сеанса показывает Idle.

Чтобы открыть любой другой сеанс, например запущенный приложением через API, выберите Sessions на боковой панели, а затем выберите сеанс.

Кто что видит

Ваша роль определяет, что показывает консоль, так же как и в API:

  • Администраторы видят и изменяют всё на сервере.
  • Пользователи с ролью developer или user видят все среды. Из агентов, сеансов, хранилищ, хранилищ памяти и навыков они видят только то, что создали, выполнив вход под своей учётной записью.

Агент или сеанс, созданный с помощью ключа API сервера, например из краткого руководства, виден только администраторам. Полную таблицу см. в разделе Что может делать каждая роль.

Отключение консоли

По умолчанию сервер предоставляет консоль. Чтобы отключить её, установите console.serve: false в файле настроек и перезапустите сервер. После этого сервер перестаёт предоставлять консоль. Агенты и сеансы продолжают работать через API.

Следующие шаги

Эта страница была полезной?