Struct AgentHandle 

pub struct AgentHandle { /* private fields */ }

Request extractor handing handlers a ready-to-run agent.

Autumn resolves it from app state before the handler runs:

use autumn_plugin_agent::plugin::AgentHandle;
use autumn_web::prelude::*;

#[get("/ask")]
async fn ask(agent: AgentHandle) -> String {
    agent
        .run("Summarize this quarter's plot trends.")
        .await
        .map(|outcome| format!("{outcome:?}"))
        .unwrap_or_else(|err| err.to_string())
}

Fails with 503 when the plugin was never installed.

Implementations

impl AgentHandle

pub fn agent(&self) -> Agent

Build an Agent with the plugin’s client, tools, and budgets.

Customize further with the builder methods before calling run.

pub async fn run(&self, prompt: &str) -> Result<AgentOutcome, AgentError>

Run the agent loop with the plugin’s default settings.

Errors

Returns AgentError when a provider call fails. Budget exhaustion is not an error: see Agent::run.

pub async fn chat( &self, session: impl Into<SessionId>, input: &str, ) -> Result<AgentTurn, AgentError>

Run one turn in a persisted session with the plugin’s settings.

Errors

See Agent::run_in_session.

pub async fn chat_as( &self, scope: MemoryScope, session: impl Into<SessionId>, input: &str, ) -> Result<AgentTurn, AgentError>

Like AgentHandle::chat, with memory bound to scope (for example the signed-in user).

Errors

See Agent::run_in_session.

pub async fn resume( &self, state: RunState, decisions: Vec<ApprovalDecision>, ) -> Result<AgentTurn, AgentError>

Continue a paused run with a reviewer’s decisions, saving the transcript when the run belongs to a session.

Errors

See Agent::resume.

pub async fn resume_as( &self, scope: MemoryScope, state: RunState, decisions: Vec<ApprovalDecision>, ) -> Result<AgentTurn, AgentError>

Like AgentHandle::resume, with memory bound to scope. Use the scope the paused run started with (AgentHandle::chat_as).

Errors

See Agent::resume.

pub fn runtime(&self) -> &AgentRuntime

The shared runtime, for stores and settings.

pub fn tool_names(&self) -> Vec<&str>

Names of the tools registered on the plugin.

Trait Implementations

impl Clone for AgentHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentHandle

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

Formats the value using the given formatter.

impl FromRequestParts<AppState> for AgentHandle

type Rejection = AutumnError

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

fn from_request_parts( _parts: &mut Parts, state: &AppState, ) -> impl Future<Output = Result<Self, Self::Rejection>> + Send

Perform the extraction.