Struct FunctionToolset 

pub struct FunctionToolset<Deps = ()> { /* private fields */ }

A toolset backed by function-based tools.

This wraps a ToolRegistry and provides the AbstractToolset interface.

Example

use serdes_ai_toolsets::FunctionToolset;
use serdes_ai_tools::{SyncFunctionTool, ObjectJsonSchema};

let toolset = FunctionToolset::new()
    .with_id("my_tools")
    .tool(my_tool)
    .tool(another_tool);

Implementations

impl<Deps> FunctionToolset<Deps>

pub fn new() -> Self

Create a new empty function toolset.

pub fn with_id(self, id: impl Into<String>) -> Self

Set the toolset ID.

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

Set the default max retries for tools.

pub fn tool<T: Tool<Deps> + 'static>(self, tool: T) -> Self

Add a tool to the toolset.

pub fn tools<I, T>(self, tools: I) -> Self

where I: IntoIterator<Item = T>, T: Tool<Deps> + 'static,

Add multiple tools to the toolset.

pub fn registry(&self) -> &ToolRegistry<Deps>

Get the underlying registry.

pub fn registry_mut(&mut self) -> &mut ToolRegistry<Deps>

Get mutable access to the registry.

pub fn len(&self) -> usize

Get the number of tools.

pub fn is_empty(&self) -> bool

Check if the toolset is empty.

Trait Implementations

impl<Deps: Send + Sync + 'static> AbstractToolset<Deps> for FunctionToolset<Deps>

fn id(&self) -> Option<&str>

Unique identifier for this toolset.

fn type_name(&self) -> &'static str

Type name for debugging.

fn get_tools<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 RunContext<Deps>, ) -> Pin<Box<dyn Future<Output = Result<HashMap<String, ToolsetTool>, ToolError>> + Send + 'async_trait>>

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

Get all available tools.

fn call_tool<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 str, args: JsonValue, ctx: &'life2 RunContext<Deps>, _tool: &'life3 ToolsetTool, ) -> Pin<Box<dyn Future<Output = Result<ToolReturn, ToolError>> + Send + 'async_trait>>

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

Call a tool by name.

fn label(&self) -> String

Human-readable label for error messages.

fn tool_name_conflict_hint(&self) -> String

Hint for resolving name conflicts.

fn enter<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ToolError>> + Send + 'async_trait>>

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

Enter context (for resource setup).

fn exit<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ToolError>> + Send + 'async_trait>>

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

Exit context (for cleanup).

impl<Deps> Debug for FunctionToolset<Deps>

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

Formats the value using the given formatter.

impl<Deps> Default for FunctionToolset<Deps>

fn default() -> Self

Returns the “default value” for a type.