{
  "endpoints": [
    {
      "method": "POST",
      "path": "/api/sql-chat",
      "description": "V1 - AI Data Analyst: Nhận câu hỏi, sinh SQL, chạy lệnh và trả về dữ liệu cùng cấu hình biểu đồ.",
      "request": {
        "question": "Doanh thu theo nhóm tuổi?",
        "history": [],
        "model": "codex/gpt-5.3-codex"
      },
      "response": {
        "sql": "SELECT age_by_product, SUM(quantity_sold) ...",
        "data": [...],
        "chart_type": "pie",
        "x_key": "age_by_product",
        "y_keys": ["sum_qty"]
      }
    },
    {
      "method": "POST",
      "path": "/api/sql-dashboard",
      "description": "V1 - Sinh Dashboard: Trả về dữ liệu qua SSE (Server-Sent Events) cho từng Widget.",
      "response_type": "text/event-stream"
    },
    {
      "method": "POST",
      "path": "/api/text-to-sql/chat (Agent V2)",
      "description": "V2 - Gọi qua agent text_to_sql. RAG bằng Vector search thay vì sinh SQL. Trả lời tư vấn thân thiện."
    }
  ]
}