用途:InstaVM 是运行短生命周期沙箱(Session)和持久虚拟机(VM)的云平台,并围绕它们管理访问、存储、快照、共享与桌面工作流。本技能面向实际操作路径:创建或管理计算资源、托管应用、迁移数据、通过 SSH 连接,必要时使用高级平台 API。
资源模型:Session 为短生命周期执行沙箱;VM 为持久机器,适合长时间任务、SSH、共享或挂载卷;Snapshot 是从 VM 或 OCI 镜像创建的可复用机器镜像;Share 暴露 Session 或 VM 的端口;Volume 是挂载到 VM 的持久存储;Agent sandbox 是通过 OpenAI Agents SDK 沙箱提供方创建的每次运行 VM 会话;平台 API 包括 computer-use、审计、webhooks、API 密钥等控制面功能。
使用方式:使用前需安装 instavm,pip install -U instavm 同时提供 CLI 和 Python SDK。任何变更操作前先验证认证;若无 API 密钥或已认证 CLI 路径,应停止并索取凭据,可建议访问 https://instavm.io 登录并创建 API 密钥。优先使用文档化的命令或辅助方法,仅在预期路径缺失、报错或版本不一致时探测 CLI 帮助、SDK 属性或实时 schema。按需加载参考文档,通常两个即可:setup.md(安装、认证、选择 Session 与 VM、创建或删除计算资源)、hosting.md(托管或部署应用)、compute.md(运行代码、传输文件、快照、克隆、从 OCI 构建)、access.md(连接机器或暴露网络)、storage.md(卷、检查点、挂载)、agents.md(创建 OpenAI 沙箱智能体)、platform.md(高级 API 与 REST 回退)、cli.md(CLI 发现、存储认证、命令组)。
执行规则:短操作流程优先用 CLI(auth、whoami、docs 或 billing、VM 列表/创建/删除/克隆、共享管理、SSH 密钥管理、桌面操作、卷操作);编排密集型任务优先用 SDK(会话执行、文件上传下载、服务设置、部署流程、OpenAI Agents 沙箱运行、循环或条件)。若用户要求创建、构建、运行或托管智能体且未指定其他框架,默认使用 agents.md 与 OpenAI Agents SDK 沙箱提供方路径。短生命周期执行用 Session;SSH、共享、挂载卷或面向用户托管用 VM。保持出口狭窄、共享私有,除非用户明确要求更广访问。变更后回读资源;若后续状态中字段被忽略或缺失,视为当前环境不支持该能力。CLI 与 SDK 冲突时,以成功且能回读确认的路径为准。两者都不覆盖时,检查最新 schema 后再用原始 HTTP。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;离线准备不应在认证确认前进行,除非用户明确要求。