Document Review thực hiện những gì
Document Review xem xét Tài liệu của bạn theo nhiều khía cạnh khác nhau: Cấu trúc và tổ chức:- Luồng logic và tiến trình
- Cấp độ tiêu đề và tính nhất quán
- Cân bằng và nhịp độ giữa các mục
- Kiến trúc thông tin
- Độ phức tạp và độ dài câu
- Việc sử dụng thuật ngữ chuyên môn
- Các chuyển đoạn giữa ý tưởng
- Điểm đánh giá tổng thể về khả năng đọc
- Thiếu bối cảnh hoặc thông tin nền
- Khoảng trống trong giải thích
- Câu hỏi chưa được trả lời
- Những phần cần mở rộng
- Tính nhất quán về giọng văn
- Vấn đề định dạng
- Lặp lại và thừa
- Cơ hội để cải thiện
Cách kích hoạt Document Review
Craft Assistant sẽ đọc toàn bộ Tài liệu của bạn và cung cấp phản hồi có cấu trúc, được sắp xếp theo từng danh mục.
Document Review hoạt động với tất cả các mô hình, nhưng Max cung cấp phản hồi sâu và tinh tế nhất, đặc biệt cho các Tài liệu dài hoặc phức tạp. Đối với kiểm tra nhanh, Fast đem lại sự cân bằng tốt giữa độ sâu và tốc độ.
Document Review so với trò chuyện chung với Assistant
| Feature | Document Review | General Assistant Chat |
|---|---|---|
| Purpose | Phản hồi có cấu trúc cho Tài liệu | Hội thoại và nhiệm vụ mở |
| Scope | Phân tích toàn bộ Tài liệu | Trả lời các câu hỏi cụ thể |
| Output format | Sắp xếp theo các danh mục phản hồi | Phản hồi dạng hội thoại |
| Analysis depth | Toàn diện, đa chiều | Tập trung vào câu hỏi cụ thể của bạn |
| Best for | Kiểm tra chất lượng, đánh giá trước khi xuất bản | Chỉnh sửa nhanh, tóm tắt, truy vấn nội dung |
| Follow-up prompts | Có thể hỏi câu làm rõ | Hội thoại liên tục |
| Credit usage | Nhiều hơn (phân tích toàn bộ Tài liệu) | Thay đổi theo độ phức tạp truy vấn |
Khi nào nên dùng Document Review
Document Review mang lại giá trị cao nhất trong các tình huống sau:Trước khi chia sẻ ra ngoài
Đánh giá bài thuyết trình, đề xuất hoặc Tài liệu hướng tới khách hàng để phát hiện vấn đề cấu trúc, phần không rõ ràng hoặc thiếu bối cảnh trước khi gửi đi.Đảm bảo chất lượng
Chạy đánh giá định kỳ trên tài liệu quan trọng, wiki đội hoặc bài viết cơ sở kiến thức để duy trì chất lượng và tính nhất quán theo thời gian.Cải thiện nội dung
Nhận đề xuất khả thi cho bài đăng blog, báo cáo hoặc bài viết dài. Craft Assistant có thể xác định những phần cần mở rộng, đơn giản hóa hoặc cấu trúc lại.Chuẩn bị hợp tác
Trước khi chia sẻ với đồng đội, hãy đảm bảo Tài liệu rõ ràng, đầy đủ và tổ chức tốt. Điều này giảm tần suất trao đổi đi lại và nâng cao hiệu quả hợp tác.Học tập và phát triển kỹ năng
Dùng đánh giá để hiểu các mô hình trong cách viết của bạn – những vấn đề rõ ràng lặp đi lặp lại, xu hướng cấu trúc, hoặc các điểm bạn thường cần cải thiện.Bạn có thể chạy Document Review nhiều lần. Chỉnh sửa theo phản hồi, sau đó đánh giá lại để xem các vấn đề đã được giải quyết hay chưa. Cách tiếp cận lặp này giúp bạn học được điều gì hiệu quả và dần hoàn thiện nội dung.
Hiểu về các phản hồi
Phản hồi từ Document Review được sắp xếp theo các danh mục rõ ràng. Đây là cách hiểu và hành động dựa trên từng loại phản hồi:Phản hồi về cấu trúc
Nội dung phản hồi: Mức độ mạch lạc của nội dung, liệu các phần có cân bằng hay không, và kiến trúc thông tin có hợp lý không. Ví dụ phản hồi:- “Phần mở đầu quá dài so với phần còn lại của Tài liệu”
- “Phần 3 thiếu chuyển đoạn rõ ràng từ Phần 2”
- “Cấp độ tiêu đề nhảy từ H2 sang H4”
Phản hồi về độ rõ ràng
Nội dung phản hồi: Viết của bạn có dễ hiểu không, câu có quá phức tạp, và nơi người đọc có thể bị bối rối. Ví dụ phản hồi:- “Đoạn này dùng thể bị động quá nhiều, khiến khó theo dõi”
- “Thuật ngữ chuyên môn trong phần đầu có thể gây khó hiểu cho người không chuyên”
- “Độ dài câu trung bình là 35 từ – hãy cân nhắc tách câu ngắn hơn”
Phản hồi về tính đầy đủ
Nội dung phản hồi: Những khoảng trống trong nội dung – thiếu bối cảnh, câu hỏi chưa trả lời hoặc phần cần chi tiết hơn. Ví dụ phản hồi:- “Tài liệu đề cập đến ‘quy trình mới’ nhưng chưa định nghĩa nó”
- “Bước 2 và 3 giả định kiến thức trước đó không được trình bày trong phần giới thiệu”
- “Không có phần kết luận hoặc bước tiếp theo”
Phản hồi về chất lượng
Nội dung phản hồi: Tính nhất quán về giọng văn, vấn đề định dạng và cơ hội để hoàn thiện nội dung. Ví dụ phản hồi:- “Giọng văn chuyển từ chính thức sang thân mật giữa các phần”
- “Các bullet point định dạng không nhất quán (một số kết thúc bằng dấu chấm, một số không)”
- “Khái niệm này được giải thích hai lần – cân nhắc gộp lại”
Sử dụng credit
Document Review tiêu thụ credit AI dựa trên độ dài và độ phức tạp của Tài liệu:| Document Length | Approx. Credit Cost (Fast) | Approx. Credit Cost (Max) |
|---|---|---|
| Short (< 500 words) | ~0.5 credits | ~1-2 credits |
| Medium (500-2000 words) | ~1-2 credits | ~3-5 credits |
| Long (2000-5000 words) | ~2-4 credits | ~6-10 credits |
| Very long (5000+ words) | ~5+ credits | ~12+ credits |
Đây là ước tính dựa trên các Tài liệu điển hình. Mức sử dụng thực tế phụ thuộc vào cấu trúc Tài liệu, độ phức tạp định dạng và mô hình bạn chọn. Kiểm tra số dư credit trong menu của Assistant.
Mẹo để có đánh giá tốt hơn
1. Chuẩn bị Tài liệu trước Hãy đảm bảo Tài liệu của bạn tương đối hoàn chỉnh trước khi chạy đánh giá. Craft Assistant đưa ra phản hồi tốt hơn với bản thảo hoàn chỉnh hơn là dàn ý sơ bộ. 2. Xác định độc giả của bạn Trong một prompt theo sau, cho Craft Assistant biết tài liệu dành cho ai:- “Tài liệu này dành cho đội kỹ thuật đã quen với sản phẩm”
- “Độc giả là các bên không chuyên kỹ thuật”
- “Viết cho người dùng mới chưa từng dùng Craft”
- “3 vấn đề nào tôi nên sửa trước?”
- “Vấn đề cấu trúc nào là quan trọng nhất?”
- “Chỉ tập trung vào vấn đề độ rõ ràng”
- “Đánh giá giọng văn xem có nhất quán không”
- “Chỉ kiểm tra tính đầy đủ và bối cảnh thiếu”
- “Tập trung vào việc cấu trúc có phù hợp cho người mới bắt đầu không”
- On-device: Không khuyến nghị cho Document Review (bối cảnh hạn chế)
- Core: Kiểm tra cấu trúc nhanh cho Tài liệu ngắn
- Fast: Cân bằng tốt cho hầu hết đánh giá (500-2000 từ)
- Max: Tốt nhất cho Tài liệu dài, phức tạp hoặc khi cần phản hồi chi tiết nhất
Ví dụ: Trước khi xuất bản một bài blog
Sarah viết một bài blog về cách dùng Bộ sưu tập trong Craft. Trước khi xuất bản, cô muốn đảm bảo bài viết rõ ràng và đầy đủ.Craft Assistant phân tích Tài liệu và đưa ra phản hồi:
- Cấu trúc: “Phần mở đầu mạnh, nhưng Phần 2 dài gấp đôi Phần 3 và 4 cộng lại. Hãy cân nhắc chia nó thành hai phần.”
- Độ rõ ràng: “Một số thuật ngữ kỹ thuật (relations, properties, views) được dùng trước khi định nghĩa. Thêm mục chú giải thuật ngữ hoặc định nghĩa khi dùng lần đầu.”
- Tính đầy đủ: “Bài viết giải thích Bộ sưu tập là gì nhưng chưa đề cập khi nào nên dùng nó thay vì folder hoặc tag.”
- Chất lượng: “Giọng văn nhất quán. Có một đoạn lặp lại ở cuối nhắc lại phần mở đầu – cân nhắc loại bỏ.”
Sarah điều chỉnh theo phản hồi: chia Phần 2, thêm định nghĩa, bổ sung mục “Khi nào nên dùng Bộ sưu tập”, và loại bỏ phần lặp.