Claude Platform Docs
Managed Agents自托管 Managed Agents

在您的服务器上使用控制台

为自托管 Claude Managed Agents 服务器上的控制台设置登录，然后在浏览器中创建智能体并运行会话。

服务器上的控制台是一个网页，由自托管的 Claude Managed Agents 服务器在与其 API 相同的地址上提供。在控制台中，您无需 SDK 或 CLI，即可创建智能体、运行会话，以及管理环境、凭据保管库（credential vault）、记忆存储（memory store）和技能。

它并不是位于 platform.claude.com 的 Claude Console。它只显示您服务器上的内容。

设置登录

管理员只需设置一次登录。如果只想在一台机器上试用控制台，请改为按照在您服务器上试用控制台操作，该方法使用发行版中的模拟登录提供商。

  1. 设置单点登录和终端登录

    请按照单点登录操作，包括让开发者从终端登录。控制台通过您为终端登录注册的应用程序让用户登录。它会根据颁发者条目中 audiences 的第一个条目检查每个令牌，因此请将该应用程序的受众（audience）列在首位。

  2. 通过 HTTPS 提供控制台

    在端口 8400 前放置一个终止 TLS 的代理。在服务器前放置 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）在工作器（worker）上运行，因此请选择一个有工作器正在轮询的环境。各组件的运行位置说明了工作器是什么。如果没有工作器，第一次工具调用会一直等待，直到有工作器执行它。环境由管理员创建，管理员可以在环境的 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 继续工作。

后续步骤

此页面对您有帮助吗？