Struct MicroAgentBuilder 

pub struct MicroAgentBuilder<Ctx> {
    pub storage: Box<dyn AgentStorage>,
    pub parallel_tool_calls: bool,
    /* private fields */
}

Builder for MicroAgent.

Example

use microagents_core::agent::MicroAgentBuilder;
use microagents_core::types::ToolExecutionContext;

let agent = MicroAgentBuilder::new(ToolExecutionContext::new(()))
    .provider("openai".into()).unwrap()
    .model("gpt-5.5".into())
    .build()
    .expect("API key must be set");

Fields

storage: Box<dyn AgentStorage>

parallel_tool_calls: bool

Implementations

impl<Ctx: Send + Sync + 'static> MicroAgentBuilder<Ctx>

pub fn new(tool_context: ToolExecutionContext<Ctx>) -> Self

Create a new builder with the given tool execution context.

The skills tool is registered automatically.

pub fn add_skill( self, skill_name: String, ) -> Result<Self, MicroAgentBuilderError>

Register a single skill by name.

Searches .agents/skills/{name} then ~/.agents/skills/{name}.

pub fn find_skills(self) -> Result<Self, MicroAgentBuilderError>

Auto-discover and register all skills found in the local and global skills directories.

pub fn provider(self, provider: String) -> Result<Self, MicroAgentBuilderError>

Set the LLM provider (e.g. "openai", "groq", "ollama").

pub fn model(self, model: String) -> Self

Set the model identifier. If empty, the provider’s default is used.

pub fn parallel_tool_calls(self, parallel_tool_calls: bool) -> Self

Enable or disable parallel tool execution.

pub async fn storage( self, storage: AgentStorageChoice, ) -> Result<Self, MicroAgentBuilderError>

Configure the session storage backend.

pub fn add_tool( self, tool: Arc<dyn ToolFunction<Ctx>>, ) -> Result<Self, MicroAgentBuilderError>

Register a custom tool.

pub fn custom_instructions(self, instructions: String) -> Self

Append free-form instructions to the system prompt.

pub fn build(self) -> Result<MicroAgent<Ctx>, MicroAgentBuilderError>

Finalise the builder and return a MicroAgent.

Fails early if a required API key is missing for the chosen provider.

Trait Implementations

impl<Ctx: Debug> Debug for MicroAgentBuilder<Ctx>

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

Formats the value using the given formatter.