Struct LLMRequestBuilder 

pub struct LLMRequestBuilder { /* private fields */ }

Builder for constructing LLMRequest instances with a fluent API.

Example

use llm_kernel::llm::LLMRequest;

let request = LLMRequest::builder()
    .system("You are concise.")
    .user_message("Summarise Rust ownership in one line.")
    .temperature(0.0)
    .build();

Implementations

impl LLMRequestBuilder

pub fn system(self, prompt: impl Into<String>) -> Self

Set the system prompt.

pub fn user_message(self, content: impl Into<String>) -> Self

Append a user message.

pub fn assistant_message(self, content: impl Into<String>) -> Self

Append an assistant message.

pub fn message(self, msg: ChatMessage) -> Self

Append a raw ChatMessage.

pub fn messages(self, messages: Vec<ChatMessage>) -> Self

Replace the message list with the provided messages.

Convenience for callers that already hold a Vec<ChatMessage> (e.g. a pre-built conversation), avoiding repeated .message() calls.

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

Set the sampling temperature.

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

Set the maximum tokens to generate.

pub fn maybe_max_tokens(self, tokens: Option<u32>) -> Self

Set the maximum tokens to generate, or None to use the provider default.

Convenience for callers that already hold an Option<u32> (e.g. a config field), avoiding a conditional chain.

pub fn model(self, model: impl Into<String>) -> Self

Override the model for this request.

pub fn response_format(self, format: ResponseFormat) -> Self

Set the desired response format.

pub fn tools(self, tools: Vec<ToolDefinition>) -> Self

Set the tool definitions available to the model.

pub fn reasoning(self, cfg: ReasoningConfig) -> Self

Set reasoning-model controls (effort / on-off switch / summary).

pub fn verbosity(self, verbosity: Verbosity) -> Self

Set the response verbosity (OpenAI verbosity).

pub fn extra_body(self, extra: Map<String, Value>) -> Self

Merge extra provider parameters into the request body verbatim (last-write-wins). Any official spec parameter or provider extension.

pub fn observability(self, context: ObservabilityContext) -> Self

Attach an observability context for middleware (kernel-opaque).

pub fn with_session(self, session_id: impl Into<String>) -> Self

Convenience: set just the session id, creating the context if absent and preserving other fields otherwise.

pub fn build(self) -> LLMRequest

Build the LLMRequest.

Trait Implementations

impl Clone for LLMRequestBuilder

fn clone(&self) -> LLMRequestBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LLMRequestBuilder

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

Formats the value using the given formatter.

impl Default for LLMRequestBuilder

fn default() -> LLMRequestBuilder

Returns the “default value” for a type.