Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

A registry for managing a collection of tools.

Implementations

impl ToolRegistry

pub fn new() -> Self

Creates a new ToolRegistry.

pub fn register(&mut self, tool: Box<dyn Tool>)

Registers a tool with the registry.

pub fn get(&self, name: &str) -> Option<&dyn Tool>

Gets a tool from the registry by name.

pub async fn execute(&self, name: &str, args: Value) -> Result<ToolResult>

Executes a tool in the registry by name.

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

Gets the definitions of all tools in the registry.

pub fn list_tools(&self) -> Vec<String>

Lists the names of all tools in the registry.

Examples found in repository

examples/agent_with_tools.rs (line 25)

async fn main() -> helios_engine::Result<()> {
    // Load configuration from `config.toml`.
    let config = Config::from_file("config.toml")?;

    // Create an agent named "ToolAgent" and equip it with the `CalculatorTool` and `EchoTool`.
    // Using the improved syntax to add multiple tools at once!
    let mut agent = Agent::builder("ToolAgent")
        .config(config)
        .system_prompt("You are a helpful assistant with access to tools. Use them when needed.")
        .tools(vec![Box::new(CalculatorTool), Box::new(EchoTool)])
        .max_iterations(5)
        .build()
        .await?;

    println!(
        "Available tools: {:?}\n",
        agent.tool_registry().list_tools()
    );

    // --- Test the calculator tool ---
    let response = agent.chat("What is 25 * 4 + 10?").await?;
    println!("Agent: {}\n", response);

    // --- Test the echo tool ---
    let response = agent
        .chat("Can you echo this message: 'Hello from Helios!'")
        .await?;
    println!("Agent: {}\n", response);

    Ok(())
}

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.