Struct Tools

pub struct Tools { /* private fields */ }

Tool registry for managing and calling tools by name.

Example

use ai_types::llm::tool::Tools;

let mut tools = Tools::new();
// tools.register(Calculator);
let definitions = tools.definitions();
// let result = tools.call("calculator", r#"{"operation": "add", "a": 5, "b": 3}"#).await;

Implementations

impl Tools

pub const fn new() -> Self

Creates a new empty tools registry.

pub fn definitions(&self) -> Vec<ToolDefinition>

Returns definitions of all registered tools.

pub fn register<T: Tool + 'static>(&mut self, tool: T)

Registers a new tool. Replaces existing tool with same name.

The tool must implement Tool and be 'static.

pub fn unregister(&mut self, name: &str)

Removes a tool from the registry.

pub async fn call(&mut self, name: &str, args: String) -> Result

Calls a tool by name with JSON arguments.

Errors

Returns an error if the tool is not found, arguments cannot be parsed, or tool execution fails.

Trait Implementations

impl Debug for Tools

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

Formats the value using the given formatter.

impl Default for Tools

fn default() -> Self

Returns the “default value” for a type.