Kibotos 是什么
Kibotos 为 AI Agent 提供 Workspace给 AI Agent 用的完整 Linux 环境，运行在独立的 MicroVM 里。Agent 在里面读写文件、运行进程、启动服务，不会影响宿主机和其他 Workspace。：运行在独立 MicroVM 里的完整 Linux 环境。你通过 API 创建、使用和删除 Workspace，部署方把它们运行在自己的 Linux 宿主上。
概述
Agent 在 Workspace 里读写文件、运行命令和长时间进程、打开终端或桌面、启动服务，并把结果交付出来。这些操作影响不到宿主，也影响不到别的 Workspace；你也不需要关心 Workspace 跑在哪台机器上。
Kibotos 目前处于内部生产试用阶段。哪些接口承担兼容承诺、变更怎样提前通知，见保证与边界。
Workspace 提供什么
- 文件：上传、下载、列目录、移动、删除，监视目录变化。见用 kibo 上传与下载与数据面服务。
- 进程与终端：运行命令或长时间进程，断线后重新连上并补收输出，打开交互式终端。见命令与终端。
- 持久卷：Volume独立于任何 Workspace 存在的持久卷。一个 Workspace 最多绑定一个 Volume，默认挂载在 /data。 独立于 Workspace 保存数据，可以绑定、换绑、扩容。见 Volume。
- 桌面：带图形界面的 Workspace，在浏览器里查看和操作。见桌面。
- 服务：从本机连到 Workspace 内的端口，或通过公开 URL 对外提供。见端口转发与公开 URL。
- 网络控制：按目的地放行或拒绝出站流量，让出站经过你自己的代理，自选 DNS 服务器。自带代理与自选 DNS 要求部署为
v0.3.0或更新版本。见网络策略。 - 生命周期：停止与启动、设置到期时间、调整 CPU 与内存。见到期时间与调整资源。
- 导出与恢复：把 Workspace 导出成归档，在别处导入并恢复。见导出、导入与恢复。
每个 Workspace 从一个 Template创建 Workspace 用的系统镜像，例如最小系统、编程工具链或桌面环境。 创建。Template 决定 Workspace 里预装了什么，例如最小系统、编程工具链或桌面环境；可用的 Template 由部署方发布。
接入方式
| 方式 | 适合 | 详见 |
|---|---|---|
kibo 命令行 | 手工操作、脚本、排查问题 | kibo 命令行 |
| Go SDK | 需要完整能力的 Go 程序。它负责证书、重发与数据面凭证 | Go SDK |
| 原生 API | 其他语言里需要完整能力与兼容承诺的程序 | API 概览 |
| E2B SDK | 已经基于 E2B SDK 写好的程序，不改代码切换过来 | E2B 兼容 |
kibo、Go SDK 与原生 API 使用部署方签发的 Operator 身份；E2B SDK 经部署方运行的 E2B 网关接入，使用网关的 API key。
同一件事——创建一个 Workspace 并执行一条命令——的写法如下。Go SDK 替你发起原生 API 调用，见 examples/go/quickstart。
workspace_id=$(kibo workspace create --template "$template_id" -q)
kibo workspace exec "$workspace_id" -- /bin/echo ready
kibo workspace delete "$workspace_id"E2B 网关覆盖 E2B 的基础能力，未提供的部分会明确返回错误，见 E2B 兼容。需要 Kibotos 独有的能力（例如 Volume 换绑、调用方自带出口）时使用原生 API 或 kibo。
不适合的场景
有些用途需要 Kibotos 目前不提供的能力，例如在停止再启动后保留内存现场。选用 Kibotos 之前先看当前不提供。