Struct AgentPlugin 

pub struct AgentPlugin { /* private fields */ }

The plugin. Register it with AppBuilder::plugin.

autumn_web::app().plugin(AgentPlugin::new()).run().await;

Implementations

impl AgentPlugin

pub fn new() -> Self

Create the plugin with default configuration.

Defaults resolve from autumn.toml’s [agent] section and AGENT_* environment variables at startup; see AgentConfig.

pub fn configure(self, configure: impl FnOnce(&mut AgentConfig)) -> Self

Tune the configuration in code. Runs after file and env loading, so values set here win over both.

pub fn tool(self, tool: Arc<dyn Tool>) -> Self

Register one tool the agent may call.

pub fn tools(self, tools: Vec<Arc<dyn Tool>>) -> Self

Register several tools at once.

pub fn hook(self, hook: Arc<dyn AgentHooks>) -> Self

Add a lifecycle hook to every agent.

pub fn policy(self, policy: Arc<dyn ToolPolicy>) -> Self

Decide per tool call whether agents may act. Defaults to allowing every call.

pub fn session_store(self, store: Arc<dyn SessionStore>) -> Self

Persist session transcripts here. Defaults to an in-memory store, which loses sessions on restart.

pub fn memory_store(self, store: Arc<dyn MemoryStore>) -> Self

Give agents persistent memory in this store.

pub fn skill(self, skill: Skill) -> Self

Offer one skill to every agent.

pub fn skills(self, skills: Vec<Skill>) -> Self

Offer several skills to every agent.

pub const fn compaction(self, compaction: Compaction) -> Self

Summarize long session transcripts before a run.

pub fn delivery(self, delivery: Arc<dyn Delivery>) -> Self

Where heartbeat, follow-up, and deliver job results go. Defaults to logging them.

pub fn heartbeat(self, heartbeat: Heartbeat) -> Self

Wake the agent on a schedule. Registers the agent_heartbeat task.

pub const fn followups(self, max_delay: Duration) -> Self

Give agents the schedule_followup tool, so they can book their own next run up to max_delay ahead.

Trait Implementations

impl Debug for AgentPlugin

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

Formats the value using the given formatter.

impl Default for AgentPlugin

fn default() -> Self

Returns the “default value” for a type.

impl Plugin for AgentPlugin

fn build(self, app: AppBuilder) -> AppBuilder

Wire the plugin into the app builder.

Declares the [agent] config section, registers the agent_run and agent_resume background jobs and the heartbeat task, adds the provider health indicator, and installs a startup hook that fails the boot fast when the config, the heartbeat, or the API key is unusable.

fn name(&self) -> Cow<'static, str>

Stable identifier used for duplicate-registration detection.

fn route_group(&self) -> Cow<'static, str>

The route group of the routes this plugin adds (#3544).

fn contract(&self) -> Option<PluginContract>

Declare which autumn-web versions this plugin supports, and any experimental surface it knowingly depends on.