任務、發布與綁定

需要 company manager。受限 API key 對 tasks / bindings 一律 404。

步驟

建任務 — POST /tasks（SandboxTaskCreateRequest）：
- name 1–256、description ≤2048。
- owner_scope：chatroom / department / company；owner_id：對應的 id。
- agent_enabled（預設 false）：是否允許 Agent 提交此任務（見 Agent 確認流程）。
建任務版本（draft） — POST /tasks/{task_id}/versions（SandboxTaskVersionCreateRequest）：
- environment_version_id：綁定一個 ready 的環境版本。
- startup_script / work_script（各 ≤1 MiB）、ordinary_env（≤100 名稱、每項 ≤64 KiB）。
- input_instructions / input_example（≤64 KiB，給使用者看的說明）。
- timeout_seconds（預設 1800，ge=1，le≈7天）。
- secret_slot_declarations：宣告需要的 secret slot（見 Secret）。
- requires_confirmation（預設 false）：Agent 提交是否需要人為確認。
編輯 draft（選）— PATCH /tasks/{task_id}/versions/{vid}（僅 draft 可改）。
發布 — POST /tasks/{task_id}/versions/{vid}/publish → state: "published"。只有 published 才能綁定/執行。
分享（選，跨部門/公司/聊天室）— POST /tasks/{task_id}/shares（target_kind + target_id）。撤銷：.../shares/{grant_id}/revoke。
綁定到聊天室 — POST /bindings（chatroom_id + task_id + task_version_id）。把「已發布的某個版本」釘進聊天室。

綁定會釘住精確版本。任務出了新版本時，binding 的 update_available 會變 true。
要升級到新版本，明確呼叫 POST /bindings/{binding_id}/accept-version（task_version_id）——不會自動跳版。
撤銷綁定：POST /bindings/{binding_id}/revoke。