Tool_Agent/tests/tasks/runcomfy_launch_env.json

{
  "description": "RunComfy 机器管理工具：用于按需启动和获取云端 ComfyUI 机器的访问地址",
  "task_spec": "脚本位置：tests/run_comfy/launch_comfy_env.py\n\n## 功能\n调用 RunComfy Server API 启动指定版本的云端机器，并轮询等待机器 Ready。\n这个工具是使用 ComfyUI 的基础设施，启动后需要记录 server_id 以便后续使用和关闭。\n\n## 环境变量\n- RUNCOMFY_USER_ID：RunComfy 用户 ID\n- API_TOKEN：RunComfy API Token\n\n## 命令行参数\n- --version-id：RunComfy workflow version ID，默认 \"90f77137-ba75-400d-870f-204c614ae8a3\"\n- --server-type：机器规格（medium/large/extra-large/2x-large/2xl-turbo），默认 \"medium\"\n- --duration：预估运行时长（秒），默认 3600\n- --timeout：启动超时时间（秒），默认 300\n\n## HTTP 接口需求（用于注册到 Router）\n如果是通过 FastAPI 暴露接口，需要实现 `POST /launch`：\n### 输入 JSON\n- version_id (str, 可选)\n- server_type (str, 可选)\n- duration (int, 可选)\n\n### 输出 JSON\n- server_id: str (机器唯一标识，用于后续操作)\n- comfy_url: str (机器访问地址)\n- status: str (\"Ready\" 或报错信息)\n- usage_instruction: str (返回给大模型的提示词，告知它如何使用这台机器，例如：“请使用 run_comfy_workflow 工具，并传入此 server_id 以及你的 workflow_api.json 来生成图片。用完后请务必调用 stop_comfy_env 工具关闭机器。”)\n\n## 核心逻辑参考\n1. API: `POST https://beta-api.runcomfy.net/prod/api/users/{USER_ID}/servers`\n   Body: `{\"workflow_version_id\": version_id, \"server_type\": server_type, \"estimated_duration\": duration}`\n2. 轮询 API: `GET https://beta-api.runcomfy.net/prod/api/users/{USER_ID}/servers/{server_id}`\n3. Header 需带 `Authorization: Bearer {API_TOKEN}`\n4. 等待字段 `current_status` 变为 `Ready`，并提取 `main_service_url`。",
  "reference_files": [
    "tests/run_comfy/run_workflow.py"
  ]
}