Struct FunctionTool 

pub struct FunctionTool<F, Deps = ()> { /* private fields */ }

Wrapper for function-based tools.

This allows creating tools from async closures without implementing the Tool trait manually.

Example

use serdes_ai_tools::{FunctionTool, SchemaBuilder, ToolReturn};

let tool = FunctionTool::new(
    "add",
    "Add two numbers",
    SchemaBuilder::new()
        .number("a", "First number", true)
        .number("b", "Second number", true)
        .build()
        .unwrap(),
    |_ctx, args| async move {
        let a = args["a"].as_f64().unwrap_or(0.0);
        let b = args["b"].as_f64().unwrap_or(0.0);
        Ok(ToolReturn::text(format!("{}", a + b)))
    },
);

Implementations

impl<F, Deps> FunctionTool<F, Deps>

pub fn new( name: impl Into<String>, description: impl Into<String>, parameters: impl Into<JsonValue>, function: F, ) -> Self

Create a new function tool.

pub fn with_max_retries(self, retries: u32) -> Self

Set maximum retries.

pub fn with_strict(self, strict: bool) -> Self

Set strict mode.

Trait Implementations

impl<F, Deps> Debug for FunctionTool<F, Deps>

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

Formats the value using the given formatter.

impl<F, Deps> Tool<Deps> for FunctionTool<F, Deps>

where F: for<'a> Fn(&'a RunContext<Deps>, Value) -> Pin<Box<dyn Future<Output = ToolResult> + Send>> + Send + Sync, Deps: Send + Sync,

fn definition(&self) -> ToolDefinition

Get the tool’s definition.

fn call<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 RunContext<Deps>, args: JsonValue, ) -> Pin<Box<dyn Future<Output = ToolResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute the tool with given arguments.

fn max_retries(&self) -> Option<u32>

Maximum retries for this tool.

fn prepare<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 RunContext<Deps>, def: ToolDefinition, ) -> Pin<Box<dyn Future<Output = Option<ToolDefinition>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Prepare the tool definition at runtime.

fn name(&self) -> String

Get the tool name.

fn description(&self) -> String

Get the tool description.