Class ZCL_LLM_FACTORY

AI Generated documentation.

Overview

The ZCL_LLM_FACTORY class is a singleton factory responsible for creating LLM (Large Language Model) client instances based on configured models and providers. Its core functionality is exposed via the interface ZIF_LLM_FACTORY, with the key public method:

• ZIF_LLM_FACTORY~GET_CLIENT:
  Instantiates an LLM client for a specified model after validating:
• Model configuration existence
• Provider registration
• Authorization (via injected ZIF_LLM_AUTH implementation)
  Raises ZCX_LLM_VALIDATION exceptions for invalid configurations.

The class initializes its authorization component during CLASS_CONSTRUCTOR via a BAdI implementation.

Dependencies

• Database tables:
• ZLLM_CLNT_CONFIG: Stores model-to-provider mappings
• ZLLM_PROVIDERS: Registry of available LLM provider implementations
• Authorization: BAdI-driven implementation of ZIF_LLM_AUTH
• Exception class: ZCX_LLM_VALIDATION for error signaling

Details

flowchart TD  
    A[get_client] --> B[Authorization Check]  
    B --> C{Model Exists?}  
    C -->|No| D[Raise model_does_not_exist]  
    C -->|Yes| E{Provider Registered?}  
    E -->|No| F[Raise provider_does_not_exist]  
    E -->|Yes| G[Dynamic Client Instantiation]  
    G --> H[Call provider_class~ZIF_LLM_CLIENT~GET_CLIENT]  

Key implementation characteristics:

1. Dynamic Client Creation:
   Uses runtime method call (provider_class)=>ZIF_LLM_CLIENT~GET_CLIENT to decouple factory from concrete implementations.

2. Validation Sequence:

3. Authorization precedes model validation, indicating potential security-first design

4. Provider check uses model's configured provider name from ZLLM_CLNT_CONFIG

5. Test Critical Points:

6. Database table integrity (as shown in test double configuration)
7. Exception type differentiation through ZCX_LLM_VALIDATION subtypes
8. Provider implementation registry consistency

Security Integration:
Authorization implementation is resolved via ZCL_LLM_COMMON=>GET_LLM_BADI( ), allowing flexible authentication/authorization strategies without factory modification.