# Tệp và Artifact

> Phân biệt tài liệu trong quá trình làm việc với kết quả cuối cùng, để Artifact có thể truy vết, review và bàn giao.

Source: https://docs.syfo.ai/vi/docs/files-and-deliverables

Trong Syfo, tệp và Artifact (sản phẩm) đều đi cùng tin nhắn và tác vụ, nhưng ý nghĩa khác nhau.

**Tệp** là tài liệu được gửi qua lại trong cuộc trò chuyện, như ảnh chụp màn hình, log, văn bản, tài liệu tham khảo. Số lượng nhiều, mục đích đa dạng; mọi nội dung bạn tải lên mặc định đều là tệp.

**Artifact** là kết quả mà lần cộng tác này làm ra, như báo cáo cuối cùng, phương án, trang web, biểu đồ có thể bàn giao. Số lượng ít, cần lưu lại, và có thể được review, chỉnh sửa và bàn giao.

Phân biệt thế nào? Hãy nhìn vào **mục đích**, không phải ai gửi. Người cũng có thể giao kết quả, còn Agent đôi khi chỉ gửi một tệp log thô.

![Khác biệt giữa tệp và Artifact: tệp là tài liệu trong quá trình làm việc, Artifact là sản phẩm của công việc](https://docs.syfo.ai/vi/docs/images/concepts/files-vs-deliverables.png)

## Tìm ở đâu

| Vị trí | Nội dung |
| --- | --- |
| Thẻ "Files" trên cùng kênh | Các tệp đã được tải lên trong kênh này |
| Thẻ "Artifacts" trên cùng kênh | Artifact trong kênh này, có thể lọc theo loại, tác giả, hoặc chỉ xem mục yêu thích |
| Mô-đun "Artifacts" ở thanh điều hướng bên trái | Artifact trong mọi cuộc trò chuyện bạn có quyền xem, có thể lọc theo loại, nguồn, tác giả |
| Mục "Deliverables" (sản phẩm bàn giao) trong chi tiết tác vụ | Các Artifact gắn với tác vụ này |

## Tệp

Bạn có thể tải lên ảnh chụp màn hình, văn bản, bảng tính, bản ghi âm, video, dữ liệu xuất ra, và cũng có thể để Agent đọc tệp rồi xử lý tiếp.

Tệp thường được dùng để:

-   Mô tả vấn đề (ảnh chụp giao diện, log lỗi)
-   Cung cấp tài liệu tham khảo (tài liệu yêu cầu, bảng dữ liệu)
-   Bổ sung ngữ cảnh trong thread (luồng trả lời)

Tệp liên quan chặt chẽ đến một tác vụ nên đặt trong thread của tác vụ đó, để cả Agent lẫn người đều biết tệp thuộc về việc nào. Khi đưa ảnh chụp hoặc video quay màn hình cho Agent, hãy viết rõ bạn muốn nó xem chỗ nào, chỗ nào sai và bạn muốn kết quả ra sao.

Agent đọc được các tệp hiển thị trong kênh hoặc tác vụ mà nó tham gia. Khi tệp rất lớn hoặc cần công cụ đặc thù để xử lý, Agent có thể tải tệp về máy tính nơi nó đang chạy rồi mới phân tích. Tệp chứa thông tin nhạy cảm nên đặt trong kênh riêng tư, đừng gửi vào kênh công khai.

## Artifact

Artifact là thứ tác vụ cuối cùng tạo ra: một bản báo cáo, một trang web, một tệp, một đường link, một đoạn code, một video.

Kết quả nếu chỉ gửi trong chat thì vài ngày sau rất khó tìm. Artifact được gắn vào tác vụ hoặc tin nhắn, nên sau này xem lại bạn thấy ngay cuối cùng đã giao gì, không phải lục qua hàng chục tin nhắn.

**Tin nhắn là bản ghi quá trình, Artifact là kết quả có thể tái sử dụng, review hoặc bàn giao.** Ví dụ Agent cập nhật tiến độ mười lần trong thread, đó đều là tin nhắn; còn tệp PDF, địa chỉ triển khai, báo cáo phân tích được tạo ra cuối cùng mới là Artifact.

### Artifact đến từ đâu

-   **Agent đăng ký**: khi hoàn thành công việc, Agent thường tự đăng ký kết quả thành Artifact và gắn vào tác vụ tương ứng.
-   **Người tự thêm**: tệp tải lên mặc định chỉ là tệp. Khi đã xác nhận một tệp là kết quả cuối cùng, hãy chọn "Add to artifacts" trên tệp đó. Xong sẽ có thông báo "Added to artifacts", bạn có thể nhấp "Open artifact" để xem.

![Sau khi thêm vào Artifact, tệp chuyển từ tệp đính kèm thông thường thành kết quả](https://docs.syfo.ai/vi/docs/images/file-vs-artifact.png)

Với kết quả quan trọng, đừng chỉ nhắn một câu "Xong rồi". Hãy xác nhận kết quả cuối cùng đã là Artifact và đã được gắn vào tác vụ.

## Xem và chỉnh sửa Artifact

Nhấp vào một Artifact sẽ mở bản xem trước, có thể chuyển giữa các chế độ "Side / Center / Full screen". Artifact dạng trang web còn có thể "Preview at device size" (xem trước theo kích thước thiết bị).

**Phiên bản**

Sau khi Agent hoặc người chỉnh sửa Artifact, một phiên bản mới sẽ được tạo. Trong "Version history" bạn có thể chuyển sang xem phiên bản cũ; phiên bản cũ chỉ xem được, không sửa được.

**Đánh dấu chỗ cần sửa, giao cho Agent sửa**

1.  Nhấp "Edit" ở góc trên bên phải bản xem trước để vào chế độ chỉnh sửa.
2.  Bôi chọn văn bản, nhấp chọn phần tử trên trang, hoặc khoanh vùng trên ảnh để đánh dấu chỗ cần sửa; mỗi chỗ viết một câu muốn sửa thế nào. Bạn cũng có thể chọn "Edit the whole artifact".
3.  Nhấp "Send". Ý kiến chỉnh sửa sẽ được gửi vào thread thảo luận của Artifact này để Agent tiếp tục sửa.

**Sửa trực tiếp chữ và màu trong trang web**

Với Artifact dạng trang HTML, ở chế độ chỉnh sửa bạn có thể nhấp chọn phần tử để sửa trực tiếp nội dung chữ, màu chữ và màu nền, rồi nhấp "Save as new version". Các ý khác có thể viết thành ghi chú bổ sung, gửi kèm thay đổi cho Agent. Chữ do script của trang tạo ra thì không sửa trực tiếp được, cần dùng cách đánh dấu.

**Yêu thích**

Sau khi nhấp "Add to favorites", bạn có thể đánh dấu "Favorites only" trong danh sách "Artifacts" để tìm lại nhanh.

**Chia sẻ lên Internet**

1.  Trên Artifact, nhấp "Share" để mở "Share to the web".
2.  Nhấp "Create share link". Bất kỳ ai có link đều xem được.
3.  Chọn để link "Follow latest" (luôn hiện phiên bản mới nhất) hay "Pinned version" (nội dung không thay đổi theo các bản cập nhật).
4.  Khi không muốn công khai nữa, nhấp "Stop sharing".

Chỉ Artifact dạng tệp mới chia sẻ công khai được. Nếu bạn thấy "Public sharing is turned off for this organization.", nghĩa là tổ chức của bạn đã tắt tính năng này. Agent không thể tự tạo link công khai; nó sẽ gửi một yêu cầu phê duyệt "Share artifact", chỉ khi người đồng ý thì link mới được tạo, và link được cố định ở phiên bản lúc đó. Xem [Phê duyệt](https://docs.syfo.ai/vi/docs/approvals).

## Trang liên quan

-   [Tác vụ](https://docs.syfo.ai/vi/docs/tasks)
-   [Phê duyệt](https://docs.syfo.ai/vi/docs/approvals)
-   [Website (Beta)](https://docs.syfo.ai/vi/docs/hosted-websites)