Đính kèm ảnh vào task
Ảnh gắn vào task đi thẳng vào ngữ cảnh của agent khi nó chạy, không phải chỉ để người xem. Trang này nói nên đính kèm gì, giới hạn thật là bao nhiêu, và khi nào đính kèm không giúp được gì.
Đối tượng: member tạo task từ báo cáo lỗi hoặc từ thiết kế. Điều kiện: bạn là
membertrở lên của Space.
Ảnh đi tới agent bằng đường nào
Điểm đáng nhớ: ảnh được nạp tại thời điểm chạy, không phải lúc tạo task. Thêm ảnh vào một task đang ở Backlog rồi mới bấm Run thì agent vẫn thấy.
Đính kèm khi tạo hoặc sửa task
- Mở hộp thoại New Task (phím
N) hoặc sửa task có sẵn. - Kéo-thả ảnh vào khối Images, hoặc bấm để chọn file.
- Bộ đếm hiện số lượt còn lại (
10 remaining). - Lưu task. Ảnh gắn với task, không gắn với một lần chạy — chạy lại vẫn dùng cùng bộ ảnh.
Giới hạn thật
| Giới hạn | Giá trị | Vượt thì sao |
|---|---|---|
| Số ảnh mỗi task | 10 | 400 Maximum 10 attachments per task |
| Kích thước mỗi ảnh | 10 MB | 400 File too large. Maximum size: 10MB |
| Định dạng | PNG, JPEG, GIF, WebP, SVG | 400 Unsupported file type: <mime> |
Chỉ nhận ảnh. PDF, DOCX và tài liệu nói chung không đi đường này — chúng thuộc Nạp tài liệu và duyệt Wiki, nơi có bước trích xuất và duyệt.
Nên đính kèm cái gì
| Đính kèm | Vì sao có ích |
|---|---|
| Ảnh chụp lỗi kèm thông báo | Agent đọc được chữ trong ảnh, khỏi phải chép tay stack trace |
| Mockup hoặc thiết kế màn hình | Mô tả bằng lời một bố cục tốn nhiều chữ hơn và vẫn mơ hồ |
| Sơ đồ kiến trúc của phần đang sửa | Cho agent bối cảnh mà code không tự nói ra |
| Ảnh chụp trạng thái "đúng" mong muốn | Tiêu chí nghiệm thu dạng nhìn được |
Đừng đính kèm ảnh chụp code — dán code thẳng vào description luôn tốt hơn: agent đọc chính xác, tìm kiếm được, và không tốn phần ngữ cảnh dành cho hình ảnh.
Agent CLI không hỗ trợ đầu vào hình ảnh sẽ bỏ qua ảnh trong im lặng — không có lỗi
nào báo cho bạn. Nghi ngờ thì mô tả nội dung ảnh bằng lời trong description để chắc
chắn, và kiểm ở tab Events xem agent có nhắc tới ảnh không.
Làm qua API
# Tải ảnh lên (multipart)
curl -X POST http://<host>/api/tasks/<taskId>/attachments \
-F 'files=@./loi-dang-nhap.png' \
-F 'files=@./mockup.png'
# Liệt kê ảnh của một task
curl -s http://<host>/api/tasks/<taskId>/attachments
# Tải một ảnh về
curl -s -o anh.png http://<host>/api/attachments/<attachmentId>/file
# Xoá một ảnh
curl -X DELETE http://<host>/api/attachments/<attachmentId>
Mã lỗi đầy đủ: Mã lỗi API.
Việc bạn KHÔNG làm được ở trang này (và vì sao)
| Bạn thử | Kết quả | Vì sao |
|---|---|---|
| Đính kèm PDF hoặc DOCX | 400 Unsupported file type | Tài liệu đi qua pipeline Wiki để có trích xuất và duyệt, không đi thẳng vào prompt |
| Đính kèm ảnh thứ 11 | 400 Maximum 10 attachments per task | Chặn phình ngữ cảnh; nhiều ảnh không làm agent hiểu hơn |
| Mong agent trả về ảnh | Không có | Agent trả về thay đổi code và văn bản, không sinh ảnh |
Checklist tự xác minh
- Ảnh hiện trong khối Images sau khi lưu task.
-
GET /api/tasks/<taskId>/attachmentsliệt kê đúng số ảnh. - Chạy agent rồi mở tab Events — nội dung cho thấy agent có dùng thông tin từ ảnh.
- Nếu không: mô tả lại nội dung ảnh bằng lời trong
descriptionrồi chạy lại.
Gặp lỗi? Xử lý sự cố