经济金融 AI 智能体设计与开源 · W0701 — 58
开场中山大学岭南学院 · 李学恒 / 张一帆
++中山大学岭南学院 · 经济金融 AI 智能体设计与开源 · 第七周
连接外部工具
与工具调用
李学恒
中山大学岭南学院副教授
中山大学岭南学院副教授
07第七周
开场
上周你们看的上机录播,是谁做的?
七段 · 点击跳转
- 0:00开场导言任务与看点
- 0:36初始化建仓库、首次提交
- 1:25代理 A另开分支改生产
- 1:53代理 B新会话改货币
- 2:43分叉检查版本图两条线
- 3:07合回主分支合并遇到冲突
- 4:03合并后核验修正后核对网页
W06 演示视频:Git worktree 实机演示 ↗ · 6 分 1 秒,带导言、字幕与讲解
开场 · 揭晓
揭晓:这条录播,是智能体调用外部工具做出来的

操控与录屏逐字输入指令、点击发送;WorkBuddy 和版本图两个窗口同时录,记下每一次输入与点击
按真实事件剪辑26 个片段,16 段推近镜头;等待段加速 2 到 3 倍,6 个角标
配音与字幕写 71 句旁白稿,本机语音合成模型克隆音色配音,再配字幕
自动验收全片解码、帧数与剪口接续核对;旁白用语音识别逐段回转写;上线后逐章跳转测试
操控电脑和浏览器![智能体看屏幕、打字、点击、录屏,也操作浏览器回读页面]()

像人一样看屏幕、打字、点击、录屏,也能开浏览器回读网页。
全部放在虚拟机里,出错碰不到真实电脑。
操控电脑和浏览器,也是它的工具;人做了两件事:定流程,审样片。
W06 演示 C(Git worktree)的制作与验收文件 · 课程材料
开场
它调用了哪些外部工具

9 个WorkBuddyVS CodeGit GraphGitFFmpegPython 图像库语音合成模型语音识别模型浏览器自动测试
一个目标,9 个外部软件和模型,由智能体串起来;人在起点下任务、定标准。
W06 演示 C(Git worktree)的制作与上线文件 · 课程材料
开场
同一个问题,两种回答
问国家统计局最近一次公布的 CPI 同比是多少?给出来源。
没有工具
- 凭训练时的记忆回答:数字停在训练数据收集的时候,可能过时
- 给不出来源:没有链接,也说不出发布日期
- 你分不清它是在回忆,还是在猜
有工具
工具调用 · 搜索
国家统计局 CPI 同比 最新发布www.stats.gov.cn · 2026-10-14 发布2026年9月份居民消费价格同比上涨0.9%
- 先去查,再回答:数字、链接、发布日期一起给出
两边可以是同一个模型。多出来的是一次工具调用:先查,再答,附出处。
右栏为 2026-10-19 用 DeepSeek 搜索接口检索的结果 · 国家统计局:2026年9月份居民消费价格同比上涨0.9% ↗
W07
ROUTE · 今天的路线
今天的路线
开场那条录播用到的工具,今天逐层讲:工具调用是什么 → 网页与浏览器 → 数据接口 → 本地软件 → 文献与引用核验 → 没有接口时:看屏幕点鼠标 → 怎么选、怎么核 → 上机
I
PART I / VII
工具调用是什么
模型自己只会写字。它写一张请求单,由外面的程序去办,再把结果送回给它看。
I工具调用
回到第一周那张图
这一次的输入
你的任务
规则与到目前为止的对话
上一次工具返回的结果
LLM大模型
→
回复直接回答,给人看的文字
Tool Call一张请求单:用哪个工具、带什么参数

模型的输出只有两种:直接回答,或者写一张请求单。
W02 讲过:智能体 = 模型+工具+上下文。今天讲中间那只“手”怎么接上。
W01 核心图 · W02 课件
I工具调用
请求不是执行

模型写出请求单,由 Claude Code 或 WorkBuddy 检查权限、去执行,结果作为下一轮输入送回模型。W02 的权限审批就卡在请求和执行之间。“它说它查了”不算数,要看工具记录里有没有那一次调用。
W02 课件 · 课程材料
I三层
外部工具的三层

① 客户端自带:搜索、读网页、读写文件、运行命令(WorkBuddy 开启内置浏览器后也算);② 外接工具:别人做好的,装上就能用,MCP 和 CLI+Skill 都在这一层;③ 看屏幕点鼠标:前两层都不行时兜底。
课程材料
I外接工具
MCP 和 CLI+Skill:联系与区别

相同:都是给智能体多一个能调用的外部程序;模型只写请求,由 Claude Code 或 WorkBuddy 执行;装上后都出现在调用记录里。用的时候不必分,看三件事:装上没有、放对没有、调用记录里有没有它。
MCP 全称 Model Context Protocol · 课程材料
I外接工具
五处不同:登记好的按钮,用到才读的说明书
| MCP登记好的按钮 | CLI+Skill用到才读的说明书 | |
|---|---|---|
| ① 怎么装 | 用添加命令或在设置里填配置(命令、参数、Key),重启后看连接状态 | 装一次命令行程序,再把 Skill 文件夹放进技能目录 |
| ② 模型怎么知道 | 工具登记进工具列表,名字和参数都写好 | 平时只看 Skill 的名字和一句描述,用到才读全文 |
| ③ 调用长什么样 | 点名一个登记好的工具,按格式填参数 | 照说明书写一行命令,交给客户端运行 |
| ④ 平时占多少上下文 | 登记的说明每次对话都在 | 用到才加载 |
| ⑤ 谁能写 | 要会编程 | 用 Markdown 写说明书(W04 写过) |
Playwright 官方同一个浏览器工具出了两种形式:CLI+Skill 更省 token,不把大段工具说明和页面结构塞进上下文;MCP 适合要长时间保持浏览器状态的任务。
Playwright CLI 官方 README ↗ · 第 ③ 行对照 WorkBuddy 里同一步点击的两条真实调用
I两端
两端接上同一个工具
首选:让智能体帮你装
打开 Claude Code 或 WorkBuddy,把一段提示词交给它,写清:
- 装什么:官方仓库链接或包名
- 装在哪一端、放哪个目录
- 避开哪些写法,下载走国内镜像
- 装完怎样自查:版本号、工具列表
- 遇到 Key 和授权,停下来问你
要你亲手做申请 Key、点授权弹窗、重启客户端
两端各在哪里接 · 以 Playwright MCP 为例
Claude Code装好后重开客户端,在工具列表里看到 playwright 已连接
WorkBuddy连接器 → 自定义连接器,填同一组启动设置
CC Switch 只切换 Claude Code 背后的模型,不执行工具。
完整安装步骤见课程网站工具说明。
接上以后,两端界面里都会先出现一条工具调用记录(工具名、参数),之后才有回答。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19 · 03 Playwright MCP
I两端
装工具要过的四关

依赖:Node、Python 先装好;位置:Skill 放进各端自己的技能目录,WorkBuddy 不读 Claude Code 的技能目录,有的要在设置里打开开关;Key:启动客户端前写进环境变量,不进共享文件和截图;放行:看清沙箱或权限请求再点允许。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II
PART II / VII
网页与浏览器
网页上的几件事:找、读、动;七个工具各一张卡;搜索结果是线索,原文才是证据。
II网页
网页上的几件事

找(搜索)、读(取正文)、动(点击、填表、翻页)。前两件只读,第三件会改变页面状态;要借用你浏览器里的登录状态时,风险再高一级。
课程材料
II网页
网页类工具一览

Claude Code 自带的网页读取在国内网络下用不了,用图中任一工具代替。后面一个工具一张卡。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T01
DeepSeek Search/Fetch
Key 只放进环境变量,不贴给智能体;按成功请求次数计费。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T02
WorkBuddy 内置网页读取与浏览器操控
练习用 WorkBuddy 自带的浏览器,不接日常浏览器的登录态;按积分计费。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T03
Playwright MCP
一次登记一整套浏览器工具,适合要长时间保持浏览器状态的任务。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T04
Playwright CLI
和 Playwright MCP 同一个引擎,用到才读说明书,更省 token;页面快照可能含登录信息,不要上传。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T05
agent-browser
WorkBuddy 端在技能市场搜索 agent-browser,装“网页自动化”;不接日常浏览器,网页上的文字只当数据,不当指令。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T06
Agent-Reach
要 Cookie 登录的平台有封号风险,不用主账号配置。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II工具卡 T07
web-access
它能触达你登录过的所有网站:只装在项目里、点名才用,建议用小号。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
II网页
搜索结果是线索,原文才是证据

搜索摘要可能过时、可能被改写,告诉你去哪找;数字、链接和发布日期以原文为准。引用的是原文,不是摘要。
课程材料
II演示 1
演示 1:查最新 CPI,打开原文核对
5 段 · 点击跳转
- 0:00任务与材料空文件夹、deepseek-web 技能
- 0:54装技能交给 WorkBuddy 装进项目
- 1:40挂技能下指令选中技能,输入任务
- 2:09搜索找线索先搜索,找到出处
- 2:21核原文写文件打开统计局原文,写进文件
任务查最近一次公布的全国 CPI 同比;先搜索,再打开统计局原文核对,写进文件
看点搜索结果是线索,数字以原文为准;回答附原文链接和发布日期
验收CPI 0.9%、原文链接、发布日期与统计局原文一致
演示 1 录屏 · WorkBuddy+deepseek-web 技能 · 2 分 46 秒,带讲解与字幕 · 国家统计局:2026年9月份居民消费价格同比上涨0.9% ↗
II演示 1c
演示 1c:按本地资料填网页表单
6 段 · 点击跳转
- 0:00导言两份资料、一张练习表
- 0:54装 Playwright MCP国内源,用本机 Chrome
- 1:40确认连接重开后看到 playwright
- 2:01读资料填表逐项识别控件、照资料填
- 3:04停下核对读回、截图,学号空着
- 3:37补学号提交人补学号,再提交
任务按文件夹里的简历和实习意向填练习报名表;填完先截图,不提交
看点文本框、单选、多选、矩阵逐个识别;资料里没有的学号空着不编;提交前停下
验收截图每项与资料一致,空着的只有学号;人补上学号再提交,截下成功页
演示 1c 录屏 · Claude Code+Playwright MCP · 4 分 25 秒,带讲解与字幕 · 表单为课程网站的练习表,资料里的同学是虚构的
III
PART III / VII
数据接口
能走接口,就别爬网页;先选源,再取数,再核验最新一期。
III数据接口
能走接口,就别爬网页

网页给人看,接口给程序用:字段固定、可重复调用、能写进脚本复现。中国宏观数据有现成的免费接口 AKShare,不需要注册。
课程材料
III数据接口
先选源,再取数,再核验

同一个源的不同接口,更新可能差一年:旧的年度 CPI 接口停在 2025 年 9 月。下结论前,先看最新一期是哪个月。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19 · macro-data 技能(W04)
III工具卡 T08
AKShare 与 macro-data
旧的年度接口停在 2025 年,不用;关键数字回统计局原文核对。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
III演示 2 · 回看 W04
回看 W04:先选源、再取数、再核验
7 段 · 点击跳转
- 0:00导言场景、材料、六步流程
- 0:54装技能macro-data、html-slides
- 1:40配环境装包被沙箱拦下,改走备用数据
- 3:02取数留痕每行带来源列,写取数记录
- 3:55看数定判断AI 描述走势,人写判断
- 5:05出页11 页演示文稿
- 5:50自查挑两个点回原发布核对
接口取数在 W04 练习二做过:装包被拦就换备用数据源,每行数据留来源,最后挑点回原发布核对。
W04 演示视频:练习二 两个 Skill 接力 ↗ · 6 分 54 秒,带讲解与字幕
IV
PART IV / VII
本地软件
你电脑上的软件也是工具:模型写脚本,客户端运行,结果落进文件和日志。
IV本地软件
你电脑上的软件,也是工具

模型写脚本,客户端在你电脑上运行,结果写进文件和日志,模型再读回来。读写 Excel 文件不需要装 Excel,用 Python 的 pandas、openpyxl 即可。
课程材料
IV本地软件
写脚本、跑脚本、读日志

脚本报错时,先读报错原文,再判断是脚本写错还是数据有问题。模型说“已完成”不算:打开输出文件,找到那一个数。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19 · 09 Python 读写 Excel
IV工具卡 T09
Python 读写 Excel:pandas 与 openpyxl
写进去的公式读回是空的,核对时用算好的数值。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
IV演示 3
演示 3:从年报 PDF 做财务分析工作簿
7 段 · 点击跳转
- 0:00看材料一份年报 PDF,143 页
- 0:46下达指令启动 Claude Code,输入任务
- 1:14确认权限运行命令先问人
- 1:36装包找表缺库就装,定位三张报表
- 2:10建表算比率工作簿、杜邦分解、配图
- 2:58读回核对程序读回归母净利润
- 3:33对照原文年报第 62 页
任务从茅台年报 PDF 抽三张报表进 Excel,算四个比率、做杜邦分解、写一页结论
看点缺什么库就请求装;运行命令、写文件先问人;它自己写脚本找表、抽数、出图
验收三张报表与比率表齐全;读回的归母净利润与原文第 62 页一致;杜邦三项相乘等于 ROE
演示 3 录屏 · Claude Code · 3 分 55 秒,带讲解与字幕 · 贵州茅台 2025 年年度报告(巨潮资讯网)
V
PART V / VII
文献与引用核验
AI 写的参考文献常见三种错;用公开数据库逐条核;查不到,不等于是假的。
V文献核验
AI 写的参考文献,常见三种错

① 文献不存在:编的 DOI 或标题;② 存在但信息错:年份、作者、期刊;③ 存在、信息也对,但不支持那句话。第三种最难发现,要读摘要或全文。
课程材料
V文献核验
用公开数据库逐条核

这几个库免费、能用程序批量查,经文献核验技能调用。每条核四项,最难的是最后一项:是否支持原句。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19 · 10 文献核验接口
V文献核验
一个文献核验技能:bib-citation-validator

规则判定、不靠模型猜,同样的输入每次结果一样;可疑的条目连同它在正文里的位置一起列出来。
李学恒自用的文献核验技能 bib-citation-validator 的说明与源码
V文献核验
它怎么判一条引用
同一条引用,和官方记录比三样
1题名像不像两个题名的词重合多少,0 到 1
2年份对不对工作论文与正式发表常差 1 年
3第一作者对不对比姓氏,带重音的写法先统一
PASS通过
三样都对上
例:DOI 能解析,三样一致
相似度 ≥ 0.90,年份差不超过 1 年,第一作者在作者名单里
WARN要人看
查得到,但有一样对不上
例:年份写成 2015,记录是 2018
相似度 0.75–0.90,或年份差 2 年以上,或作者对不上
FAIL很可能有错
DOI 解析不了,题名也查不到
例:DOI 是编的,查无此文
最佳匹配相似度低于 0.75;断网也会判 FAIL,先重跑
WARN 和 FAIL 是交给人复核的清单,不是最终结论;分界写死在规则里,谁来跑结果都一样。
李学恒自用的文献核验技能 bib-citation-validator 的说明与源码
V工具卡 T10
文献核验接口
同一校园网共用 OpenAlex 匿名额度,容易用完:优先按 DOI 查。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
V工具卡 T12
CNKI Skills:知网检索技能集
国际库查不到的中文文献,让它去知网核:检索不用登录,滑块验证自己拖,下载要学校或个人账号。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
V文献核验
查不到,不等于是假的

DOI 对不上,先用题名加作者再查;超时或被限流,等一会儿或换一个库;中文文献、图书常不在这些库里,换来源或人工查。结论用三种标签:已核实/信息有误/论断未核验,读不到全文的不写“已核实”。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19 · 10 文献核验接口
V演示 4
演示 4:核一份五条的文献清单
6 段 · 点击跳转
- 0:00任务与材料草稿正文与五条参考文献
- 0:57装核验技能清华源装依赖,试跑一次
- 1:44跑技能挂上技能,出报告
- 2:27看报告2 PASS、1 WARN、2 FAIL
- 3:35读摘要取回摘要,判正文论断
- 4:04看核验表Levitt 那条说反了
任务用文献核验技能核草稿里的五条参考文献,出报告;再读摘要,写核验表
看点编造的 DOI 返回 404;脚本判 PASS 的也可能把意思说反,要读摘要
验收报告 2 PASS、1 WARN、2 FAIL;核验表指出说反的那条;中文文献没有判为假
演示 4 录屏 · WorkBuddy+bib-citation-validator 技能 · 5 分 2 秒,带讲解与字幕 · 草稿与文献清单为练习材料
VI
PART VI / VII
兜底:看屏幕点鼠标
没有接口、也不能写脚本时,像人一样看屏幕、点鼠标:慢,所以是兜底。
VI看屏幕点鼠标
没有接口时:看屏幕、点鼠标

没有接口、也不能写脚本时,像人一样看屏幕、点按钮:截一张图,找到按钮,点一下,再截一张图确认。开场那条录播里,在 WorkBuddy 里输入、点击的一步就是这样做的。
课程材料
VI工具卡 T11
Computer Use:Peekaboo 与 Windows-MCP
截图会发给模型:只开测试窗口,不碰网银和个人账号。
课程整理的工具说明 ↗ · 国内网络情况核查于 2026-10-19
VI演示 5
演示:从空文件夹到一节课件
四个阶段 · 点击跳转
- 准搭项目目录与 AGENTS.md0:00
- 一整理、集中案例素材1:33
- 二逐页大纲:人定方向、审阅;智能体展开、改第二版2:54
- 三调用 HTML Slide Skill 生成图文课件4:40
和开场那条录播一样,每一次点击、输入都是智能体在虚拟机里操作 WorkBuddy 完成的。
录屏 V-01 · WorkBuddy · 平台经济学第 4 章“补贴启动:平台要烧多久,利润才出来?” · 6 分 26 秒 · 成品 11 页课件
VII
PART VII / VII
收束与上机
三级阶梯怎么选;每次调用问三句;三个上机练习与复盘。
VII收束
怎么选:三级阶梯

先问:客户端自带的够不够用?不够,有没有现成的 MCP 或 Skill 能装上?都没有,才看屏幕点鼠标。越靠前越稳、越便宜、越容易复现。
课程材料
VII收束
每次调用,都问三句

回到“请求不是执行”:多来源、找权威、每条标出处。写数据与引文来源清单、数据核查报告,就是在回答这三句。
课程材料
VII上机
上机:三个练习

Claude Code、WorkBuddy 两端任选一端;手册里两端分栏写。
课程材料
VII上机 · 练习一
练习一:翻页采集招聘岗位
- 接上一个能翻页的浏览器工具(T02–T05 任选)
- 打开国家大学生就业服务平台职位信息页,搜“金融”,采前 3 页共 30 条,存 CSV
- 字段:职位名称、单位、地区、学历、月薪下限与上限、招聘人数、单位性质、更新时间、职位 ID
- 让它写脚本,统计行数、不重复职位数、各单位性质数量;记下采集时间和搜索条件
自查
- 行数 30,按职位 ID 不重复 30
- 月薪拆成两列数字
- 抽 3 条回页面核对,一致
- 说得出分页栏显示的页数为什么不能直接信
课程材料
VII上机 · 练习二
练习二:核一份文献清单
- 打开材料包里的综述段落和 6 条参考文献
- 让智能体逐条用 Crossref、Semantic Scholar 核对,每个结论附上它请求的链接
- 填核验表:是否存在、信息是否一致、能否读到摘要、是否支持原句、结论
自查
- 编造的那条,判为“未找到”,没有给出摘要或页码
- 信息有误的那条,指出错在哪、正确值是什么
- 不支持原句的那条,对照摘要说出差在哪
- 查不到的中文文献,没有判为假
课程材料
VII上机 · 练习三
练习三(进阶):用在自己的项目上
- 打开你正在做的数据采集—分析—报告项目
- 三选一:① 报告里的关键数字,搜索并读原文,补上链接和发布日期;② 用练习二的办法核自己的参考文献;③ 用浏览器工具从一个公开网站补采数据
- 把结果写进项目的来源清单或数据核查记录
自查
- 每个数字、每条文献都有能点开的来源和日期
- 随机抽 2 处,打开来源核对,一致
- 补采的数据写明采集时间、条数,以及遇到的登录、加密或拦截
课程材料
VII复盘
复盘:谁的结果和别人不一样

课程材料











