Struct AgentBuilder 

pub struct AgentBuilder<'a> { /* private fields */ }

Builder for creating an Agent on an AgyBridge.

Obtained from AgyBridge::agent(). Implements IntoFuture so you can .await it directly, or chain optional .tools() / .hooks() calls before awaiting.

Implementations

impl AgentBuilder<'_>

pub fn tools(self, registry: ToolRegistry) -> Self

Attach a ToolRegistry containing custom Rust tools for the agent.

The registry’s tool definitions are automatically merged into the agent configuration.

Errors (at build time)

Returns error::Error::InvalidConfig if config.tools is already non-empty — pass tools via the registry or via config.tools, not both.

pub fn hooks(self, hooks: Hooks) -> Self

Attach Hooks for lifecycle event callbacks (pre/post turn, tool-call gating, etc.).

pub fn policy_handler(self, handler: impl AskUserHandler + 'static) -> Self

Attach a custom AskUserHandler to manage interactive tool-call confirmations.

pub fn conversation_id(self, id: impl Into<String>) -> Self

Set a pre-existing conversation ID to resume.

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

Set the model backend (e.g. "gemini-3.5-flash").

pub fn system_instructions( self, instructions: impl Into<SystemInstructions>, ) -> Self

Set system instructions for the agent.

pub fn workspaces( self, workspaces: impl IntoIterator<Item = impl Into<PathBuf>>, ) -> Self

Append workspace directories the agent is allowed to access and modify.

pub fn policies( self, policies: impl IntoIterator<Item = impl Into<PolicyRule>>, ) -> Self

Append policy rules to govern tool execution.

pub fn triggers( self, triggers: impl IntoIterator<Item = impl Into<TriggerEntry>>, ) -> Self

Append triggers that autonomously wake the agent.

pub fn mcp_servers( self, servers: impl IntoIterator<Item = impl Into<McpServer>>, ) -> Self

Append MCP servers for the agent.

pub fn skills( self, skills: impl IntoIterator<Item = impl Into<PathBuf>>, ) -> Self

Append paths for agent skills.

pub fn max_quota_retries(self, retries: u32) -> Self

Set the maximum number of quota retry attempts before giving up.

pub async fn build(self) -> Result<Agent, Error>

Validate configuration and create the agent.

Prefer using .await directly on the builder (via IntoFuture) instead of calling this method explicitly.

Errors

Returns error::Error::InvalidConfig if:

• config.tools is non-empty and a ToolRegistry was provided.
• The capabilities configuration is self-contradictory (e.g. both enabled_tools and disabled_tools specified).

Returns other error::Error variants if agent creation fails.

Trait Implementations

impl<'a> IntoFuture for AgentBuilder<'a>

type Output = Result<AgentHandle<PythonRuntime>, Error>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <AgentBuilder<'a> as IntoFuture>::Output> + Send + 'a>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.