自托管 Claude Managed Agents

自托管 Claude Managed Agents 是在您自己的基础设施上运行的 Managed Agents，该基础设施可以是云账户，也可以是本地数据中心。服务和沙箱由您托管。模型在 Anthropic 或您选择的提供商处运行。

Managed Agents 有两个可由您托管的部分：

• 沙箱： 智能体工具在其中运行命令和处理文件的容器、虚拟机或其他隔离的工作空间。请参阅自托管沙箱。
• 服务： API、智能体循环，以及智能体、会话和会话历史的存储。

自托管沙箱将第一部分交由您托管。自托管 Managed Agents 扩展了这一点：服务也由您来托管。每个选项的名称说明了您托管的内容：

在这些页面中，托管服务是指由 Anthropic 运行的服务，而您的服务器是指由您运行的服务，它拥有自己的数据库。两者具有相同的 API，因此 SDK 和 ant CLI 均可与您的服务器配合使用，其余的 Managed Agents 文档同样适用。与托管服务之间的差异列出了例外情况。

何时选择自托管 Managed Agents

当您需要以下任一项时，请选择自托管 Managed Agents：

• 在您的基础设施上存储： 您必须自行存储智能体、会话和会话历史。
• 自选推理提供商： 模型调用必须发送到 Amazon Bedrock、Claude Models on Google Cloud (Google managed)、Microsoft Foundry 或您自己的模型网关。请参阅推理提供商。

如果您只需要在自己的基础设施上运行工具，请使用自托管沙箱，此时服务由 Anthropic 运行。请参阅选择智能体环境。

使用自托管 Managed Agents 时，您需要运行并保护服务器、其数据库以及您的沙箱，并且每个发布版本都需要您自行安装。某些功能仅存在于托管服务中，因此请在做出决定之前查看与托管服务之间的差异。

各组件在何处运行

一个或多个服务器、其数据库以及您的沙箱构成一个部署。

• 服务器（cma-server）： 提供 API、运行智能体循环，并存储智能体、会话以及每个会话的历史。每当智能体需要模型时，它都会调用您的推理提供商。服务器从不运行智能体的 shell 或文件工具。
• 数据库： PostgreSQL 16 或更高版本。如果没有数据库，服务器会将数据保存在内存中，重启会将其清除。
• worker： 从服务器获取工作，并在您的沙箱中运行智能体的 shell 和文件工具的程序。worker 是一个 ant beta:worker 命令或一个 SDK worker。
• 您的应用程序： 您自己的代码和脚本，它们通过 SDK 或 ant CLI 访问服务器。
• 您服务器上的控制台： 位于服务器地址的一个网页，用户通过您的身份提供商登录，以创建智能体并运行会话。请参阅在您的服务器上使用控制台。
• 管理 CLI（cma-server-admin）： 创建环境及其环境密钥。它可在 Linux（x86-64 和 Arm）以及搭载 Apple 芯片的 macOS 上运行。

您的安全职责

自托管沙箱的安全模型适用于此处，但有两点不同。该页面中划归 Anthropic 的职责改由您负责，包括保障服务器安全、托管记忆存储以及检测异常使用。该页面还建议为每个信任边界使用单独的工作区和环境。在这里，每个信任级别都需要各自独立的部署，详见多租户。

三种凭据

哪些数据会离开您的网络

对于每次模型调用，服务器会将截至目前的对话（包括工具输入和工具结果）发送到您的推理提供商。默认情况下，该推理提供商是 Claude API。对 Claude API 的调用还会携带其会话的 ID，以及该会话的智能体和环境的 ID。自托管 Claude Managed Agents 中的数据与访问列出了服务器建立的每个连接。它还说明了日志的去向以及谁可以访问服务器。

从何处开始

如需申请下载权限，请联系您的 Anthropic 客户团队。然后按照开始使用自托管 Claude Managed Agents启动服务器并运行第一个会话。

每个发布版本的归档文件都包含该版本的运维指南 operator-guide.md。请让 Claude 阅读该文件，以便 Claude 能够帮助您配置和运行服务器，并编写连接到服务器的代码。