Skip to content

Class ZCL_LLM_CLIENT_AZUREOAI

AI Generated documentation.

Overview

Provides Azure OpenAI client implementation for SAP ABAP systems, handling API communication and authentication. Inherits from base client class ZCL_LLM_CLIENT_BASE.

Key Public Methods:

  1. GET_CLIENT
  2. Factory method creating client instances
  3. Validates configurations via parent constructor

  4. Raises ZCX_LLM_VALIDATION/ZCX_LLM_AUTHORIZATION for configuration errors

  5. CONSTRUCTOR

  6. Initializes client with provider-specific settings
  7. Inherits validation logic from parent class

Core Capabilities:

  • Secure API key handling with encryption support
  • Dynamic endpoint construction
  • JSON structured response generation

Dependencies

  1. ZCL_LLM_HTTP_CLIENT_WRAPPER - HTTP client management
  2. ZCL_LLM_SO_JS_AZUREOAI - Azure-specific JSON response handler
  3. ZCL_LLM_COMMON - BAdI access for encryption implementations
  4. Custom encryption class via BAdI GET_ENCRYPTION_IMPL

Details

Authentication Flow

sequenceDiagram
    participant Client
    participant SET_AUTH
    participant BAdI
    participant Encryption
    Client->>SET_AUTH: Execute auth setup
    SET_AUTH->>BAdI: get_encryption_impl()
    BAdI-->>Encryption: Instance
    SET_AUTH->>Encryption: decrypt(api_key)
    SET_AUTH->>HTTP Client: Set header api-key=<decrypted>

Key Implementation Notes:

  1. Endpoint Construction: 
|/{model}/chat/completions?api-version={api_version}|

Uses constant API_VERSION (2024-10-21) for versioning

  1. Encrypted Credentials:
  2. Decrypts AUTH_ENCRYPTED via BAdI-implemented encryption class

  3. Supports clear-text fallback if encryption not used

  4. Structured Output:
    Instantiates Azure-specific JSON parser ZCL_LLM_SO_JS_AZUREOAI

  5. HTTP Client Management:
    Delegates to wrapper class for:

  6. Connection pooling
  7. SSL configuration
  8. Proxy handling

Exception Strategy:

  • Parent class handles common validation errors
  • Custom authorization errors when:
  • Encrypted API key decryption fails
  • Invalid authentication type configuration