首页/新闻资讯/正文详情

67-Agent工具定义与调用-搜索引擎-数据库-代码执行器集成

发布时间:2026/11/20 23:38:04 来源:云帆数科 栏目:资讯中心
67-Agent工具定义与调用-搜索引擎-数据库-代码执行器集成
文章目录【67.PythonAI】Agent工具定义与调用搜索引擎、数据库、代码执行器集成实战导入语1 ~ 工具的定义规范1.1 一个标准 Tool 的结构1.2 工具描述的黄金法则2 ~ 工具一搜索引擎集成2.1 使用 Tavily Search API2.2 免费替代方案3 ~ 工具二数据库查询3.1 让 Agent 安全地查数据库3.2 带着表结构描述的 Tool4 ~ 工具三Python 代码执行器4.1 为什么要让 Agent 执行代码4.2 沙箱式代码执行5 ~ 三合一 Agent 实战5.1 架构5.2 完整代码5.3 执行过程思考 总结结尾【67.PythonAI】Agent工具定义与调用搜索引擎、数据库、代码执行器集成实战文章简介本文聚焦Agent开发中最关键的环节——工具Tool的定义与集成。文章从一个好的工具描述长什么样开始拆解Tool的四大要素名称、描述、参数schema、执行函数然后逐一讲解三种最常用工具的集成方式搜索引擎Tavily API、数据库查询SQLite 安全检查、Python代码执行器沙箱模式。最后给出一个三合一Agent的完整代码——能上网搜索、能查数据库、能写代码计算配上Mermaid架构图展示工具调度流程。适合正在写ReAct Agent、需要给Agent扩充能力的开发者。 个人主页源码骑士❄专栏传送门《Android开发基础》《python基础课程》⭐️热衷从源码视角拆解技术底层原理将复杂架构讲得通俗易懂 源码骑士的简介5年Android Framework系统开发经验曾主导多项系统级性能优化专项技术栈覆盖Android系统全链路Binder/Handler/AMS/WMS/启动流程及Java后端全家桶Spring MyBatis Redis Oracle累计产出原创技术文章100篇文章以流程图为特色被读者评价为看一篇胜过啃一周源码导入语Agent 的智能从哪里来一半来自 LLM 的推理能力另一半来自它能调用的工具的广度——能搜到多少信息、能操作多少系统、能执行多少命令。一个只有搜索工具的Agent就是个加了联网功能的ChatGPT。但如果你的Agent能搜网页、能查数据库、能执行Python代码——它突然就有了手和脚能干真正的活了。这篇文章就聚焦这个关键环节怎么定义工具才能被LLM准确调用、三种最常用工具怎么集成、以及它们组合起来能解决什么问题。看完全文你会得到一个可复用的三合一工具集直接嵌入你的ReAct Agent。1 ~ 工具的定义规范1.1 一个标准 Tool 的结构frompydanticimportBaseModel,FieldclassTool:标准工具定义def__init__(self,name:str,description:str,func,args_schemaNone):self.namename self.descriptiondescription self.funcfunc self.args_schemaargs_schemadefexecute(self,**kwargs):returnself.func(**kwargs)1.2 工具描述的黄金法则法则好的描述坏的描述说清楚做什么“输入公司名称返回该公司最新股价”“查股票”说清楚输入格式“参数 keyword: 搜索关键词多个词用空格分隔”“搜索”说清楚输出格式“返回JSON{price, change, volume}”无描述写典型使用场景“当你需要获取实时信息时使用此工具”无# ✅ 好LLM能准确理解什么时候该用、怎么用search_toolTool(nameweb_search,description在互联网上搜索实时信息。当你需要最新资讯、事实核查时使用。参数 query: 搜索关键词尽量精简。返回前5条结果的标题和摘要。,funcweb_search,)# ❌ 差LLM不知道什么时候该调用bad_toolTool(names,descriptionsearch,funcweb_search,)2 ~ 工具一搜索引擎集成2.1 使用 Tavily Search APITavily 是为 AI Agent 设计的搜索引擎 API返回结构化的搜索结果importrequestsdefweb_search(query:str)-str:调用Tavily搜索APIapi_keyyour-tavily-api-keyresponserequests.post(https://api.tavily.com/search,json{api_key:api_key,query:query,search_depth:basic,max_results:5,})dataresponse.json()# 格式化搜索结果results[]forrindata.get(results,[]):results.append(f标题:{r[title]}\n内容:{r[content]}\n链接:{r[url]})return\n\n---\n\n.join(results)search_toolTool(nameweb_search,description搜索互联网获取实时信息。参数 query: 搜索关键词。,funcweb_search,)2.2 免费替代方案如果不想用付费API可以考虑 DuckDuckGo 的免费搜索# 使用 duckduckgo_search 库fromduckduckgo_searchimportDDGSdeffree_search(query:str)-str:withDDGS()asddgs:resultslist(ddgs.text(query,max_results5))return\n.join(f{r[title]}:{r[body]}forrinresults)3 ~ 工具二数据库查询3.1 让 Agent 安全地查数据库直接让LLM写SQL很危险——一条DROP TABLE就灾难了。需要用读写分离 SQL白名单做安全控制importsqlite3classSafeDatabase:安全的数据库工具——只读查询 SQL白名单ALLOWED_KEYWORDS{SELECT,FROM,WHERE,JOIN,GROUP,ORDER,LIMIT,COUNT,AVG,SUM,MAX,MIN}def__init__(self,db_path:str):self.db_pathdb_pathdefquery(self,sql:str)-str:# 安全检查sql_uppersql.strip().upper()# 只允许 SELECT 语句ifnotsql_upper.startswith(SELECT):return错误只允许 SELECT 查询# 检查危险关键词dangerous{DROP,DELETE,UPDATE,INSERT,ALTER,CREATE}ifany(kwinsql_upperforkwindangerous):return错误不允许修改数据的操作# 执行查询try:connsqlite3.connect(self.db_path)cursorconn.cursor()cursor.execute(sql)columns[desc[0]fordescincursor.description]rowscursor.fetchall()conn.close()# 格式化输出result | .join(columns)\n-*40\nforrowinrows[:20]:# 最多返回20行result | .join(str(v)forvinrow)\nreturnresultifrowselse查询无结果exceptExceptionase:returnf查询错误:{e}db_toolTool(namedatabase_query,description查询SQLite数据库。参数 sql: 合法的SELECT语句。表结构: users(id, name, department, salary), orders(id, user_id, amount, date),funcSafeDatabase(company.db).query,)3.2 带着表结构描述的 ToolLLM 需要知道表结构才能写出正确的 SQL。所以在 Tool 描述中要写明表名和字段DATABASE_SCHEMA 数据库包含以下表 - employees: id, name, department, salary, hire_date - departments: id, name, manager_id - projects: id, name, budget, status 4 ~ 工具三Python 代码执行器4.1 为什么要让 Agent 执行代码有些任务LLM推理做不了——比如这组数据的标准差是多少、“把这个JSON排序”。让Agent直接写代码执行比让它算准确得多。4.2 沙箱式代码执行importsysfromioimportStringIOdefexecute_python(code:str)-str:在受限环境中执行Python代码捕获输出# 禁止危险操作forbidden[os.,subprocess,shutil,__import__,open(,eval(,exec(]forwordinforbidden:ifwordincode:returnf安全限制代码中不允许使用 {word}# 重定向stdoutold_stdoutsys.stdout sys.stdoutcapturedStringIO()try:exec(code,{__builtins__:{print:print,len:len,range:range,int:int,float:float,str:str,list:list,dict:dict,sum:sum,max:max,min:min,sorted:sorted,abs:abs,round:round,zip:zip,}})outputcaptured.getvalue()returnoutputifoutputelse代码执行成功无输出exceptExceptionase:returnf执行错误:{type(e).__name__}:{e}finally:sys.stdoutold_stdout code_toolTool(namepython_executor,description执行Python代码进行数学计算或数据处理。参数 code: Python代码字符串。可用函数: print, len, range, int, float, str, list, dict, sum, max, min, sorted, abs, round, zip,funcexecute_python,)5 ~ 三合一 Agent 实战5.1 架构实时信息数据查询计算分析用户提问ReAct Agent需要什么类型的操作?web_searchTavily APIdatabase_querySQLitepython_executor沙箱执行生成最终回答5.2 完整代码tools{web_search:web_search,database_query:SafeDatabase(company.db).query,python_executor:execute_python,}# 提供给LLM的工具描述TOOLS_DESC - web_search[关键词]: 搜索互联网获取实时信息 - database_query[SQL]: 查询公司数据库只读SELECT - python_executor[代码]: 执行Python代码进行数学计算 数据库表: employees(id, name, dept, salary) agentReActAgent(llmChatOpenAI(modelgpt-4),toolstools,tools_promptTOOLS_DESC,max_steps10)# 复杂任务需要三个工具协同resultagent.run(查一下技术部的平均薪资然后搜索行业平均水平最后算算我们的薪资比行业高了多少百分比)5.3 执行过程Step1: Thought: 先查技术部平均薪资 → database_query[SELECT AVG(salary)FROM employees WHEREdept技术部]→ Observation:15000Step2: Thought: 搜索行业平均薪资 → web_search[Python开发工程师 平均薪资2024]→ Observation: 全国平均约12000元 Step3: Thought: 计算差距百分比 → python_executor[(15000-12000)/12000*100]→ Observation:25.0Final Answer: 技术部的平均薪资为15000元比行业平均水平12000元高出25%思考 总结工具描述是 Agent 准确调用的第一道关口花时间把每个Tool的description写清楚——做什么、输入什么、返回什么、什么时候该用它。这比代码实现更重要。搜索引擎让 Agent 突破了知识截止日的限制不用微调、不用RAG一个搜索API就能让Agent拥有实时信息获取能力。数据库查询必须加安全层你绝对不会想让LLM直接执行它生成的SQL。读写分离 关键词白名单 行数限制三保险。代码执行器需要沙箱限制可用的builtins函数、禁止文件操作和系统调用、超时控制——否则你的服务器就是一颗定时炸弹。工具的组合是 Agent 价值的放大器单个工具能解决的问题有限三个工具组合起来就能处理搜索→分析→计算的完整数据链路。工具多了Agent才真正有了手和脚。下次别人问你Agent能做什么的时候把这三个工具的运行记录给他看——比说一百句都管用。结尾各位小伙伴本文的内容到这里就全部结束了源码骑士在这里再次感谢您的阅读源码骑士 — Android Framework 全栈开发关注跟博主一起从源码视角深耕底层原理见证每一次成长❤️点赞让优质内容被更多人看见让知识传递更有力量⭐收藏把核心知识点存好在需要时随时查、随时用评论分享你的经验或疑问评论区一起交流避坑一键四连不要忘记给博主一键四连哦️寄语技术之路难免有困惑但同行的人会让前进更有方向结语给Agent装工具就像给程序员配开发环境——工具越全能做的事情就越多。本文的三个工具是你Agent工具箱的起点之后你可以继续加邮件发送、文件操作、API调用……Agent的能力边界只受限于你的想象力。不要忘记给博主一键四连哦

相关推荐

小团队怎么选AI模型?预算有限的选型思路
小团队怎么选AI模型?预算有限的选型思路

目前几个主流AI模型的API价格,从最便宜的每月几乎不花钱,到最贵的三百多元不等,跨度超过160倍。这里的月费用,是按照单模型包揽所有任务来测算的。实际上一个小团队每天做的事是分层的:简单的内容生成、中等难度的开发… · 2026/11/12 7:10:10

AI助手静音模式:多模态交互与环境适应性技术解析
AI助手静音模式:多模态交互与环境适应性技术解析

这次我们来看一个很有意思的现象:OpenAI CEO Sam Altman 在社交媒体上感叹,居然有用户想要"静音版"的AI助手。这个需求背后反映了当前AI语音交互体验中的一些实际问题。 从技术角度看,"静音版"需求主要针对的是语音AI助… · 2026/11/15 8:46:14

基于YOLOv8的安全手套佩戴识别系统开发实战
基于YOLOv8的安全手套佩戴识别系统开发实战

在工业安全生产监管中,手套佩戴识别一直是重要的安全防护环节。传统的人工巡检方式效率低下且容易遗漏,而基于深度学习的自动化检测系统能够有效解决这一问题。本文将详细介绍如何基于YOLOv8算法构建一套完整的安全手套佩戴识别检测系统,包含… · 2026/11/5 2:10:51

公路养路是特种工吗?千万别踩坑,这些真相必须知道
公路养路是特种工吗?千万别踩坑,这些真相必须知道

公路养路是特种工吗?千万别踩坑,这些真相必须知道 你是不是也这样,拿着简历到处投,却因为没有特种作业证被拒?急需特种作业证才能上岗找工作,这是很多求职者的痛点,特别是像公路养路这种工作,很多人都搞不清楚是不是特种工。 千万别踩坑… · 2026/11/20 23:38:00

山东电工证官网入口怎么查?怕考不过白交培训费?别慌!
山东电工证官网入口怎么查?怕考不过白交培训费?别慌!

山东电工证官网入口怎么查?怕考不过白交培训费?别慌! 怕考不过白交培训费?那你肯定没搞懂山东电工证官网入口的含金量!别再被培训机构忽悠了,先搞清楚怎么查、怎么报、怎么考,才能真正拿到手里的“饭碗”。这篇文章从漯河培训机构学员的真实经历出发,… · 2026/11/20 23:38:00

珠海三灶电工证怎么转异地 官方回应来了
珠海三灶电工证怎么转异地 官方回应来了

珠海三灶电工证怎么转异地 官方回应来了 怕考不过白交培训费?珠海三灶电工证的小伙伴们别急,官方回应来了,告诉你怎么转异地、怎么备考、怎么复审,一套流程走完,让你不再踩坑。今天就从周口的一位应届工程类毕业生小王的真实经历说起,看看他是怎么一步… · 2026/11/20 23:38:00

曲阳县电工证怎么考的内部消息你必须知道
曲阳县电工证怎么考的内部消息你必须知道

曲阳县电工证怎么考的内部消息你必须知道 你是不是也觉得学历不高怕报不上名?其实你不是一个人。很多人都在问: 曲阳县电工证怎么考… · 2026/11/20 23:38:00

电工证网上培训班多久拿证?学历不高怕报不上名怎么破?
电工证网上培训班多久拿证?学历不高怕报不上名怎么破?

电工证网上培训班多久拿证?学历不高怕报不上名怎么破? 你是不是也担心学历不高,电工证网上培训班根本报不上名?别急,我来给你捋清楚。 电工证网上培训班多久拿证?流程要多久? 流程大概需要3-6个月,具体时间因人而异。… · 2026/11/20 23:38:00

渭南电工证考试地点在哪儿?考前押题怎么获取?找工作必备!
渭南电工证考试地点在哪儿?考前押题怎么获取?找工作必备!

渭南电工证考试地点在哪儿?考前押题怎么获取?找工作必备! 你是不是正在找电工工作,但手头还没拿到电工证?别急, 渭南电工证考试地点 就在你身边,但你得先搞清楚怎么报名、怎么考试、怎么顺利拿到证书,否则 找工作就卡在这一步了… · 2026/11/20 23:36:59

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

建设厅特种工周三报名怎么弄?上岗必备别被中介坑
建设厅特种工周三报名怎么弄?上岗必备别被中介坑

建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54

中专考的中级电工证内部消息全攻略
中专考的中级电工证内部消息全攻略

中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码