Struct ExternalToolset 

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

Toolset for externally-executed tools.

This is used when tools need to be exposed to the model but will be executed by an external system. When any tool is called, it returns ToolError::CallDeferred so the agent knows to defer execution.

Example

use serdes_ai_toolsets::ExternalToolset;
use serdes_ai_tools::ToolDefinition;

let external = ExternalToolset::new()
    .with_id("external_api")
    .definition(ToolDefinition::new("api_call", "Call external API"));

Implementations

impl<Deps> ExternalToolset<Deps>

pub fn new() -> Self

Create a new empty external 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 max retries.

pub fn definition(self, def: ToolDefinition) -> Self

Add a tool definition.

pub fn definitions(self, defs: impl IntoIterator<Item = ToolDefinition>) -> Self

Add multiple tool definitions.

pub fn len(&self) -> usize

Get the number of definitions.

pub fn is_empty(&self) -> bool

Check if empty.

Trait Implementations

impl<Deps: Send + Sync> AbstractToolset<Deps> for ExternalToolset<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 ExternalToolset<Deps>

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

Formats the value using the given formatter.

impl<Deps> Default for ExternalToolset<Deps>

fn default() -> Self

Returns the “default value” for a type.