{
    "title": "Feedback & Diagram Agents",
    "description": "Tìm hiểu cách hệ thống phân loại phản hồi từ người dùng và Agent chuyên biệt để tạo sơ đồ kỹ thuật.",
    "diagram": "diagrams/feedback-pipeline.svg",
    "sections": [
        {
            "title": "Hệ thống Phân loại Feedback",
            "type": "text",
            "content": "Mỗi khi người dùng Like/Dislike hoặc để lại bình luận, request được gửi tới <code>/api/feedback</code>. Server phản hồi ngay lập tức và đẩy xử lý vào Background Task:<br>1. Sử dụng <b>GPT-4o-mini</b> để phân tích cảm xúc và phân loại lỗi (sai sản phẩm, lỗi logic, v.v.).<br>2. Đẩy điểm số (score) lên <b>Langfuse</b> gắn với <code>trace_id</code> để theo dõi chất lượng LLM.<br>3. Lưu vào cơ sở dữ liệu local để Admin kiểm tra định kỳ."
        },
        {
            "title": "Diagram Agent",
            "type": "text",
            "content": "Module Diagram Agent cho phép người dùng mô tả kiến trúc và nhận lại mã <b>Mermaid</b> để hiển thị sơ đồ. Agent sử dụng mô hình 2-Agent (Planner và Responder) để đảm bảo độ chính xác của cú pháp sơ đồ."
        },
        {
            "title": "API Endpoints",
            "type": "api",
            "endpoints": [
                { "method": "POST", "path": "/api/feedback", "description": "Gửi phản hồi Like/Dislike/Comment." },
                { "method": "GET", "path": "/api/feedback/stats", "description": "Xem thống kê phản hồi theo category." },
                { "method": "POST", "path": "/api/diagram/chat", "description": "Chat với Agent để sinh sơ đồ Mermaid." }
            ]
        }
    ]
}
