2021222324252627282930313233

@dataclassclassRunErrorDetails:"""Data collected from an agent run when an exception occurs."""input:str|list[TResponseInputItem]new_items:list[RunItem]raw_responses:list[ModelResponse]last_agent:Agent[Any]context_wrapper:RunContextWrapper[Any]input_guardrail_results:list[InputGuardrailResult]output_guardrail_results:list[OutputGuardrailResult]def__str__(self)->str:returnpretty_print_run_error_details(self)

3637383940414243

classAgentsException(Exception):"""Base class for all exceptions in the Agents SDK."""run_data:RunErrorDetails|Nonedef__init__(self,*args:object)->None:super().__init__(*args)self.run_data=None

4647484950515253

classMaxTurnsExceeded(AgentsException):"""Exception raised when the maximum number of turns is exceeded."""message:strdef__init__(self,message:str):self.message=messagesuper().__init__(message)

56575859606162636465

classModelBehaviorError(AgentsException):"""Exception raised when the model does something unexpected, e.g. calling a tool that doesn't    exist, or providing malformed JSON.    """message:strdef__init__(self,message:str):self.message=messagesuper().__init__(message)

6869707172737475

classUserError(AgentsException):"""Exception raised when the user makes an error using the SDK."""message:strdef__init__(self,message:str):self.message=messagesuper().__init__(message)

7879808182838485868788

classInputGuardrailTripwireTriggered(AgentsException):"""Exception raised when a guardrail tripwire is triggered."""guardrail_result:InputGuardrailResult"""The result data of the guardrail that was triggered."""def__init__(self,guardrail_result:InputGuardrailResult):self.guardrail_result=guardrail_resultsuper().__init__(f"Guardrail{guardrail_result.guardrail.__class__.__name__} triggered tripwire")

 91 92 93 94 95 96 97 98 99100101

classOutputGuardrailTripwireTriggered(AgentsException):"""Exception raised when a guardrail tripwire is triggered."""guardrail_result:OutputGuardrailResult"""The result data of the guardrail that was triggered."""def__init__(self,guardrail_result:OutputGuardrailResult):self.guardrail_result=guardrail_resultsuper().__init__(f"Guardrail{guardrail_result.guardrail.__class__.__name__} triggered tripwire")

104105106107108109110111112113114115116

classToolInputGuardrailTripwireTriggered(AgentsException):"""Exception raised when a tool input guardrail tripwire is triggered."""guardrail:ToolInputGuardrail[Any]"""The guardrail that was triggered."""output:ToolGuardrailFunctionOutput"""The output from the guardrail function."""def__init__(self,guardrail:ToolInputGuardrail[Any],output:ToolGuardrailFunctionOutput):self.guardrail=guardrailself.output=outputsuper().__init__(f"Tool input guardrail{guardrail.__class__.__name__} triggered tripwire")

119120121122123124125126127128129130131

classToolOutputGuardrailTripwireTriggered(AgentsException):"""Exception raised when a tool output guardrail tripwire is triggered."""guardrail:ToolOutputGuardrail[Any]"""The guardrail that was triggered."""output:ToolGuardrailFunctionOutput"""The output from the guardrail function."""def__init__(self,guardrail:ToolOutputGuardrail[Any],output:ToolGuardrailFunctionOutput):self.guardrail=guardrailself.output=outputsuper().__init__(f"Tool output guardrail{guardrail.__class__.__name__} triggered tripwire")