Enum ProviderErrorKind 

pub enum ProviderErrorKind {
    Authentication {
        message: String,
        kind: AuthErrorKind,
    },
    RateLimit {
        message: String,
        retry_after: Option<Duration>,
    },
    QuotaExceeded {
        message: String,
    },
    InvalidRequest {
        message: String,
    },
    ContentFiltered {
        message: String,
    },
    ServerError {
        message: String,
        status: u16,
        retry_after: Option<Duration>,
    },
    Transport {
        message: String,
    },
    InvalidResponse {
        message: String,
    },
    Unknown {
        message: String,
    },
}

Provider 错误分类。

每种分类自带 retryable 语义，Agent loop 据此决定重试策略。 可序列化以便持久化到 Session 记录中。

Variants

Authentication

API Key 缺失、无效、过期、权限不足。

Fields

message: String

kind: AuthErrorKind

RateLimit

请求频率超限（HTTP 429）。

Fields

message: String

retry_after: Option<Duration>

Provider 建议的等待时间。

QuotaExceeded

配额/余额耗尽（需充值或切换账户）。

Fields

message: String

InvalidRequest

请求参数非法（prompt 过长、无效模型名等）。

Fields

message: String

ContentFiltered

内容被安全策略过滤。

Fields

message: String

ServerError

Provider 服务端错误（5xx）。

Fields

message: String

status: u16

retry_after: Option<Duration>

Transport

网络/传输层错误（DNS 失败、连接超时、SSL 等）。

Fields

message: String

InvalidResponse

Provider 返回了无法解析的响应。

Fields

message: String

Unknown

未知 Provider 错误。

Fields

message: String

Implementations

impl ProviderErrorKind

pub fn retryable(&self) -> bool

该错误是否可重试。

• true → RateLimit, ServerError
• false → Authentication, QuotaExceeded, InvalidRequest, 其他

pub fn retry_after(&self) -> Option<Duration>

建议的退避等待时间。

优先使用 Provider 返回的 retry-after 值； 无显式值时按分类使用默认值：

• RateLimit → 30s
• ServerError → 20s

Trait Implementations

impl Clone for ProviderErrorKind

fn clone(&self) -> ProviderErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderErrorKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ProviderErrorKind

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

Formats the value using the given formatter.

impl Error for ProviderErrorKind

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 Serialize for ProviderErrorKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.