Server SDK
Server SDK 跑在沙箱里面。它是镜像启动后一直听着的 HTTP 服务，默认端口 9000。包名是 agent-sandbox-server，导入 agent_sandbox.server。模板的 commands.py 用它注册命令、打开能力，然后 start(9000)。
pip install agent-sandbox-server
from agent_sandbox.server import command, start
@command(description="Say hello")
def hello(name: str = "world") -> dict:
return {"message": f"Hello, {name}!"}
if __name__ == "__main__":
start(9000)
这段代码不创建云上沙箱，也不读取沙箱 API Key。谁来创建沙箱、谁来调用这些路由，是 Client SDK 或 abx CLI 的事。
从这里开始
| 文档 | 做什么 |
|---|---|
| 编写模板 | template.yaml、Dockerfile、commands.py |
| 模板服务器 HTTP API | 服务实际提供的路由 |
| 最佳实践 | 服务器不带提供者、按需打开能力组 |
| 细粒度能力 | 按端点开关路由 |
| 文件与命令控制 | 限制路径和命令 |
| Agents API | 在沙箱里打开 Codex 和 Qwen Code 的 HTTP 会话 |
| 托管代理 | 这些路由怎么拒绝、怎么返回 |
参考：Server HTTP API、template.yaml、Agents API 参考、Server API 设计。
示例
这些 commands.py 随镜像启动，见 示例目录：
examples/templates/python-hello/commands.py— 最小命令服务器examples/templates/agents-cli/commands.py— 只打开发话相关的 Agents 路由
examples/templates/python-hello/call_api.py 不是 Server SDK。它在沙箱外面，对已经在听的服务发请求，归在 Client SDK。