source/src/domain/functions/predict_function.json

{
  "name": "predict_transportation_mode",
  "description": "Dự đoán phương thức vận chuyển tối ưu dựa trên thông tin dự án, quốc gia, giá cả và nhà cung cấp. API sẽ gợi ý phương thức vận chuyển phù hợp nhất (Air, Air Charter, Ocean, Truck) cùng với độ tin cậy và các lựa chọn thay thế. Sử dụng machine learning model được train từ dữ liệu historical logistics để đưa ra dự đoán chính xác.",
  "parameters": {
    "type": "object",
    "properties": {
      "project_code": {
        "type": "string",
        "description": "Mã dự án cần vận chuyển. Ví dụ: '100-CI-T01', '200-DH-M05'. Đây là identifier duy nhất cho mỗi dự án logistics."
      },
      "country": {
        "type": "string", 
        "description": "Quốc gia đích cần giao hàng. Ví dụ: 'Vietnam', 'Nigeria', 'Kenya'. Sử dụng tên tiếng Anh đầy đủ của quốc gia."
      },
      "pack_price": {
        "type": "number",
        "description": "Giá trị mỗi gói hàng tính bằng USD. Ví dụ: 50.0, 120.5. Giá trị này ảnh hưởng đến quyết định phương thức vận chuyển."
      },
      "vendor": {
        "type": "string",
        "description": "Tên nhà cung cấp hoặc nhà sản xuất. Ví dụ: 'ABBOTT LABORATORIES', 'PFIZER INC'. Sử dụng tên đầy đủ chính thức của công ty."
      },
      "weight_kg": {
        "type": "number",
        "description": "Khối lượng thực tế của lô hàng tính bằng kg. Không bắt buộc - hệ thống sẽ ước tính dựa trên line_item_quantity nếu không có. Ví dụ: 25.0, 100.5"
      },
      "freight_cost_usd": {
        "type": "number", 
        "description": "Chi phí vận chuyển dự kiến tính bằng USD. Không bắt buộc - hệ thống sẽ ước tính dựa trên weight và pack_price nếu không có. Ví dụ: 500.0, 1200.75"
      },
      "delivery_date": {
        "type": "string",
        "description": "Ngày giao hàng mong muốn theo định dạng YYYY-MM-DD. Không bắt buộc - sử dụng ngày hiện tại nếu không có. Ví dụ: '2025-08-20', '2025-12-15'"
      },
      "line_item_quantity": {
        "type": "number",
        "description": "Số lượng sản phẩm để hỗ trợ ước tính khối lượng khi weight_kg không có. Mặc định là 100. Ví dụ: 100, 500, 1000"
      }
    },
    "required": ["project_code", "country", "pack_price", "vendor"]
  }
}