Clip cho cả danh mục sản phẩm

Mục tiêu

Làm mỗi sản phẩm một clip ngắn từ bảng tính danh mục sản phẩm.

Trước khi bắt đầu

• Một token ở chế độ execute cho cả workspace.
• Mẫu nhập liệu đã điền, mỗi dòng một sản phẩm, kèm đường dẫn ảnh mà người bán có quyền sử dụng.

Thứ tự gọi MCP

Giá trị trong ngoặc nhọn là chỗ cần điền. Mỗi thao tác ghi dùng một request_key mới (UUIDv4); chỉ dùng lại key khi thử lại đúng lời gọi đó.

1. get_workspace

   Đọc mã workspace và vai trò của bạn.

   {}

2. get_import_template

   Lấy mẫu bảng tính: các cột và một tệp .xlsx trống.

   {
     "workspace_id": "<workspace_id from get_workspace>"
   }

3. preview_import

   Đọc bảng tính đã điền (tối đa 4 MB và 100 dòng) thành các dòng. Chưa có gì được tạo.

   {
     "workspace_id": "<workspace_id from get_workspace>",
     "xlsx_base64": "<filled template as base64>"
   }

4. import_project_rowChỉ sau khi người dùng đồng ý

   Với một dòng: tạo dự án và tải ảnh từ các đường dẫn công khai. rights_confirmed: true ghi nhận lời xác nhận của người dùng rằng họ được dùng chữ và ảnh đó.

   {
     "workspace_id": "<workspace_id from get_workspace>",
     "fields": {
       "...": "<fields of one row as returned by preview_import>"
     },
     "image_urls": [
       "<product photo URL>"
     ],
     "rights_confirmed": true,
     "request_key": "<stored key of this row>"
   }

5. agent_preflight

   Trên dự án của dòng: kiểm tra điểm chặn và đọc next_calls.

   {
     "project_id": "<project_id of this row>"
   }

6. read_external_context

   Đọc ngữ cảnh dự án của dòng.

   {
     "project_id": "<project_id of this row>"
   }

7. submit_external_composition

   Gửi storyboard cho sản phẩm này kèm ảnh của nó.

   {
     "project_id": "<project_id of this row>",
     "expected_project_revision": "<project revision from the context>",
     "expected_composition_revision": "<composition revision from the context>",
     "context_handle": "<context_handle>",
     "context_hash": "<context_hash>",
     "composition": {
       "shots": [
         {
           "reference_asset_ids": [
             "<asset_id of the row photo>"
           ],
           "...": "<fields from the schema in the context>"
         }
       ]
     },
     "client_task_id": "<row number>",
     "request_key": "<new UUIDv4>"
   }

8. create_quote

   Báo giá dòng này. Gom báo giá của mọi dòng rồi cho người dùng xem cả danh sách.

   {
     "project_id": "<project_id of this row>",
     "composition_id": "<composition_id>",
     "candidates": 1,
     "request_key": "<new UUIDv4>"
   }

9. approve_productionChỉ sau khi người dùng đồng ý

   Chỉ với các dòng người dùng đã đồng ý.

   {
     "project_id": "<project_id of this row>",
     "quote_id": "<quote_id>",
     "expected_content_hash": "<content_hash from the quote>",
     "request_key": "<new UUIDv4>"
   }

10. list_available_media

    Khi lượt chạy của dòng ở trạng thái READY, đọc clip đã xác minh.

    {
      "project_id": "<project_id of this row>",
      "run_id": "<run_id from approve_production>"
    }

11. prepare_delivery

    Chuẩn bị gói bàn giao của dòng.

    {
      "project_id": "<project_id of this row>",
      "run_id": "<run_id from approve_production>",
      "request_key": "<new UUIDv4>"
    }

12. issue_deliveryChỉ sau khi người dùng đồng ý

    Chỉ sau khi người dùng đã kiểm tra các clip.

    {
      "project_id": "<project_id of this row>",
      "run_id": "<run_id from approve_production>",
      "confirmed": true,
      "request_key": "<new UUIDv4>"
    }

Người dùng duyệt gì

• Quyền dùng chữ và ảnh, trước lần gọi import_project_row đầu tiên.
• Danh sách báo giá theo từng dòng, trước mọi lần gọi approve_production.
• Các clip, trước issue_delivery.

Kết quả

• Mỗi dòng sản phẩm một dự án và một clip.
• Một bảng agent giữ và cho người dùng xem: dòng, dự án, báo giá, lượt chạy và bàn giao.

Lưu ý

• Chưa có tool tạo nhiều video hoàn chỉnh trong một lần gọi. Agent lặp lại các lời gọi từ import_project_row đến issue_delivery cho từng dòng, mỗi sản phẩm một dự án. Để làm nhiều clip ngắn từ một bảng, không cần storyboard cho từng sản phẩm, hãy dùng lô clip. Lô bàn giao (create_delivery_batch) chỉ gom các video đã xong để tải về.
• Lưu một request_key cho mỗi dòng và mỗi lời gọi. Sau khi hết thời gian chờ, thử lại bằng key đã lưu để một dòng không bao giờ bị tạo hay sản xuất hai lần.
• Sau WRITE_OUTCOME_UNKNOWN, đọc dự án của dòng trước; không bao giờ tạo lại.