Package org.springframework.ai.openai

Class OpenAiChatOptions

java.lang.Object

org.springframework.ai.openai.OpenAiChatOptions

All Implemented Interfaces:

ChatOptions, ModelOptions, ToolCallingChatOptions

public class OpenAiChatOptions
extends Object
implements ToolCallingChatOptions

Options for the OpenAI Chat API.

Since:

0.8.0

Author:

Christian Tzolov, Mariusz Bernacki, Thomas Vitale, Ilayaperumal Gopinathan

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpenAiChatOptions.Builder

Field Summary

Fields inherited from interface org.springframework.ai.model.tool.ToolCallingChatOptions

DEFAULT_TOOL_EXECUTION_ENABLED

Constructor Summary

Constructors

Constructor	Description
OpenAiChatOptions()

Method Summary

Modifier and Type	Method	Description
static OpenAiChatOptions.Builder	builder()	A builder to create a new ToolCallingChatOptions instance.
OpenAiChatOptions	copy()	Returns a copy of this ChatOptions.
boolean	equals(Object o)
static OpenAiChatOptions	fromOptions(OpenAiChatOptions fromOptions)
Double	getFrequencyPenalty()	Returns the frequency penalty to use for the chat.
Map<String,String>	getHttpHeaders()
Boolean	getInternalToolExecutionEnabled()	Whether the ChatModel is responsible for executing the tools requested by the model or if the tools should be executed directly by the caller.
Map<String,Integer>	getLogitBias()
Boolean	getLogprobs()
Integer	getMaxCompletionTokens()
Integer	getMaxTokens()	Returns the maximum number of tokens to use for the chat.
Map<String,String>	getMetadata()
String	getModel()	Returns the model to use for the chat.
Integer	getN()
OpenAiApi.ChatCompletionRequest.AudioParameters	getOutputAudio()
List<String>	getOutputModalities()
Boolean	getParallelToolCalls()
Double	getPresencePenalty()	Returns the presence penalty to use for the chat.
String	getReasoningEffort()
ResponseFormat	getResponseFormat()
Integer	getSeed()
List<String>	getStop()
List<String>	getStopSequences()	Returns the stop sequences to use for the chat.
Boolean	getStore()
OpenAiApi.ChatCompletionRequest.StreamOptions	getStreamOptions()
Boolean	getStreamUsage()
Double	getTemperature()	Returns the temperature to use for the chat.
List<ToolCallback>	getToolCallbacks()	ToolCallbacks to be registered with the ChatModel.
Object	getToolChoice()
Map<String,Object>	getToolContext()	Get the configured tool context.
Set<String>	getToolNames()	Names of the tools to register with the ChatModel.
List<OpenAiApi.FunctionTool>	getTools()
Integer	getTopK()	Returns the top K to use for the chat.
Integer	getTopLogprobs()
Double	getTopP()	Returns the top P to use for the chat.
String	getUser()
int	hashCode()
void	setFrequencyPenalty(Double frequencyPenalty)
void	setHttpHeaders(Map<String,String> httpHeaders)
void	setInternalToolExecutionEnabled(Boolean internalToolExecutionEnabled)	Set whether the ChatModel is responsible for executing the tools requested by the model or if the tools should be executed directly by the caller.
void	setLogitBias(Map<String,Integer> logitBias)
void	setLogprobs(Boolean logprobs)
void	setMaxCompletionTokens(Integer maxCompletionTokens)
void	setMaxTokens(Integer maxTokens)
void	setMetadata(Map<String,String> metadata)
void	setModel(String model)
void	setN(Integer n)
void	setOutputAudio(OpenAiApi.ChatCompletionRequest.AudioParameters audio)
void	setOutputModalities(List<String> modalities)
void	setParallelToolCalls(Boolean parallelToolCalls)
void	setPresencePenalty(Double presencePenalty)
void	setReasoningEffort(String reasoningEffort)
void	setResponseFormat(ResponseFormat responseFormat)
void	setSeed(Integer seed)
void	setStop(List<String> stop)
void	setStopSequences(List<String> stopSequences)
void	setStore(Boolean store)
void	setStreamOptions(OpenAiApi.ChatCompletionRequest.StreamOptions streamOptions)
void	setStreamUsage(Boolean enableStreamUsage)
void	setTemperature(Double temperature)
void	setToolCallbacks(List<ToolCallback> toolCallbacks)	Set the ToolCallbacks to be registered with the ChatModel.
void	setToolChoice(Object toolChoice)
void	setToolContext(Map<String,Object> toolContext)	Set the tool context values as map.
void	setToolNames(Set<String> toolNames)	Set the names of the tools to register with the ChatModel.
void	setTools(List<OpenAiApi.FunctionTool> tools)
void	setTopLogprobs(Integer topLogprobs)
void	setTopP(Double topP)
void	setUser(String user)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.ai.model.tool.ToolCallingChatOptions

isInternalToolExecutionEnabled

Constructor Details

OpenAiChatOptions

public OpenAiChatOptions()

Method Details

builder

public static OpenAiChatOptions.Builder builder()

Description copied from interface: ToolCallingChatOptions

A builder to create a new ToolCallingChatOptions instance.

Returns:

Returns a new ChatOptions.Builder.

fromOptions

public static OpenAiChatOptions fromOptions(OpenAiChatOptions fromOptions)

getStreamUsage

public Boolean getStreamUsage()

setStreamUsage

public void setStreamUsage(Boolean enableStreamUsage)

getModel

public String getModel()

Description copied from interface: ChatOptions

Returns the model to use for the chat.

Specified by:

getModel in interface ChatOptions

Returns:

the model to use for the chat

setModel

public void setModel(String model)

getFrequencyPenalty

public Double getFrequencyPenalty()

Description copied from interface: ChatOptions

Returns the frequency penalty to use for the chat.

Specified by:

getFrequencyPenalty in interface ChatOptions

Returns:

the frequency penalty to use for the chat

setFrequencyPenalty

public void setFrequencyPenalty(Double frequencyPenalty)

getLogitBias

public Map<String,Integer> getLogitBias()

setLogitBias

public void setLogitBias(Map<String,Integer> logitBias)

getLogprobs

public Boolean getLogprobs()

setLogprobs

public void setLogprobs(Boolean logprobs)

getTopLogprobs

public Integer getTopLogprobs()

setTopLogprobs

public void setTopLogprobs(Integer topLogprobs)

getMaxTokens

public Integer getMaxTokens()

Description copied from interface: ChatOptions

Returns the maximum number of tokens to use for the chat.

Specified by:

getMaxTokens in interface ChatOptions

Returns:

the maximum number of tokens to use for the chat

setMaxTokens

public void setMaxTokens(Integer maxTokens)

getMaxCompletionTokens

public Integer getMaxCompletionTokens()

setMaxCompletionTokens

public void setMaxCompletionTokens(Integer maxCompletionTokens)

getN

public Integer getN()

setN

public void setN(Integer n)

getOutputModalities

public List<String> getOutputModalities()

setOutputModalities

public void setOutputModalities(List<String> modalities)

getOutputAudio

public OpenAiApi.ChatCompletionRequest.AudioParameters getOutputAudio()

setOutputAudio

public void setOutputAudio(OpenAiApi.ChatCompletionRequest.AudioParameters audio)

getPresencePenalty

public Double getPresencePenalty()

Description copied from interface: ChatOptions

Returns the presence penalty to use for the chat.

Specified by:

getPresencePenalty in interface ChatOptions

Returns:

the presence penalty to use for the chat

setPresencePenalty

public void setPresencePenalty(Double presencePenalty)

getResponseFormat

public ResponseFormat getResponseFormat()

setResponseFormat

public void setResponseFormat(ResponseFormat responseFormat)

getStreamOptions

public OpenAiApi.ChatCompletionRequest.StreamOptions getStreamOptions()

setStreamOptions

public void setStreamOptions(OpenAiApi.ChatCompletionRequest.StreamOptions streamOptions)

getSeed

public Integer getSeed()

setSeed

public void setSeed(Integer seed)

getStopSequences

public List<String> getStopSequences()

Description copied from interface: ChatOptions

Returns the stop sequences to use for the chat.

Specified by:

getStopSequences in interface ChatOptions

Returns:

the stop sequences to use for the chat

setStopSequences

public void setStopSequences(List<String> stopSequences)

getStop

public List<String> getStop()

setStop

public void setStop(List<String> stop)

getTemperature

public Double getTemperature()

Description copied from interface: ChatOptions

Returns the temperature to use for the chat.

Specified by:

getTemperature in interface ChatOptions

Returns:

the temperature to use for the chat

setTemperature

public void setTemperature(Double temperature)

getTopP

public Double getTopP()

Description copied from interface: ChatOptions

Returns the top P to use for the chat.

Specified by:

getTopP in interface ChatOptions

Returns:

the top P to use for the chat

setTopP

public void setTopP(Double topP)

getTools

public List<OpenAiApi.FunctionTool> getTools()

setTools

public void setTools(List<OpenAiApi.FunctionTool> tools)

getToolChoice

public Object getToolChoice()

setToolChoice

public void setToolChoice(Object toolChoice)

getUser

public String getUser()

setUser

public void setUser(String user)

getParallelToolCalls

public Boolean getParallelToolCalls()

setParallelToolCalls

public void setParallelToolCalls(Boolean parallelToolCalls)

getToolCallbacks

public List<ToolCallback> getToolCallbacks()

Description copied from interface: ToolCallingChatOptions

ToolCallbacks to be registered with the ChatModel.

Specified by:

getToolCallbacks in interface ToolCallingChatOptions

setToolCallbacks

public void setToolCallbacks(List<ToolCallback> toolCallbacks)

Description copied from interface: ToolCallingChatOptions

Set the ToolCallbacks to be registered with the ChatModel.

Specified by:

setToolCallbacks in interface ToolCallingChatOptions

getToolNames

public Set<String> getToolNames()

Description copied from interface: ToolCallingChatOptions

Names of the tools to register with the ChatModel.

Specified by:

getToolNames in interface ToolCallingChatOptions

setToolNames

public void setToolNames(Set<String> toolNames)

Description copied from interface: ToolCallingChatOptions

Set the names of the tools to register with the ChatModel.

Specified by:

setToolNames in interface ToolCallingChatOptions

getInternalToolExecutionEnabled

@Nullable
public Boolean getInternalToolExecutionEnabled()

Description copied from interface: ToolCallingChatOptions

Whether the ChatModel is responsible for executing the tools requested by the model or if the tools should be executed directly by the caller.

Specified by:

getInternalToolExecutionEnabled in interface ToolCallingChatOptions

setInternalToolExecutionEnabled

public void setInternalToolExecutionEnabled(@Nullable
 Boolean internalToolExecutionEnabled)

Description copied from interface: ToolCallingChatOptions

Set whether the ChatModel is responsible for executing the tools requested by the model or if the tools should be executed directly by the caller.

Specified by:

setInternalToolExecutionEnabled in interface ToolCallingChatOptions

getHttpHeaders

public Map<String,String> getHttpHeaders()

setHttpHeaders

public void setHttpHeaders(Map<String,String> httpHeaders)

getTopK

public Integer getTopK()

Description copied from interface: ChatOptions

Returns the top K to use for the chat.

Specified by:

getTopK in interface ChatOptions

Returns:

the top K to use for the chat

getToolContext

public Map<String,Object> getToolContext()

Description copied from interface: ToolCallingChatOptions

Get the configured tool context.

Specified by:

getToolContext in interface ToolCallingChatOptions

Returns:

the tool context map.

setToolContext

public void setToolContext(Map<String,Object> toolContext)

Description copied from interface: ToolCallingChatOptions

Set the tool context values as map.

Specified by:

setToolContext in interface ToolCallingChatOptions

Parameters:

toolContext - as map

getStore

public Boolean getStore()

setStore

public void setStore(Boolean store)

getMetadata

public Map<String,String> getMetadata()

setMetadata

public void setMetadata(Map<String,String> metadata)

getReasoningEffort

public String getReasoningEffort()

setReasoningEffort

public void setReasoningEffort(String reasoningEffort)

copy

public OpenAiChatOptions copy()

Description copied from interface: ChatOptions

Returns a copy of this ChatOptions.

Specified by:

copy in interface ChatOptions

Returns:

a copy of this ChatOptions

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object