WebsiteRegistry
/
中文

droid

Experimental

Factory Droid. Command droid exec. Package @factory/cli@0.241.1.

Install

abx
abx template deploy ./droid -y --alias droid
abx create --template droid
# TemplateID from `abx --json template deploy` is also accepted

On each provider

Express publishes this directory with abx template deploy. The other providers do not declare templates.build, so they do not register this directory.

ProviderStatusHow
Alibaba Cloud Agent Sandbox Express EditionDeploys on ExpressUse →
Alibaba Cloud Agent Sandbox Container EditionExisting template idUse →
CubeSandboxExisting template idUse →
E2BExisting template idUse →
OpenSandboxImage URI, not this directoryUse →

About

这是什么

这是 Factory Droid 编码 CLI 的 Agent Sandbox 模板。镜像里预装官方 npm 包 @factory/cli@0.241.1（命令名 droid），版本与官方安装脚本 https://app.factory.ai/cli 当前固定的 VER=0.241.1 一致。命名命令 droid 以参数数组调用无头命令 droid exec，提示词是单独的 argv，不拼进 shell 字符串。

安装

极速版从模板库安装：

abx template install alibaba-agent-sandbox/awesome-templates//droid

本地目录：

abx template install ./droid --registry-type local

使用

创建沙箱时注入 FACTORY_API_KEY。不要把密钥写进模板或镜像。

from agent_sandbox import Sandbox

sandbox = Sandbox.create_sync(
    template="droid",
    env={"FACTORY_API_KEY": "fk-..."},
)
result = sandbox.run("droid", prompt="用一句话说明这个仓库做什么")
print(result)

sandbox.run("droid", prompt=...) 对应容器内的 droid exec <prompt>。未设置 FACTORY_API_KEY 时，命令抛出 RuntimeError。

本地 e2e

在本目录安装 agent-sandbox-server 和 httpx 后：

ABX_SERVER_PORT=9000 python3 commands.py

另一个终端：

E2E_RUN_LLM=0 python3 e2e_test.py

e2e_test.py 用 httpx 检查 GET /health、GET /commands 是否列出 droid，以及缺少 prompt 时是否返回客户端错误（HTTP 4xx）。E2E_RUN_LLM=0 时模型调用记为 SKIP。带密钥的验收设置 E2E_REQUIRE_LLM=1，服务进程和测试进程都要有 FACTORY_API_KEY，输出里必须有 ABX_E2E_OK。密钥为空则 FAIL。

E2B

E2B 上如果已经存在模板 id droid，创建沙箱时客户端读取 ABX_E2B_API_KEY。FACTORY_API_KEY 是 Droid 调模型用的密钥，在创建时注入沙箱。两者都不要写进仓库。E2B 没有沙箱内具名命令，sandbox.run("droid", prompt=...) 会得到 E8004。那张预置沙箱里要直接执行 droid exec，用 sandbox.commands.run。sandbox.run("droid", prompt=...) 只用在极速版发布后的本模板上。

Files