managed-agents-environments

# 托管智能体 — 环境与资源 ## 环境 创建会话需要一个 `environment_id`。环境是用于在 Anthropic 基础设施中启动容器的**可重用配置模板** — 您可以为不同的用例创建不同的环境（例如数据可视化 vs Web 开发，使用不同的包集合）。Anthropic 负责处理扩展、容器生命周期和工作编排。 **环境名称必须唯一。** 创建具有现有名称的环境将返回 409。 ### 网络 | 网络策略 | 说明 | | ------------------------------- | ------------------------------------------------------------- | | `unrestricted` | 完全出站访问（法律黑名单除外） | | `package_managers_and_custom` | 包管理器 + 自定义 `allowed_hosts` | { "networking": { "type": "package_managers_and_custom", "allowed_hosts": ["api.example.com"] } } **MCP 注意事项：** 如果使用受限网络，请确保 `allowed_hosts` 包含您的 MCP 服务器域名。否则容器将无法访问它们，工具会静默失败。 ### 创建环境 SDK 会自动添加 `managed-agents-2026-04-01`。TypeScript 示例： ts const env = await client.beta.environments.create({ name: "my_env", config: { type: "cloud", networking: { type: "unrestricted" }, }, }); ### 环境 CRUD | 操作 | 方法 | 路径 | 说明 | | ---------------- | -------- | ------------------------------------------ | ----- | | 创建 | `POST` | `/v1/environments` | | | 列表 | `GET` | `/v1/environments` | 分页 (`limit`, `after_id`, `before_id`) | | 获取 | `GET` | `/v1/environments/{id}` | | | 更新 | `POST` | `/v1/environments/{id}` | 更改仅适用于**新**容器；现有会话保留其原始配置 | | 删除 | `DELETE` | `/v1/environments/{id}` | 返回 204。 | | 归档 | `POST` | `/v1/environments/{id}/archive` | 使其变为**只读**；现有会话继续运行，新会话无法引用它。无法取消归档 — 终端状态。 | --- ## 资源 挂载文件、GitHub 仓库和记忆