跳转至

Exceptions

AgentsException

Bases: Exception

Agents SDK中所有异常的基类。

Source code in src/agents/exceptions.py
class AgentsException(Exception):
    """Agents SDK中所有异常的基类。"""

MaxTurnsExceeded

Bases: AgentsException

当超过最大轮数时引发的异常。

Source code in src/agents/exceptions.py
class MaxTurnsExceeded(AgentsException):
    """当超过最大轮数时引发的异常。"""

    message: str

    def __init__(self, message: str):
        self.message = message

ModelBehaviorError

Bases: AgentsException

当模型出现意外行为时引发的异常,例如调用不存在的工具,或提供格式错误的JSON。

Source code in src/agents/exceptions.py
class ModelBehaviorError(AgentsException):
    """当模型出现意外行为时引发的异常,例如调用不存在的工具,或提供格式错误的JSON。"""

    message: str

    def __init__(self, message: str):
        self.message = message

UserError

Bases: AgentsException

当用户在使用SDK时发生错误时引发的异常。

Source code in src/agents/exceptions.py
class UserError(AgentsException):
    """当用户在使用SDK时发生错误时引发的异常。"""

    message: str

    def __init__(self, message: str):
        self.message = message

InputGuardrailTripwireTriggered

Bases: AgentsException

当输入防护栏触发保险丝时引发的异常。

Source code in src/agents/exceptions.py
class InputGuardrailTripwireTriggered(AgentsException):
    """当输入防护栏触发保险丝时引发的异常。"""

    guardrail_result: "InputGuardrailResult"
    """被触发的防护栏的结果数据。"""

    def __init__(self, guardrail_result: "InputGuardrailResult"):
        self.guardrail_result = guardrail_result
        super().__init__(
            f"Guardrail {guardrail_result.guardrail.__class__.__name__} triggered tripwire"
        )

guardrail_result instance-attribute

guardrail_result: InputGuardrailResult = guardrail_result

被触发的防护栏的结果数据。

OutputGuardrailTripwireTriggered

Bases: AgentsException

当输出防护栏触发保险丝时引发的异常。

Source code in src/agents/exceptions.py
class OutputGuardrailTripwireTriggered(AgentsException):
    """当输出防护栏触发保险丝时引发的异常。"""

    guardrail_result: "OutputGuardrailResult"
    """被触发的防护栏的结果数据。"""

    def __init__(self, guardrail_result: "OutputGuardrailResult"):
        self.guardrail_result = guardrail_result
        super().__init__(
            f"Guardrail {guardrail_result.guardrail.__class__.__name__} triggered tripwire"
        )

guardrail_result instance-attribute

guardrail_result: OutputGuardrailResult = guardrail_result

被触发的防护栏的结果数据。