与托管服务之间的差异

自托管 Claude Managed Agents 服务器具有与 Anthropic 托管的 Managed Agents 服务相同的 API，但本页面所述的差异除外。下表说明了针对每种差异应如何处理。在将应用程序迁移到您的服务器之前，请查阅这些表。不会从托管服务复制任何内容，包括会话历史记录。请在您的服务器上重新创建您的智能体、技能、vault 凭据和记忆存储。

仅您的服务器具备的功能

不可用的功能

行为不同的功能

需要服务器设置的功能

在您更改服务器的设置文件之前，以下每项功能都处于关闭状态，或会拒绝所有主机。

MCP 服务器需要添加到允许列表

服务器只连接主机已列在其设置文件中 mcp.allowed_hostnames 下的 MCP 服务器：

mcp:
  allowed_hostnames:
    - mcp.example.com

主机需精确匹配，不支持通配符和子域名，并且该列表默认为空。在 MCP 服务器的主机加入该列表之前，您的服务器会拒绝保存引用它的智能体。

位于您私有网络内的 MCP 服务器不需要 MCP 隧道。按照 MCP 连接器中的说明，将其 URL 放入智能体定义中，并将其主机添加到允许列表。URL 需遵守两条规则：

• 必须使用 https，除非 MCP 服务器位于环回地址上。
• 如果其主机是只解析为私有或保留地址的名称，您的服务器默认会拒绝连接。请选择适合您情况的解决方法：

Git 仓库需要添加到允许列表

在托管服务上，使用自托管沙箱的会话不能拥有 github_repository 资源。在您的服务器上，会话可以拥有。在您于服务器的设置文件中列出其 Git 主机之前，服务器会拒绝这些资源。智能体只能推送到您列出的分支：

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

请注意以下几点：

• URL： 主机不必是 github.com，但 URL 必须使用 HTTPS。
• 令牌： 您的客户端发送的令牌永远不会到达沙箱，因为 Git 流量会经过您的服务器，由服务器添加该令牌。
• 分支： 智能体不会被告知分支列表，因此请在提示中指明分支名称。
• 强制推送： 服务器不会拒绝强制推送，因此智能体可以覆盖您列出的任何分支。要拒绝强制推送，请在您的 Git 主机上保护该分支。

访问 GitHub展示了该请求以及如何轮换令牌。如果克隆失败，会话会收到一个指明原因的 session.error 事件。要检查推送，请在您的 Git 主机上查找该分支。即使推送被您的主机拒绝，服务器日志也会显示 ok。

Web 工具需要服务器设置

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 条目：

可用的 Web 工具还取决于您的推理提供商。

取决于推理提供商的差异

某些功能仅在服务器的 inference.provider 设置为特定值时才能使用。下表显示了在其他值下会发生什么。其中某些情况不会返回任何错误。

web_search 和 web_fetch 行在您启用 Web 工具之后才适用。在此之前，这两种工具在任何提供商下都无法使用。

在 anthropic 下，服务器默认会请求 Claude API 的服务器端回退。当安全分类器拒绝某个请求时，另一个 Claude 模型（可能是能力较弱的模型）随后可以回答该请求。由 Anthropic 选择模型，并且不会有事件报告这一变化，但读取会话时会显示该模型的 ID。要关闭回退，请设置 inference.model_fallback: false。在其他提供商下，此类请求会以拒绝结束当前轮次。

您的提供商文档会说明哪些模型和区域支持每项功能。自定义工具、MCP 工具以及由 worker 运行的工具在所有提供商下都相同。

接受快速模式的模型

默认情况下，服务器的模型目录将四个模型列为接受快速模式的模型：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。
• 使用 format: vertex-raw-predict 的 gateway： 该目录不列出任何模型。
• vertex： 该目录不列出任何模型，且任何设置都无法改变这一点。

要更改目录所列的内容，请参阅模型条目。

如果您已在运行自托管沙箱

worker 软件是相同的，因此您的 worker 可以连接到您的服务器。运行您自己的 worker列出了执行轮询的进程所需的三个值，以及需要首先更改的内容。依赖 webhook 启动的 worker 在此处无法工作。