Enum ToolChoice 

pub enum ToolChoice {
    Auto,
    None,
    Required,
    Specific(String),
}

Strategy for how the LLM should handle tool selection.

Controls whether the LLM must use tools, can choose to use them, or is restricted from using them.

Example

use multi_llm::{RequestConfig, ToolChoice};

// Let the model decide
let config = RequestConfig {
    tool_choice: Some(ToolChoice::Auto),
    ..Default::default()
};

// Force a specific tool
let config = RequestConfig {
    tool_choice: Some(ToolChoice::Specific("get_weather".to_string())),
    ..Default::default()
};

Variants

Auto

Let the model decide whether and which tools to use.

The model may call zero, one, or multiple tools based on the conversation.

None

Disable tool use entirely for this request.

Even if tools are defined, the model will not call them.

Required

Force the model to use at least one tool.

Useful when you know a tool call is needed but don’t care which one.

Specific(String)

Force the model to use a specific tool by name.

The model will call exactly this tool (if arguments can be determined).

Trait Implementations

impl Clone for ToolChoice

fn clone(&self) -> ToolChoice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolChoice

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

Formats the value using the given formatter.

impl Default for ToolChoice

fn default() -> ToolChoice

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ToolChoice

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolChoice

fn eq(&self, other: &ToolChoice) -> 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 ToolChoice

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 ToolChoice