Struct OpenApiToolset 

pub struct OpenApiToolset { /* private fields */ }

A set of tools generated from an OpenAPI specification.

Each operation in the spec becomes a tool that can be registered with a rig agent. The toolset is designed to be parsed once and reused across requests.

Implementations

impl OpenApiToolset

pub fn from_file(path: impl AsRef<Path>) -> Result<Self>

Parse an OpenAPI spec from a YAML or JSON file.

pub fn from_spec_str(spec_str: &str) -> Result<Self>

Parse an OpenAPI spec from a YAML or JSON string.

pub fn builder(spec_str: &str) -> OpenApiToolsetBuilder

Start building a toolset from a YAML or JSON string with configuration options.

pub fn builder_from_file( path: impl AsRef<Path>, ) -> Result<OpenApiToolsetBuilder>

Start building a toolset from a file with configuration options.

pub fn len(&self) -> usize

Return the number of tools parsed from the spec.

pub fn is_empty(&self) -> bool

Returns true if no operations were found in the spec.

pub fn into_tools(self) -> Vec<Box<dyn ToolDyn>>

Consume the toolset and return tools for use with rig’s AgentBuilder::tools().

pub fn tools_with_context( &self, context: &HashMap<String, String>, ) -> Vec<Box<dyn ToolDyn>>

Clone the tools with per-request context injected as hidden parameters. The LLM will not see these parameters in tool schemas, but they will be auto-injected into every tool call at execution time.

This is the primary way to add per-request state (user ID, session info, etc.) while reusing the parsed toolset across requests.

pub fn context_preamble(context: &HashMap<String, String>) -> String

Generate a preamble snippet describing the visible context for the LLM. Include this in your agent’s .preamble() so the LLM knows about available context values it can use when calling tools.