Enum AgentError 

pub enum AgentError {
    Model(ModelError),
    Capability(String),
    Cancelled {
        reason: String,
    },
    CapabilityOrder(CapabilityOrderError),
    StructuredOutput(String),
    DynamicInstruction(String),
    OutputRetryLimitExceeded {
        retries: usize,
    },
    ToolRetryLimitExceeded {
        tool: String,
        max_retries: usize,
    },
    StepLimitExceeded {
        steps: usize,
    },
    UsageLimit(UsageLimitError),
    ExecutionSuspended {
        node: AgentExecutionNode,
        reason: String,
    },
    Executor(AgentExecutorError),
    ToolCallsRequireTools,
}

Bare agent runtime error.

Variants

Model(ModelError)

Model adapter failed.

Capability(String)

Capability hook failed.

Cancelled

Runtime execution was cancelled cooperatively.

Fields

reason: String

Human-readable cancellation reason.

CapabilityOrder(CapabilityOrderError)

Capability ordering failed.

StructuredOutput(String)

Structured output parsing failed.

DynamicInstruction(String)

Dynamic instruction generation failed.

OutputRetryLimitExceeded

Output retry budget was exceeded.

Fields

retries: usize

Retry count.

ToolRetryLimitExceeded

Tool retry budget was exceeded.

Fields

tool: String

Tool name.

max_retries: usize

Retry limit for this tool.

StepLimitExceeded

Maximum step count was exceeded.

Fields

steps: usize

Step count.

UsageLimit(UsageLimitError)

Usage limit was exceeded.

ExecutionSuspended

Execution was suspended at a durable checkpoint.

Fields

node: AgentExecutionNode

Suspended execution node.

reason: String

Suspend reason.

Executor(AgentExecutorError)

Durable executor failed.

ToolCallsRequireTools

Model returned tool calls before tool execution exists in this bare runtime.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AgentExecutorError> for AgentError

fn from(source: AgentExecutorError) -> Self

Converts to this type from the input type.

impl From<CapabilityOrderError> for AgentError

fn from(source: CapabilityOrderError) -> Self

Converts to this type from the input type.

impl From<ModelError> for AgentError

fn from(source: ModelError) -> Self

Converts to this type from the input type.

impl From<UsageLimitError> for AgentError

fn from(source: UsageLimitError) -> Self

Converts to this type from the input type.