Enum AgentError 

pub enum AgentError {
    MaxTurnsExceeded(usize),
    InputGuardrailTriggered(String),
    OutputGuardrailTriggered(String),
    ToolInputGuardrailTriggered(String),
    ToolOutputGuardrailTriggered(String),
    ToolExecutionFailed {
        tool_name: String,
        reason: String,
    },
    ToolTimeout(String),
    ModelError(String),
    SessionError(String),
    ConfigError(String),
    SerializationError(String),
    UserError(String),
    ModelBehaviorError(String),
    Other(Error),
}

The main error type for the OpenAI Agents SDK

Variants

MaxTurnsExceeded(usize)

Maximum number of turns exceeded

InputGuardrailTriggered(String)

Input guardrail was triggered

OutputGuardrailTriggered(String)

Output guardrail was triggered

ToolInputGuardrailTriggered(String)

Tool input guardrail was triggered

ToolOutputGuardrailTriggered(String)

Tool output guardrail was triggered

ToolExecutionFailed

Tool execution failed

Fields

tool_name: String

reason: String

ToolTimeout(String)

Tool timeout

ModelError(String)

Model API error

SessionError(String)

Session/memory error

ConfigError(String)

Invalid configuration

SerializationError(String)

Serialization/deserialization error

UserError(String)

User-provided error

ModelBehaviorError(String)

Model behavior error (unexpected response format)

Other(Error)

Generic error with context

Implementations

impl AgentError

pub fn tool_failed( tool_name: impl Into<String>, reason: impl Into<String>, ) -> Self

Create a new tool execution error

pub fn is_retriable(&self) -> bool

Check if this error is retriable

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AgentError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AgentError

Available on crate feature sqlite-session only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<OpenAIError> for AgentError

fn from(err: OpenAIError) -> Self

Converts to this type from the input type.