Struct GenerationOptions 

pub struct GenerationOptions {
    pub max_tokens: Option<u32>,
    pub temperature: Option<f32>,
    pub top_p: Option<f32>,
    pub top_k: Option<u32>,
    pub frequency_penalty: Option<f32>,
    pub presence_penalty: Option<f32>,
    pub stop: Option<Vec<String>>,
    pub seed: Option<u64>,
}

Provider 无关的 LLM 生成参数。

所有字段均为 Option，None 表示使用 provider/model 默认值。 支持多级合并：Request 级 > Agent 级 > Model 级 > Provider 默认。

Examples

use katu_core::GenerationOptions;

let opts = GenerationOptions::new()
    .with_max_tokens(4096)
    .with_temperature(0.7);
assert_eq!(opts.max_tokens, Some(4096));
assert_eq!(opts.temperature, Some(0.7));

Fields

max_tokens: Option<u32>

最大输出 token 数

temperature: Option<f32>

采样温度 (0.0 = 确定性, 2.0 = 最大随机)

top_p: Option<f32>

Top-p (nucleus) 采样阈值

top_k: Option<u32>

Top-k 采样（部分 provider 支持）

frequency_penalty: Option<f32>

频率惩罚 (-2.0 ~ 2.0)

presence_penalty: Option<f32>

存在惩罚 (-2.0 ~ 2.0)

stop: Option<Vec<String>>

停止序列

seed: Option<u64>

随机种子（可复现生成）

Implementations

impl GenerationOptions

pub fn new() -> Self

创建空的 GenerationOptions（所有字段为 None）。

pub fn with_max_tokens(self, max_tokens: u32) -> Self

设置 max_tokens。

pub fn with_temperature(self, temperature: f32) -> Self

设置 temperature。

pub fn with_top_p(self, top_p: f32) -> Self

设置 top_p。

pub fn with_top_k(self, top_k: u32) -> Self

设置 top_k。

pub fn with_frequency_penalty(self, penalty: f32) -> Self

设置 frequency_penalty。

pub fn with_presence_penalty(self, penalty: f32) -> Self

设置 presence_penalty。

pub fn with_stop(self, stop: Vec<String>) -> Self

设置停止序列。

pub fn with_seed(self, seed: u64) -> Self

设置随机种子。

pub fn merge(&self, other: &GenerationOptions) -> GenerationOptions

合并两个 GenerationOptions，other 的非 None 值覆盖 self。

用于实现参数合并链：Request > Agent > Model > Provider。

Trait Implementations

impl Clone for GenerationOptions

fn clone(&self) -> GenerationOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GenerationOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GenerationOptions

fn default() -> GenerationOptions

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GenerationOptions

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for GenerationOptions

fn eq(&self, other: &GenerationOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for GenerationOptions

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GenerationOptions