prompt-executor-openai-client/ai.koog.prompt.executor.clients.openai/OpenAIChatParams

OpenAIChatParams

class OpenAIChatParams(temperature: Double? = null, maxTokens: Int? = null, numberOfChoices: Int? = null, speculation: String? = null, schema: LLMParams.Schema? = null, toolChoice: LLMParams.ToolChoice? = null, user: String? = null, includeThoughts: Boolean? = null, thinkingBudget: Int? = null, additionalProperties: Map<String, JsonElement>? = null, val frequencyPenalty: Double? = null, val presencePenalty: Double? = null, val parallelToolCalls: Boolean? = null, val promptCacheKey: String? = null, val safetyIdentifier: String? = null, val serviceTier: ServiceTier? = null, val store: Boolean? = null, val audio: OpenAIAudioConfig? = null, val logprobs: Boolean? = null, val reasoningEffort: ReasoningEffort? = null, val stop: List<String>? = null, val topLogprobs: Int? = null, val topP: Double? = null, val webSearchOptions: OpenAIWebSearchOptions? = null) : LLMParams, OpenAIParams(source)

OpenAI chat/completions parameters layered on top of LLMParams.

These options mirror the fields commonly used with OpenAI’s Chat Completions / Responses APIs and add OpenAI-specific controls (audio, logprobs, reasoning effort, response formatting, service tiers, etc.). All parameters are optional; when unset, provider/model defaults apply.

Constructors

OpenAIChatParams

constructor(temperature: Double? = null, maxTokens: Int? = null, numberOfChoices: Int? = null, speculation: String? = null, schema: LLMParams.Schema? = null, toolChoice: LLMParams.ToolChoice? = null, user: String? = null, includeThoughts: Boolean? = null, thinkingBudget: Int? = null, additionalProperties: Map<String, JsonElement>? = null, frequencyPenalty: Double? = null, presencePenalty: Double? = null, parallelToolCalls: Boolean? = null, promptCacheKey: String? = null, safetyIdentifier: String? = null, serviceTier: ServiceTier? = null, store: Boolean? = null, audio: OpenAIAudioConfig? = null, logprobs: Boolean? = null, reasoningEffort: ReasoningEffort? = null, stop: List<String>? = null, topLogprobs: Int? = null, topP: Double? = null, webSearchOptions: OpenAIWebSearchOptions? = null)

Properties

additionalProperties

val additionalProperties: Map<String, JsonElement>?

audio

val audio: OpenAIAudioConfig? = null

Audio output configuration when using audio-capable models.

frequencyPenalty

val frequencyPenalty: Double? = null

Number in -2.0, 2.0—penalizes frequent tokens to reduce repetition.

includeThoughts

val includeThoughts: Boolean?

logprobs

val logprobs: Boolean? = null

Whether to include log-probabilities for output tokens.

maxTokens

val maxTokens: Int?

numberOfChoices

val numberOfChoices: Int?

parallelToolCalls

val parallelToolCalls: Boolean? = null

Allow multiple tool calls in parallel.

presencePenalty

val presencePenalty: Double? = null

Number in -2.0, 2.0—encourages an introduction of new tokens/topics.

promptCacheKey

val promptCacheKey: String? = null

Stable cache key for prompt caching (non-blank when provided).

reasoningEffort

val reasoningEffort: ReasoningEffort? = null

Constrains reasoning effort (e.g., MINIMAL/LOW/MEDIUM/HIGH).

safetyIdentifier

val safetyIdentifier: String? = null

Stable app-scoped user ID for policy enforcement (non-blank when provided).

schema

val schema: LLMParams.Schema?

serviceTier

val serviceTier: ServiceTier? = null

Processing tier selection for cost/latency trade-offs.

speculation

val speculation: String?

stop

val stop: List<String>? = null

Stop sequences (0–4 items); generation halts before any of these.

store

val store: Boolean? = null

Whether the provider may store outputs for improvement/evals.

temperature

val temperature: Double?

thinkingBudget

val thinkingBudget: Int?

toolChoice

val toolChoice: LLMParams.ToolChoice?

topLogprobs

val topLogprobs: Int? = null

Number of top alternatives per position (0–20). Requires logprobs = true.

topP

val topP: Double? = null

Nucleus sampling in (0.0, 1.0]; use instead of temperature.

user

val user: String?

webSearchOptions

val webSearchOptions: OpenAIWebSearchOptions? = null

Configure web search tool usage (if supported).

Functions

component1

operator fun component1(): Double?

component10

operator fun component10(): Map<String, JsonElement>?

component2

operator fun component2(): Int?

component3

operator fun component3(): Int?

component4

operator fun component4(): String?

component5

operator fun component5(): LLMParams.Schema?

component6

operator fun component6(): LLMParams.ToolChoice?

component7

operator fun component7(): String?

component8

operator fun component8(): Boolean?

component9

operator fun component9(): Int?

copy

fun copy(temperature: Double? = this.temperature, maxTokens: Int? = this.maxTokens, numberOfChoices: Int? = this.numberOfChoices, speculation: String? = this.speculation, schema: LLMParams.Schema? = this.schema, toolChoice: LLMParams.ToolChoice? = this.toolChoice, user: String? = this.user, includeThoughts: Boolean? = this.includeThoughts, thinkingBudget: Int? = this.thinkingBudget, additionalProperties: Map<String, JsonElement>? = this.additionalProperties, frequencyPenalty: Double? = this.frequencyPenalty, presencePenalty: Double? = this.presencePenalty, parallelToolCalls: Boolean? = this.parallelToolCalls, promptCacheKey: String? = this.promptCacheKey, safetyIdentifier: String? = this.safetyIdentifier, serviceTier: ServiceTier? = this.serviceTier, store: Boolean? = this.store, audio: OpenAIAudioConfig? = this.audio, logprobs: Boolean? = this.logprobs, reasoningEffort: ReasoningEffort? = this.reasoningEffort, stop: List<String>? = this.stop, topLogprobs: Int? = this.topLogprobs, topP: Double? = this.topP, webSearchOptions: OpenAIWebSearchOptions? = this.webSearchOptions): OpenAIChatParams

Creates a copy of this instance with the ability to modify any of its properties.

open fun copy(temperature: Double?, maxTokens: Int?, numberOfChoices: Int?, speculation: String?, schema: LLMParams.Schema?, toolChoice: LLMParams.ToolChoice?, user: String?, includeThoughts: Boolean?, thinkingBudget: Int?, additionalProperties: Map<String, JsonElement>?): LLMParams

default

fun default(default: LLMParams): LLMParams

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

toString

open override fun toString(): String