Struct LLMRequest 

pub struct LLMRequest { /* private fields */ }

Builder-style request passed into LanguageModel::respond.

Wraps the full conversation, model parameters, and tool definitions a provider needs in order to execute a call.

Implementations

impl LLMRequest

pub fn new(messages: impl Into<Vec<Message>>) -> Self

Creates a request from the provided messages using default parameters.

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

Adds tool definitions to the request.

These define what tools the model can request. The model will emit Event::ToolCall events when it wants to use a tool.

pub fn with_tool<T: Tool>(self, tool: &T) -> Self

Adds a single tool definition.

pub fn with_parameters(self, parameters: Parameters) -> Self

Overrides the sampling parameters used for this call.

pub fn messages(&self) -> &[Message]

Returns the current conversation messages.

pub const fn messages_mut(&mut self) -> &mut Vec<Message>

Returns a mutable reference to messages for modification.

pub const fn parameters(&self) -> &Parameters

Returns the current parameter snapshot.

pub fn tool_definitions(&self) -> &[ToolDefinition]

Returns the tool definitions.

pub fn into_parts(self) -> (Vec<Message>, Parameters, Vec<ToolDefinition>)

Breaks the request into owned components.

impl LLMRequest

pub fn with_tools(self, tools: &mut Tools) -> LLMRequestWithTools<'_>

Attaches a mutable tool registry to the request.

This is for providers that execute tools internally (e.g., built-in tools). For agent-controlled tool execution, use with_tool_definitions instead.

Trait Implementations

impl Clone for LLMRequest

fn clone(&self) -> LLMRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LLMRequest

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

Formats the value using the given formatter.