Enum FailureKind 

pub enum FailureKind {
    MaxIter,
    Provider,
    ProviderPermanent,
    ProviderRateLimited,
    ProviderStream,
    Truncated,
    ContentFilter,
    Middleware,
    Tool,
    SandboxOpen,
    SandboxSave,
    Storage,
}

失败的结构化类别。

Variants

MaxIter

达到最大迭代步数。

Provider

调用 provider 建立流失败(网络 / 传输层)。

ProviderPermanent

provider 明确返回确定性失败,例如鉴权失败、请求格式错误、模型不存在。

ProviderRateLimited

provider 限流。

ProviderStream

流式响应过程中出错,或未收到正常收尾。

Truncated

模型输出被长度上限截断。

ContentFilter

模型输出被内容过滤拦截。

Middleware

中间件自身报错。

Tool

工具执行失败(模型可据错误结果调整后继续)。

SandboxOpen

打开沙箱失败。

SandboxSave

保存沙箱状态失败。

Storage

transcript/checkpoint 等持久化层失败。

Implementations

impl FailureKind

pub fn is_retryable(&self) -> bool

该类失败是否值得用同样的输入重试。

可重试:瞬时性的 provider / 流 / 沙箱故障,以及工具失败(交回模型自愈)。 不可重试:MaxIter / Truncated / ContentFilter —— 重试必然复现, 应直接进终态。Middleware 视为确定性错误(护栏 / 逻辑 bug),同样终态。

pub fn as_str(&self) -> &'static str

稳定的 snake_case 字符串,用于可观测属性和错误展示。

Trait Implementations

impl Clone for FailureKind

fn clone(&self) -> FailureKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FailureKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FailureKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FailureKind

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

Formats the value using the given formatter.

impl Eq for FailureKind

impl PartialEq for FailureKind

fn eq(&self, other: &FailureKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for FailureKind

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FailureKind