tooluniverse.exceptions 模块

ToolUniverse 异常类

工具执行错误的结构化异常及可操作的恢复指导。

exception tooluniverse.exceptions.ToolError

基类：Exception

所有工具相关错误的基础异常。

error_type

分类错误类型

类型:

str

retriable

操作是否可以重试

类型:

布尔值

next_steps

解决该错误的可操作步骤

类型:

列表

details

关于错误的附加上下文

类型:

dict

__init__(message, error_type=None, retriable=False, next_steps=None, details=None)

to_dict()

将异常转换为结构化字典格式。

exception tooluniverse.exceptions.ToolAuthError

基类：ToolError

身份验证或授权错误（缺失/无效的 API 密钥，权限）。

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolUnavailableError

基类：ToolError

工具或服务不可用（网络问题、服务中断、工具未找到）。

__init__(message, retriable=True, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolRateLimitError

基类：ToolError

速率限制或配额已超出。

__init__(message, retriable=True, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolValidationError

基类：ToolError

参数验证失败（参数无效，架构不匹配）。

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolConfigError

基类：ToolError

工具配置错误（缺少配置，设置无效）。

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolDependencyError

基类：ToolError

缺失或不兼容的依赖项。

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolServerError

基类：ToolError

服务器端错误（5xx响应，意外故障）。

__init__(message, retriable=True, next_steps=None, details=None)