7.3 工具类型与能力框架《AI智能体应用开发》

AI智能体应用开发 鲍亮崔江涛李倩范涛 清华大学出版社【行情 报价 价格 评测】-京东《AI智能体应用开发》1~6章试读-CSDN博客在7.1节和7.2节中我们系统地阐述了智能体工具能力的概念、核心机制与重要性为其勾勒了一幅宏观的理论蓝图。然而要真正驾驭这项能力我们需要从抽象走向具体从理论走向实践。本章将带领读者深入智能体的“工具箱”通过具体的、可运行的实例拆解不同类型的工具如何被集成与调用从而构建起一个直观的能力框架。本节假设读者拥有大模型调用的基础知识。为了方便且专业地演示这些实例我们将选用LangChain[2]这一广泛使用的开源框架。LangChain并非唯一选择但它为智能体与工具的集成提供了层次清晰、模块化的优秀抽象极大地简化了将大语言模型与外部能力组合在一起的过程。在本章中我们使用LangChain的目的在于快速、规范地构建一个具备工具调用能力的智能体原型并以其为标准范例阐释工具集成的通用模式和内在原理。我们将重点分析两类基础但至关重要的工具信息获取类以数据库为例和推理与计算类数值计算与代码执行。7.3.1 数据库在许多实际应用场景中智能体需要与组织的核心数据资产—数据库进行交互。例如一个客户服务智能体可能需要查询订单状态一个数据分析智能体可能需要汇总销售报表一个内部管理智能体可能需要检索员工信息。让智能体直接、安全地查询数据库可以使其回答基于真实、最新的业务数据价值巨大。为了演示我们假设一个简化的电商业务数据库test.db使用SQLite3作为数据库包含如图7-1所示的表结构。图7-1 数据库ER图代码清单7.1展示了如何使用LangChain构建一个能够理解自然语言问题并生成正确SQL查询的数据库查询智能体。为了缩小代码占用的篇章7.3.2节及之后的代码依赖引入部分略去详细的代码可以参考本书之后提供的代码仓库。代码清单7.1数据库工具调用实例from langchain_community.utilities.sql_database import SQLDatabasefrom langchain_openai import ChatOpenAIfrom langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkitfrom langchain.agents import create_agentfrom dotenv import load_dotenvfrom langchain_core.prompts import SystemMessagePromptTemplatefrom prompt import PROMPT_TEMPLATEload_dotenv(../.env)db SQLDatabase.from_uri(sqlite:///test.db)llm ChatOpenAI(modelqwen-plus, temperature0)toolkit SQLDatabaseToolkit(dbdb, llmllm)system_message SystemMessagePromptTemplate.from_template(PROMPT_TEMPLATE).format(dialectSQLite, top_k5) # PROMPT_TEMPLATE见代码仓库agent create_agent(llm, toolkit.get_tools(), system_promptsystem_message)example_query Alice购买了哪些商品events agent.stream({messages: [(user, example_query)]},stream_modevalues,)for event in events:event[messages][-1].pretty_print()代码首先进行了工具封装SQLDatabaseToolkit是关键组件它将数据库操作封装成智能体可理解和调用的工具。根据LangChain的SQLDatabaseToolkit文档[3]说明它提供了InfoSQLDatabaseTool、ListSQLDatabaseTool、QuerySQLCheckerTool、QuerySQLDatabaseTool分别用于获取数据库元信息、列出数据库包含的表格、检查SQL的正确性、查询数据库。执行流程如表7-1所示。上述流程稍微有些复杂从上述智能体执行流程可以看出智能体在面对用户查询时展现了一套完整、结构化的问题解决路径。整个过程体现了其自主决策、分步验证与高效执行的特点。1. 问题理解与目标拆解智能体首先明确用户查询意图—“Alice购买了哪些商品”并将其转化为从数据库中检索的具体任务而非直接尝试猜测或简单回应。2. 环境探查与信息获取智能体没有立即编写查询而是先通过工具理清数据库结构。3. 方案生成与安全验证在理解表结构后智能体主动构建SQL查询语句并进行语法和逻辑检查。这一步体现了其在执行前的谨慎态度避免无效或危险查询提升系统安全性与可靠性。4. 执行查询与结果整合确认查询无误后智能体执行查询获取原始结果[(Laptop,), (Phone,)]并将其转化为用户友好的表述形式清晰列出商品名称。5. 闭环输出与任务完成最终智能体以清晰条目形式总结答案响应用户初始问题完成交互闭环。最后请注意数据库是核心业务系统其访问必须受到最严格的限制对于可能更改数据库内容的权限强烈建议不要配置到工具中否则可能会导致数据库内容发生不预期的变更仅授予查询的权限即可。7.3.2 数值计算大语言模型处理数学问题依赖于其在训练数据中见过的数字模式和计算“印象”本质上是一种基于统计的“估算”而非精确计算。对于简单算术可能有效但对于复杂表达式、金融计算或科学计算其出错概率极高。因此一个可靠的数值计算工具是必不可少的。代码清单7.2展示了如何创建一个最简单的自定义计算工具并将其赋予智能体。和7.3.1节不同这里使用tool装饰器自定义了一个calculate工具并且简单地使用了eval作为求值的逻辑。需要说明的是本例中直接使用eval()是极其危险的因为它会执行输入字符串中的任何有效Python代码。恶意用户可能输入“__import__(os).system(rm-rf/)”这样的指令。这只是一个为演示工具集成原理的最小化示例。一个安全的数值计算工具应该使用安全的数学表达式解析库如ast.literal_eval或专门的库如numexpr、sympy严格限制可用的运算符和函数白名单并且在沙箱环境中执行计算。一个较为详细的数值计算工具定义可以参考strands-agents的工具集[4]。由于逻辑较为简单本例不进行智能体的流程演示读者可以运行代码并观察智能体的行为。7.3.3 代码执行代码执行工具为智能体赋予了前所未有的强大能力。它允许智能体通过编写代码来解决其内部模型无法直接处理的复杂问题例如数据处理、文件操作、调用特定库函数、实现复杂算法等。这极大地扩展了智能体的行动边界使其从顾问升级为执行者。我们可以使用LangChain提供的PythonREPL工具简单地进行测试可以参考本书的代码仓库tool-example/numeric_example/repl.py。注意代码执行工具风险等级更高这允许智能体执行未经审查的代码必须配备极其严密的防护措施。我们必须在完全隔离的沙箱如Docker容器、轻量级虚拟机、或基于操作系统级别的沙箱技术中运行PythonREPL。这个环境应该无网络访问权限且与主机文件系统隔离并且也应该进行文件系统访问控制、资源限制等风险控制。代码清单7.2数值计算工具调用实例load_dotenv(../.env)tooldef calculate(expression):calculate an expressionreturn eval(expression)llm ChatOpenAI(modelqwen-plus, temperature0)agent create_agent(model llm,tools [calculate])example_query 帮我计算(1234 * 56) % 11events agent.stream({messages: [(user, example_query)]},stream_modevalues,)for event in events:event[messages][-1].pretty_print()