File size: 1,570 Bytes
e039c53
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
from typing import Dict, List, Optional, Any
from dataclasses import dataclass

@dataclass
class ModelResponse:
    """Đầu ra chuẩn hóa từ AI Model"""
    status: str  # "SUCCESS" hoặc "FAILED"
    orders: Dict[str, Any]  # Key: serial_number, Value: VDA5050 Order dict
    raw_response: str  # Phản hồi thô của model
    latency_ms: float  # Thời gian gọi API (ms)
    error_message: Optional[str] = None

class BaseModelAdapter:
    """Lớp cơ sở trừu tượng cho tất cả AI Model Adapters"""
    
    def __init__(self, api_key: Optional[str] = None):
        self.api_key = api_key

    def generate_orders(
        self,
        factory_layout: Dict[str, Any],
        agv_states: List[Dict[str, Any]],
        transport_requests: List[Dict[str, Any]],
        constraints: Dict[str, Any]
    ) -> ModelResponse:
        """
        Gửi ngữ cảnh kịch bản cho Model và yêu cầu trả về danh sách VDA5050 Orders cho các xe.

        Args:
            factory_layout: Bản đồ nhà máy (nodes, edges, obstacles, zones)
            agv_states: Trạng thái hiện tại của tất cả AGVs
            transport_requests: Các đơn hàng vận chuyển cần xử lý
            constraints: Ràng buộc kịch bản (max_time, collision_tolerance...)

        Returns:
            ModelResponse: Đối tượng chứa chỉ thị di chuyển dạng VDA5050 và thông số hiệu năng
        """
        raise NotImplementedError("Hãy override phương thức generate_orders() trong class adapter con.")