Public/Get-OAIGPTConfiguration.ps1

Function Get-OAIGPTConfiguration {
    <#
        .SYNOPSIS
        Retrieves GPT configurations from the OpenAI Compliance API.
 
        .DESCRIPTION
        Retrieves all configuration versions for a specific GPT from the ChatGPT Enterprise compliance API.
 
        .PARAMETER GPTId
        The ID of the GPT whose configurations to retrieve.
 
        .PARAMETER Top
        Limits the number of configurations to retrieve.
 
        .INPUTS
        System.String
         
        .OUTPUTS
        System.Object[]
 
        .EXAMPLE
        Get-OAIGPTConfiguration -GPTId "gpt-123456789"
 
        .EXAMPLE
        Get-OAIGPTConfiguration -GPTId "gpt-123456789" -Top 10
 
    #>

    [CmdletBinding()]
    [OutputType([System.Object[]])]
    param(
        [Parameter(Mandatory=$true, Position=0)]
        [string]$GPTId,
        [Parameter(Mandatory=$false, Position=1)]
        [ValidateRange(1, [int]::MaxValue)]
        [int]$Top
    
    )
    Begin {
        Write-Debug "Validating OpenAI Compliance client initialization"
        If (!$script:client) {
            Write-Error "OpenAI Compliance client not initialized. Please run Initialize-OAICompliance first." -ErrorAction Stop
            
        }
        Write-Debug "Creating OAI GPT manager"
        $gpt_manager = [OAIGPT]::new($script:client)

    } Process {
        Write-Debug "Retrieving GPT configurations for GPTId: $gptId"
        Try {
            If ($top) {
                $response = $gpt_manager.GetGPTConfigurations($gptId, $top)
            
            } Else {
                $response = $gpt_manager.GetGPTConfigurations($gptId, $null)
            
            }
            Write-Debug "Response retrieved successfully"
                
        } Catch {
            Write-Error "Error retrieving GPT configurations: $($_.Exception.Message)" -ErrorAction Stop
        
        }

    } End {
        Write-Debug "Successfully retrieved GPT configurations"
        $response
    
    }
}