经济金融 AI 智能体设计与开源 · W0201 — 67
课程总览中山大学岭南学院 · 李学恒 / 张一帆
++中山大学岭南学院 · 2026 秋
人机协作、任务说明与项目规则
经济金融 AI 智能体设计与开源 · Week 2
把一次对话变成可以继续的项目
李学恒
中山大学岭南学院 · 微观经济与数字经济教研室
W0209 · 15
I发展趋势
2022—2026,AI 沿着三条线走向 Agent
脑更强对话 → 推理
2022-11ChatGPT自然语言对话
2023-03GPT-4理解与规划
2024-09OpenAI o1深度推理
2025-01DeepSeek-R1推理能力普及
手更多调用 → 操作
2023-06Function Calling调用外部工具
2024-10Computer Use操作电脑界面
2024-11MCP标准化工具接口
现在连接器生态接入更多软件与数据
更像员工回答 → 工作
2023Agent 框架多步自主执行
2025-02Claude Code项目级长链任务
2025-07ChatGPT Agent跨工具完成任务
2026 H1常驻智能体长期运行与汇报
三条线汇到一处:更聪明、更自主、更自动化。AI 的入口仍可以是对话,但它正在从回答问题走向完成任务。
I人的工作
AI 能做得更多,对人的要求也在提高
在适合交给 AI 的任务中,人会把更多精力放在定义任务、提供判断和承担最终责任上。
I一页认识智能体
Agent = LLM + Tool + Context
三个构件先记住入口。它到底怎么跑?接下来逐层拆开。
I看懂智能体
模型负责生成,Harness 负责组织和执行
模型提出请求;框架组织上下文、处理权限,并让工具执行。
I看懂智能体
一次任务,怎样经历多轮模型调用
一次聊天消息不等于一次模型调用;调用请求也不等于动作已完成。
I看懂智能体
拆开一次模型调用
本轮输入
任务与相关历史
读取的材料与状态
工具说明与工具结果
→
模型一次调用
→
本轮输出
回答文字
计划、解释或总结
结构化工具请求
工具名称与参数
文字会编码成 token;支持的接口也可携带图像等内容块。
在聊天里打印一段工具参数,不代表工具已经执行。
I热身
首先理解什么是大模型:接龙游戏
不许商量,不许跳过内容。
接龙游戏 · 张一帆课程材料
I发现 一
你刚才干的事,就是大模型在干的事
- 轮到你时,你没先想好整个故事,只是补上最顺的那一句
- 大模型也一样:读完前面全部内容,算下一个词最可能是什么
它是一台把话接下去的机器,不是一个知道答案的人。
接龙游戏 · 张一帆课程材料
II两个 Agent 底层约束
第一条约束:上下文容量有限
本轮可用的上下文预算规则任务资料历史工具结果还需考虑输出
Token 是处理单位
不等于字符数;不套用跨模型的固定换算。
容量因模型和接口而异
资料可以长期积累;每次使用仍要选择。
材料多时先列入口、缩小范围、按需读取;图中块宽不表示实测占比。
II发现 二
为什么接着接着,就开始编了
文档越读越离谱,不是模型变笨了,是前面那些信息已经不全了。
接龙游戏 · 张一帆课程材料
关键推论
模型无记忆,
所以上下文工程非常重要
每一轮送进什么材料,决定它做出什么判断——组织 Context,就是在组织它的工作条件
II发现 三
记不住前面,就得总结一次
- 接到第二十句,办法是找个人把前面压成三句
- 模型也这么干,这个动作叫 compact;总结时漏掉的,后面再也回不来
什么时候总结、哪些必须留住——这套固定做法就叫技能。
接龙游戏 · 张一帆课程材料
II收口
上下文的三种失败
这张图贯穿全课。上下文管理是整个智能体课程的核心。
接龙游戏 · 张一帆课程材料
II两个 Agent 底层约束
文件库、会话记录、本轮上下文
保存在磁盘或对话界面的内容,不等于本轮模型已获得全部内容。
II两个 Agent 底层约束
第二条约束:大语言模型的输入输出只能是字符串
知道文件名不等于获得内容;转换后检查错列、单位、缺页和来源位置。
II代码示意
代码可以先不懂,先认出输入和输出
from openai import OpenAI
client = OpenAI(
base_url = "https://api.deepseek.com", # 请求发给哪个服务
api_key = "sk-…", # 调用凭证
)
response = client.chat.completions.create(
model = "deepseek-chat", # 使用哪个模型
messages = [{"role":"user","content":"分析这份行业材料"}],
)
print(response.choices[0].message.content)
每一次和模型的对话,底层就是一次次这样的请求:本轮输入进去,本轮输出出来。
代码示意,密钥为占位
II两个 Agent 底层约束
为什么常用 Markdown 做中间底稿
# A01 核对记录
- 申报金额:180 元
- 明细合计:20 × 6 + 60 = 180 元
- 票据编号:FP-20260908-0031
| 结论 | 依据 |
| --- | --- |
| 符合给定规则 | 第 2、5、10 条 |
来源:A01_海报印刷_林晓.md,明细表
结构看得见
标题、列表、表格和来源,便于读取、修改与比较版本。
原件 → 可查底稿 → 最终文件
图表、公式与复杂版式仍需保留原件,必要时使用图像或专用解析工具。
Markdown 是常用中间格式;模型也能通过支持的接口处理其他内容。
II两个 Agent 底层约束
模型生成内容,工具生成文件
内容与版式分别验收;也可以让工具直接修改原格式模板。
II两个 Agent 底层约束
两条约束,怎样变成设计方法
短判断:材料太多、表格转错列,分别应该先做什么?
III权限与数据安全
Claude Code 有哪些权限模式
| 模式 | 怎样处理动作 | 学习时要分清 |
|---|
Manual
manual / default | 未预先允许的动作通常逐次审批 | 本课先确认手动审批 |
acceptEdits | 范围内文件编辑及部分文件命令自动获准 | 自动编辑仍可能覆盖或删除 |
plan | 探索材料、提出计划;通常不改源文件 | 不是操作系统级只读隔离 |
auto | 分类器自动审查动作,仍可拦截或提问 | 自动审查可能判断失误 |
dontAsk | 不弹常规审批,未获允许的动作被拒绝 | 不询问不等于全部放行 |
bypassPermissions | 跳过常规审批,仍有部分强制防护 | 初学阶段不从此模式起步 |
Manual 是界面标签;部分配置使用 default。本课以实际状态为准。
III权限与数据安全
权限放开,错误就可能变成文件损失
工作目录,
不是自动生效的隔离墙。
先看动作
目标路径是什么?
将覆盖、移动还是删除?
再看范围
工具与运行账号有权触及的文件,可能超出项目。
留出恢复办法
先用教学副本;重要原件事先保存可恢复版本。
初学阶段确认 Manual/手动审批,不从 auto 或 bypass 起步。
III权限与数据安全
敏感数据会发给谁,由你决定是否使用
先问:愿意交给对应网页版吗?这可作判断起点;网页与 API 条款仍需分别确认。
III权限与数据安全
重要文件改坏了,怎样找回来
Git 项目版本
保存已记录的阶段版本;比较、恢复。
要事先提交。
云盘历史版本
从历史版本或回收站恢复;确认保留条件。
同步也可能传播误删。
Time Machine
Mac 配合外置硬盘备份;查看最近成功时间。
备份磁盘需设置并可用。
用无敏感副本确认恢复入口。安装了工具、看到同步图标,都不等于已经有可恢复版本。
重要文件要有可恢复的副本;同一硬盘上的历史不能应对整盘损坏。
IV第四至六部分路线
先搭工作现场,再交代任务、写规则
① 打开项目
一个任务一个项目文件夹,
在项目里启动 Claude Code。
② 分区与边界
inputs、references、outputs、notes:
哪些只读,哪些可写。
③ 最佳人机会话原则
六要素写清本次任务;
六个心法把一轮对话走稳。
④ 两级 CLAUDE.md
项目级写这个项目的约定;
用户级写跨项目的个人偏好。
①② 搭好的现场每次都用;③ 每接一个新任务重来;④ 把反复有效的约定写进文件。①② 在本部分,③ 在第五部分,④ 在第六部分。
IV① 打开项目
在 VS Code 里打开项目,再启动 Claude Code
它从启动目录找材料,所以先 pwd 确认位置。启动目录不是隔离墙,能碰到哪些文件还要看权限。
原图示例为文献综述
IV① 打开项目
打开 agent-lab,完成第一次对话
打开项目文件夹
VS Code →“打开文件夹”→ agent-lab。
左侧能看到 W01 的 README.md。
在集成终端启动
pwd 确认在 agent-lab;再输入:
claude --permission-mode manual
确认模式与接收方
界面显示 Manual/手动审批;
/status 看模型与接口地址。
读取 README.md,用一句话告诉我里面写了什么。只读,不要修改。
最常见的障碍:没在项目目录启动,它找不到你的文件。
IV① 打开项目
三个常用命令与三种工作模式
/compact 就是接龙游戏里的“总结一次”。练习用普通(Manual)模式;想先看方案,按 Shift+Tab 切到计划模式。
IV② 分区与边界
练习材料包
教学模拟 · A01
迎新经济学沙龙 · 海报印刷
180申报金额 / 元120 + 60海报与易拉宝 / 元
20 张海报、1 个易拉宝。
票据编号:FP-20260908-0031。
先区分三类材料
输入:A 批 6 份申请、7 个文件。
参考:教学规则 13 条。
样例:核对表表头与格式。
B 批 2 份留到新对话时再放入项目。
下载 W02 学生练习包 ↓练习仅做模拟材料核对,不执行真实审批、支付或对外发送。
课程案例与练习 · 教学模拟
IV② 分区与边界
材料全堆在一起,会出什么问题
agent-lab/
├── README.md
├── A01_海报印刷_林晓.md
├── A03_茶歇明细.csv
├── 活动经费规则_教学模拟.md
├── 核对表样例.md
├── 核对结果.md
├── 核对结果_改过.md
└── 临时想法.txt
读错依据
样例、旧结果和原件放在一起,它可能把旧结果当成事实来源。
改到原件
输入和输出不分,一次“修改”可能落在原始申请上。
找不到成果
新文件散在根目录,说不清哪一版是最新的。
整理现场先定三件事:它看哪里、规则写在哪、第一轮先做什么。
课程案例 · 教学模拟
IV② 分区与边界
四个分区,各有读写边界
目录名可以换,分区原则不变:输入、参考只读;输出、笔记可写;规则写进 CLAUDE.md。
原图示例为文献综述项目
IV② 分区与边界
换到经费核对项目:一个任务一个文件夹
| 位置 | 放什么 | 读写 |
|---|
w02/经费核对/ | 项目文件夹,下面五项都在它里面 | 在这里启动 |
inputs/A批/ | A0 开头的 7 个申请文件 | 只读 |
references/ | 活动经费规则、核对表样例 | 只读 |
outputs/ | 核对表初版与修订版 | 可写 |
notes/ | 任务说明、检查记录、决策日志 | 可写 |
CLAUDE.md | 把上面的边界写下来 | 规则载体 |
建 w02/经费核对/ 和其中的 inputs/A批、references、outputs、notes 空文件夹,不改其他文件。
材料由你自己复制进去,再 cd w02/经费核对 重新启动:在哪个文件夹启动,哪个文件夹就是项目。
学生实操手册第二步 · 位置可按任务增加,不是固定目录规范
V六要素
一条好指令 = 六个要素
写指令就是从上往下把这六件事交代一遍——缺哪条要素,就返工哪条。
示例为课程论文场景
V心法 1/6
先对话,再让它干活
❌ 直接甩一个大任务
- “帮我想一个课程论文选题。”
- 输出:几个宽泛题目 + 通用框架
- 它不知道你的课程、数据和兴趣
✅ 先聊清楚,再执行
- 我在写劳动经济学课程论文——你先别急着写,先问我 5 个你需要了解的问题
- 它会反问:课程要求?能拿到什么数据?篇幅?想用什么方法?截止时间?
- 把答案告诉它,再让它写
AI 会“猜”你的意图,但猜得不准。让它反过来问你,是高质量输出的前提。
V心法 2/6
让 AI 复述需求,再动手
动手之前,请用 5 句话复述我的需求,并列出你的 3 条核心假设。我确认后你再做。
立刻发现误解
你以为说清楚了,
它听到的是另一回事。
暴露隐藏假设
它列的假设,
常是你没意识到的盲区。
留下对齐记录
这段对话本身,
就是好的项目记录。
越重要的产出越要用:复述花几十秒,返工花几十分钟。
V心法 3/6
复杂任务先出计划,再逐步展开
❌ 指望一次到位
- “帮我写完这篇课程论文。”
- 它一口气写 5000 字,你看完发现方向错了
- 全部推倒,时间白费
✅ 先要计划,确认后展开
- 先别写正文,第一步给我大纲:章节、每章要点、需要的数据
- 大纲可以先改:“第三节不做文献综述,改成数据描述”
- 确认后,再让它逐节展开
超过 3 个步骤的任务都适用。Claude Code 里按 Shift+Tab 切到计划模式:它先读材料、列计划,通常不改文件。
V心法 4/6
切换话题,新开会话
❌ 一个会话做所有事
- 上午在会话里核对 A 批经费
- 下午接着让它写社团活动宣传稿
- 宣传稿里冒出核对表的口吻和规则——上下文污染
✅ 每个独立任务一个会话
- 换任务时输入 /clear,或退出后重新启动
- 不同项目放不同文件夹,各有自己的 CLAUDE.md
- 同一任务可以连续做,连贯是优势;要接回旧会话用 /resume
新开会话零成本,清除污染代价高——宁可多开几个,不要图省事共用。
V心法 5/6
给角色 + 给框架,输出更专业
❌ 普通问法
- “帮我分析一下学校食堂要不要涨价。”
- 输出:几条优点 + 几条缺点,平铺直叙
✅ 专业问法
- “你是熟悉产业组织的经济学助教,用供需分析 + 成本收益两个框架分析食堂要不要涨价
- 每个维度给 1 个判断 + 1 条依据 + 不确定在哪里”
- 输出:结构化分析 + 还需要补的数据
经济分析
供需 · 弹性 · 成本收益实证
描述统计 · 回归 · DID战略
SWOT · PEST · 波特五力沟通
SCQA · 金字塔 · STAR项目
WBS · 甘特图 · 风险矩阵
V心法 6/6
让 AI 自己批判自己,再改一遍
你刚才的结果有什么不足?请挑出 3 个最严重的问题:① 逻辑漏洞 ② 结构缺陷 ③ 依据不足。然后据此改一版,告诉我你改了什么。
一次输出趋向平均
给一个大家都能接受、
但不出彩的答案。
内置一个挑剔的同事
换视角:“用审核老师的眼光挑毛病”
“这个结论在哪 3 种情况下会错?”
成本是多打 50 字
追问一轮,
常能补上漏掉的依据。
它挑出的问题,你仍要回原始材料确认;自我批判不能代替你的核验。
V练习
用六要素写 A 批任务
背景迎新活动的经费申请要整理给活动负责人检查;依据 references/ 中的教学规则与样例。
任务逐份核对 inputs/A批/ 的全部申请,形成逐项核对表。
约束原件不改,缺失不补造;本轮只处理 A 批,不外发、不审批或支付。
格式outputs/核对表_v1.md:编号、申请人、类别、金额、结论、依据、来源与待确认问题。
自检全部条目有去向;金额按明细复算;缺失和可能重复均标明。
先让它列出材料、缺口和计划,确认后再生成。完整文本见练习包 任务说明_A批.md。
课程案例与练习 · 教学模拟
V避坑
新手最容易犯的 6 个错
01 不给背景直接下指令❌ “帮我想个论文选题”→ 输出空洞✅ 先讲清课程、数据与要求,或让它反问 5 个问题02 一次甩大任务❌ “帮我写完整篇论文”✅ 先要大纲 → 确认 → 逐节展开03 数字不核查直接用❌ 把它写的“申报 327 元”直接抄进核对表✅ 关键数字回原件复算,找不到来源就不用04 同一会话做不同事❌ 上下文污染,口吻和规则串台✅ 独立任务新开会话,不同项目分文件夹05 敏感数据直接发出去❌ 把含学号、成绩的名单交给模型✅ 先想清数据发给谁,用脱敏副本06 期望一次到位❌ 第一版不满意就放弃✅ 第一版 → 自我批判 → 核验 → 修订 ①→心法 1 ②→心法 3 ③→第七部分核验 ④→心法 4 ⑤→第三部分 ⑥→心法 6
VI④ 项目规则
CLAUDE.md:把长期有效的规则写成文件
# 项目用途
活动经费核对(课程练习)。
# 文件约定
- inputs/ 放原件,保持不变。
- references/ 放规则与样例。
- outputs/ 放成果;notes/ 放任务与判断记录。
# 资料与交付
- 事实、数字注明来源;缺失、冲突不补造。
- 修订保留版本;完成后说明位置和检查结果。
适合写进去
项目背景、目录约定、工作方式、关键约束、验证方式。
不写进去
一次性任务目标、常变的临时细节。权限、环境变量等运行设置放 settings.json。
Claude Code 启动时读取项目根目录的 CLAUDE.md。精简比求全重要:留下会反复影响结果的规则。
VI④ 项目规则
两处 CLAUDE.md:项目级与用户级
项目内的归项目,跨项目的归用户;Skill 也按这两级存放。
VI④ 项目规则
两级规则,各写什么
| 层级 | 放在哪里 | 对哪些项目生效 | 例子 |
|---|
| 项目级 | w02/经费核对/CLAUDE.md | 在这个项目文件夹里启动时读取 | inputs/ 只读;金额先按明细复算 |
| 用户级 | ~/.claude/CLAUDE.md Windows:C:\Users\用户名\.claude\ | 你电脑上的所有项目 | 回答用中文;中英文之间加空格 |
输入 /memory,看读到的规则文件路径;agent-lab 根目录不放 CLAUDE.md。
Codex 读 AGENTS.md:Mac 上 ln -s CLAUDE.md AGENTS.md,两个工具读同一份。
判断标准:换一个项目,这条还适用吗?适用写用户级,不适用写项目级。
VI④ 项目规则
项目规则和工具权限,各管什么
规则表达约定,权限处理批准,系统权限与沙箱决定实际可达范围。
VI④ 项目规则
CLAUDE.md 的三个误区
混入临时需求
写进“本次只处理 A 批”,
做 B 批时它还在干扰判断。
写成百科全书
越写越长,
关键约束反被淹没。
写完不维护
目录、输出路径变了,
规则要跟着改。
动手:打开 模板/CLAUDE_模板.md,删掉你解释不了的条目,保存为 w02/经费核对/CLAUDE.md。
规则文件不是启动仪式:项目变了,规则跟着改。
学生实操手册第五步
VI④ 项目规则
三层规则分工:会话级、项目级、用户级
会反复生效就写进文件,只管这一轮就留在会话。图中“系统级”即用户级 CLAUDE.md。
原图示例为文献综述
VI④ 项目规则
这些要求,分别放在哪一层
| 要求 | 放在哪里 | 理由 |
|---|
| 本次只处理 A 批 | 会话(任务说明) | 只管这一轮 |
| 原始材料不改动 | 项目级 CLAUDE.md | 这个项目一直适用 |
| 中英文之间加空格 | 用户级 CLAUDE.md | 所有项目都适用 |
| B 批还没跑;成果在哪里打开 | 决策日志/README | 记录进度与入口,不是规则 |
短题:原始数据不改/回归表三位小数/今天只改综述/本轮不跑代码/表格统一输出位置。分别归哪一层?
最常见的错误:把临时任务写进项目规则,任务一换,旧要求还在干扰。
信息分工方法 · 助教第 4 章分类练习
VII完成一轮协作
从材料到初版:一起核对 A01
教学示例
回到 A01 的明细表
申报:180 元
海报:20 × 6=120 元
易拉宝:1 × 60=60 元
120 + 60 = 180
第 2 条信息齐全;符合第 10 条金额关系;未超过第 5 条的 300 元标准。
逐项核对表中的一行
结论:符合给定规则。
来源:A01_海报印刷_林晓.md,申请信息、明细表及申报总额。
待确认问题:无。
观察:找到原件 → 读取规则 → 核算 → 写一行 → 回查。
把这一行的核验方法,用到 A 批其余每一份申请。
A01 教学模拟 · 人物、组织与金额均为虚构
VII完成一轮协作
你来跑第一轮
保存说明
确认本轮 A 批范围与输出路径。
看计划
检查材料清单、缺口与执行步骤。
运行并打开
批准范围明确的动作,打开初版。
立刻核验
先核对一条,再检查全部条目。
按已确认的 A 批计划生成 outputs/核对表_v1.md。
完成后说明文件位置、已做检查与仍待确认的问题。
环境尚未通时先在教学示例上练核验,实际运行未完成的步骤据实记录。
课程案例与练习 · 教学模拟
VII完成一轮协作
用原始材料检查结果
A03 回查 CSV;A02 检查缺项;A04/A05 对照票据;A06 核对规则是否覆盖。
校园活动经费核对 · A 批教学模拟
VII完成一轮协作
给出能执行的修改意见
位置 → 问题 → 原始依据 → 修改要求 → 复查方式
以 A03 为例:CSV 明细为 72+85+140=297 元,申报为 327 元。
请依据第 10 条标注“存在差异”、差额 30 元,并写明 CSV 来源。
另存 核对表_v2.md,保留 v1,再复查其他申请的金额与标准。
初版若正确,可以新增“按结论列出编号索引”的要求再修订;不用制造错误。
有依据地接受、修改或拒绝;反馈要让下一步动作清楚。
A03 教学模拟 · 反馈写法示例,不代表实际模型必然犯错
VII完成一轮协作
这次的经验,下次放在哪里
选择一条反复适用的检查写回规则或模板,并说明理由。
VII完成一轮协作
决策日志:记录你作了什么判断
| AI 建议或输出 | 我的判断 | 原始依据 | 修改与复查 |
|---|
| 示例:直接采信申报 327 元 | 修改 | A03 CSV 合计 297 元;第 10 条 | 写算式与差额 30 元;另存 v2 并复查 |
| 你实际获得的结果 | 接受/修改/拒绝 | 写文件、小节、规则与计算 | 写实际动作及结果,未完成据实说明 |
同时记录对应成果路径、哪些经验下次沿用。一次经核验的“接受”,也值得留下依据。
在切换对话前,保存本次判断和当前进度。
决策日志格式与示范条目 · 示例不是模型实测记录
VII完成一轮协作
开一轮新对话,继续这个项目
先保存
A 批修订版、更新规则、日志与 README 进度。
仍用同一项目
读取 README、规则与决策日志中的进度。
再核对续接
能否找到依据、更新内容与下一步?
请读取 README、项目规则和 notes/决策日志.md。
复述 A 批已完成内容、待确认问题,以及处理 B 批应沿用的约定。
先确认材料与规则,再开始 B 批。
新对话需要拿到所需依据;不要依赖“它应该还记得”。
VII完成一轮协作
换一批材料,再检查一次
用 B01、B02 检查更新后的约定是否被使用;记录本次表现,不推成永久保证。
VII完成一轮协作
独立完成:把项目交给下次的自己
能找到任务
README 入口、任务说明、适用规则。
能比较修改
初版、修订版和实际检查记录。
能解释判断
决策日志:采用什么、为何修改或拒绝。
能接着做
README 状态:完成到哪里、缺什么、下一步。
同伴验收:按你的说明找到一项结论,并回查原始材料与规则。
尚未完成的步骤写清卡点;交接依靠文件和证据。
课程案例与练习 · 教学模拟
VII完成一轮协作
换个任务,还需要哪些东西
社团纪要
区分决定、建议、待确认;负责人和期限不能猜。
实习岗位对照
依据给定岗位资料,比较要求并标注来源。
课程通知整理
提取事项、日期与动作;缺少截止时间就列缺口。
跨境电商汇报
先用六要素写任务说明,再生成 7 页大纲。
先选社团筹备会记录,用六要素写清角色、背景、任务、约束、格式与自检。
核对一个事项:它是已经决定,还是讨论中的建议?
方法能迁移:任务说清楚,结论有来源,输出能检查。
社团纪要为教学模拟 · 跨境电商例题:8 分钟、7 页、四份模拟材料
VII完成一轮协作
这一轮留下了什么
现在指出:你的成果、检查记录和决策日志分别保存在哪里。
课堂成果保存在个人项目文件夹