管理 MCP 服务
add_mcp 注册一个新的 MCP 服务,remove_mcp 按名称注销。变更写入工作区目录下的 .mcp 文件,重启后的工作区会自动重连相同的服务,无需重新传入种子:
持久化遵循工作区自身的模型:未挂载主机
workdir 的临时 DockerWorkspace 只在内存中保存 MCP 列表,容器销毁后即丢失。管理技能
add_skill 把本地的技能目录(必须包含 SKILL.md)复制到工作区的 skills/ 目录下,内部通过 tar 归档传输,因此对本地目录和远程沙箱的行为一致。remove_skill 按技能对智能体暴露的名称(SKILL.md frontmatter 中的 name 字段)删除:
管理生命周期
三个方法贯穿工作区的一生,async with 协议则把 initialize / close 包装为作用域用法:
在服务中分配工作区
在多租户服务中,决定哪个请求使用哪个工作区(按用户、智能体或会话)、缓存活跃实例、淘汰空闲实例,是工作区管理器的职责,它是独立的服务侧组件,有专门的章节介绍:工作区管理器
分配与隔离策略、TTL 淘汰,以及与智能体服务的集成。