Enum ToolChoice

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

Represents the tool choice strategy for LLMs

This enum provides a provider-agnostic API for tool choice, mapping to different provider-specific parameters:

• OpenAI/Mistral: Maps to “auto”, “required”, “none”, or a function object
• Anthropic: Maps to “auto”, “any”, “none”, or a function object
• Gemini: Maps to function_calling_config modes and allowed_function_names

Variants

Auto

Allow the model to choose which tool to use (or none)

• OpenAI/Mistral: “auto”
• Anthropic: “auto”
• Gemini: mode=“auto”

Any

Require the model to use one of the available tools

• OpenAI/Mistral: “required”
• Anthropic: “any”
• Gemini: mode=“any”

None

Force the model not to use any tools

• OpenAI/Mistral: “none”
• Anthropic: “none”
• Gemini: mode=“none”

Specific(String)

Require the model to use a specific tool by name

• OpenAI/Mistral: Object with type=“function” and function.name
• Anthropic: Object with type=“function” and function.name
• Gemini: mode=“auto” with allowed_function_names=[name]

Trait Implementations

impl Clone for ToolChoice

fn clone(&self) -> ToolChoice

Returns a copy 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() -> Self

Returns the “default value” for a type.

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 Eq for ToolChoice

impl StructuralPartialEq for ToolChoice