runcomfy_stop_env.json 1.3 KB

1234567
  1. {
  2. "description": "RunComfy 环境销毁工具:根据 server_id 主动关闭已启动的 ComfyUI 机器,避免持续计费",
  3. "task_spec": "脚本位置:tests/run_comfy/stop_comfy_env.py\n\n## 功能\n调用 RunComfy Server API 删除指定的机器实例,释放资源。配合 `launch_comfy_env` 使用,负责生命周期的收尾阶段。\n\n## 环境变量\n- RUNCOMFY_USER_ID:RunComfy 用户 ID\n- API_TOKEN:RunComfy API Token\n\n## 命令行参数\n- --server-id:(必填) 要关闭的机器 ID\n\n## HTTP 接口需求(用于注册到 Router)\n如果作为服务接口,实现 `POST /stop`:\n### 输入 JSON\n- server_id: str (必填,需关闭的机器)\n\n### 输出 JSON\n- server_id: str (关闭的机器 ID)\n- status: str (\"Deleted\" 或报错信息)\n- message: str (详细结果文本)\n\n## 核心逻辑参考\n1. 调用 API `DELETE https://beta-api.runcomfy.net/prod/api/users/{USER_ID}/servers/{server_id}`\n2. Header 需要 `Authorization: Bearer {API_TOKEN}`\n3. 处理 200 响应和 404 响应(说明已被清理或不存在),如果是其它错误,则抛出异常并返回失败状态。\n4. 这个工具应始终返回安全的明确状态,供 Agent 确认释放情况。",
  4. "reference_files": [
  5. "tests/run_comfy/run_workflow.py"
  6. ]
  7. }