Class: DSPy::LM::Strategies::OpenAIStructuredOutputStrategy

Inherits:
BaseStrategy
  • Object
show all
Extended by:
T::Sig
Defined in:
lib/dspy/lm/strategies/openai_structured_output_strategy.rb

Overview

Strategy for using OpenAI’s native structured output feature

Instance Method Summary collapse

Methods inherited from BaseStrategy

#initialize

Constructor Details

This class inherits a constructor from DSPy::LM::Strategies::BaseStrategy

Instance Method Details

#available? ⇒ Boolean

Returns:

  • (Boolean) 


13
14
15
16
17
18
19
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 13

def available?
  # Check if adapter is OpenAI and supports structured outputs
  return false unless adapter.is_a?(DSPy::LM::OpenAIAdapter)
  return false unless adapter.instance_variable_get(:@structured_outputs_enabled)
  
  DSPy::LM::Adapters::OpenAI::SchemaConverter.supports_structured_outputs?(adapter.model)
end

#extract_json(response) ⇒ Object 



39
40
41
42
43
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 39

def extract_json(response)
  # With structured outputs, the response should already be valid JSON
  # Just return the content as-is
  response.content
end

#handle_error(error) ⇒ Object 



46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 46

def handle_error(error)
  # Handle OpenAI-specific structured output errors
  if error.message.include?("response_format") || error.message.include?("Invalid schema")
    # Log the error and return true to indicate we handled it
    # This allows fallback to another strategy
    DSPy.logger.warn("OpenAI structured output failed: #{error.message}")
    true
  else
    false
  end
end

#name ⇒ Object 



27
28
29
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 27

def name
  "openai_structured_output"
end

#prepare_request(messages, request_params) ⇒ Object 



32
33
34
35
36
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 32

def prepare_request(messages, request_params)
  # Add structured output format to request
  response_format = DSPy::LM::Adapters::OpenAI::SchemaConverter.to_openai_format(signature_class)
  request_params[:response_format] = response_format
end

#priority ⇒ Object 



22
23
24
 
# File 'lib/dspy/lm/strategies/openai_structured_output_strategy.rb', line 22

def priority
  100 # Highest priority - native structured outputs are most reliable
end