Enum ToolChoice 

pub enum ToolChoice {
    Auto,
    None,
    Required,
    Specific {
        name: String,
    },
}

工具选择策略 — 控制 LLM 是否以及如何使用工具。

发送给 LLM 的 tool_choice 参数，不同 provider 有不同的映射方式， 由 provider adapter 负责转换。

Examples

use katu_core::ToolChoice;

let choice = ToolChoice::Auto;
assert!(choice.allows_tools());

let choice = ToolChoice::None;
assert!(!choice.allows_tools());

let choice = ToolChoice::specific("bash");
assert!(choice.allows_tools());
assert_eq!(choice.required_tool(), Some("bash"));

Variants

Auto

模型自行决定是否使用工具。

None

禁止使用工具 — 模型只生成文本。

Required

必须使用工具 — 模型必须至少调用一个工具。

Specific

强制使用指定工具。

Fields

name: String

必须调用的工具名称。

Implementations

impl ToolChoice

pub fn specific(name: impl Into<String>) -> Self

创建强制使用指定工具的选择策略。

pub fn allows_tools(&self) -> bool

是否允许工具调用（None 时不允许）。

pub fn required_tool(&self) -> Option<&str>

如果是 Specific，返回指定的工具名称。

pub fn is_forced(&self) -> bool

是否强制使用工具（Required 或 Specific）。

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

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

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

impl StructuralPartialEq for ToolChoice