Enum Error 

#[non_exhaustive]
pub enum Error {
    MissingApiKey(String),
    Http(Box<dyn Error + Send + Sync>),
    Provider {
        status: u16,
        body: String,
    },
    Decode(Error),
    UnknownTool(String),
    InvalidArguments {
        tool: String,
        message: String,
    },
    Tool {
        tool: String,
        message: String,
    },
    MaxIterations(usize),
    Io(Error),
    Other(String),
}

Errors that can arise while configuring or running an crate::Agent.

#[non_exhaustive] so new variants can be added without a breaking release; match with a _ arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

MissingApiKey(String)

No API key was provided and none could be found in the environment.

Http(Box<dyn Error + Send + Sync>)

The HTTP transport failed. The underlying error is kept as an opaque source rather than exposing the reqwest type, so a transport-library bump is not a breaking change for this crate’s public API.

Provider

The provider returned a non-success status.

Fields

status: u16

HTTP status code.

body: String

Raw response body (truncated upstream if large).

Decode(Error)

A response body could not be parsed.

UnknownTool(String)

The model asked for a tool that isn’t registered.

InvalidArguments

A tool’s input arguments were not valid for its schema.

Fields

tool: String

The tool that was called.

message: String

What was wrong with the arguments.

Tool

A tool failed while executing.

Fields

tool: String

The tool that failed.

message: String

Failure detail.

MaxIterations(usize)

The agent loop exceeded its configured iteration budget.

Io(Error)

An I/O operation failed.

Other(String)

Catch-all for everything else.

Implementations

impl Error

pub fn tool(tool: impl Into<String>, message: impl Into<String>) -> Self

Convenience constructor for a tool failure.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.