一、快速开始
1. 创建并获取 API Token。
2. 使用下面的示例模板直接开始部署。
3. 在部署配置页面，填写API_TOKEN环境变量。
4. 单击部署，等待 Makers 完成构建并生成访问地址。
二、启动沙箱预览
调用沙箱 getHost(9000) 取得公网 host，再把 envdAccessToken 作为 access_token 拼到链接上，得到沙箱预览地址。
const workspace = createMakersWorkspacePort(context); const previewHost = await workspace.getHost?.(PREVIEW_PUBLIC_PORT); const accessToken = workspace.accessToken; const browserLiveUrl = workspace.browserLiveUrl; return { previewUrl: resolvePreviewUrl({ previewHost, accessToken, browserLiveUrl, pathPrefix: PREVIEW_PATH_PREFIX, }), };
三、集成 Makers SDK 部署
Agent 运行时使用 API_TOKEN 调用 Makers SDK，上传部署包并触发构建与部署。
const deployment = await makers.deployments.deploy({ projectId, artifact: { archive: tmpZip }, wait: true, onStatusChange: (event) => { options.onStage('deploying', event.deployment.status); },});
部署的详细接入流程可参考 Makers SDK。
四、启动本地开发调试
1. 进入项目根目录，安装 EdgeOne CLI：
npm install -g edgeone
2. 登录 EdgeOne，并关联需要调试的 Makers 项目：
edgeone loginedgeone makers link
关联项目后会把控制台配置的 API_TOKEN 和调用 Models 所需的 API Key 自动同步到本地。
3. 启动 Makers 本地开发环境：
edgeone makers dev
启动成功后，访问 http://localhost:8088/ 即可打开应用；访问 http://localhost:8088/agent-metrics 可查看 Agent 调用的详细链路信息。
五、部署项目
如果项目已关联 Git 仓库，推送代码即可触发 Makers 的 CI 构建与部署。也可以通过 CLI 直接部署：
# 部署至生产环境edgeone makers deploy -n <项目名>
部署成功后点击 Console 的链接可以访问具体构建信息和部署后的 URL。