LangChain组件Tools/Toolkits详解（4）——处理ToolException

本章目录如下：

1. 《LangChain组件Tools/Toolkits详解（1）——Tools接口与创建工具概述》
2. 《LangChain组件Tools/Toolkits详解（2）——装饰器@tool》
3. 《LangChain组件Tools/Toolkits详解（3）——结构化工具StructuredTool》
4. 《LangChain组件Tools/Toolkits详解（4）——处理ToolException》
5. 《LangChain组件Tools/Toolkits详解（5）——返回产物artifact》
6. 《LangChain组件Tools/Toolkits详解（6）——特殊类型注解》
7. 《LangChain组件Tools/Toolkits详解（7）——工具调用与Toolkits》

本篇摘要

本章介绍LangChain组件Tools/Toolkits。

14. LangChain组件Tools/Toolkits详解

工具（Tools）是一种封装函数及其模式schema的方法，可以传递给聊天模型，使模型能够请求执行带有特定输入的工具函数，例如从数据库获取数据、发出API请求或运行自定义代码。LangChain中的tool抽象类将Python函数与定义函数名称、描述和预期参数的模式schema关联起来，以明确创建工具的作用及调用方式。本节将从Tools接口与创建工具概述、装饰器@tool、结构化工具StructuredTool、处理Error、返回产物artifact、特殊类型注解、工具调用和Toolkits等方面详细介绍工具。

14.4 处理ToolException

如果在代理中使用工具，可能需要一个错误处理策略，以便代理能够从错误中恢复并继续执行。一种简单的策略是从工具内部抛出ToolException，并使用handle_tool_error指定错误处理程序。当指定了错误处理程序时，异常将被捕获，并由错误处理程序决定从工具返回什么输出。

handle_tool_error可以设置为True、一个字符串值或一个函数。如果是一个函数，该函数应接受ToolException作为参数并返回一个值。但请注意，仅抛出 ToolException是无效的，需要先设置工具的handle_tool_error，因为它的默认值为False。下面分别讲解。

14.4.1 设置布尔值

首先定义处理函数，示例如下：

from langchain_core.tools import ToolException