想让 AI 帮你取得数据并画图,第一步是说明研究对象与统计口径。例如“看看增长和失业的关系”,还没有确定国家、时期、失业率的定义以及应该分析水平还是变化。Marx Max 可以围绕明确任务协助编写和修改程序;研究者需要检查来源、实际代码和输出,判断结果支持什么。
配套的World Bank 六国案例把这项任务展开为一份可下载练习:从官方 API 新取得公开数据,在隔离环境用 Python 与 Stata 分别计算,再对照数值。它提供的是实际计算成果,不是模型自动完成任务的实测记录。
先把问题写成可执行的任务
案例保留美国、中国、日本、德国、英国和加拿大 1991–2024 年的年度数据。1991 年为差分提供上一年,作图与回归使用 1992–2024 年。
在新的练习项目中,可以提出这样的任务:
只使用 World Bank 官方 API 的公开数据,获取六国 1991–2024 年的实际 GDP 年增长率和 ILO 模型估计总失业率。保留原始响应、指标定义、来源和获取时间。按国家与连续年份计算失业率年度变化,缺失不另行填补。用 1992–2024 年的完整观测画 2 行 3 列散点图,添加逐国拟合线及其 95% 均值置信带。保存 Python 程序、Stata 复做程序、CSV、图和实际日志;只写入本练习目录。解释相关关系,不作因果或国家排名。
这是一项自然语言任务示例,不是一个固定的专有命令。连接和执行仍取决于当前环境;若要使用 Stata,先按Stata 使用指南连接本机合法安装。在已有项目上继续时,先保存工作并明确读取和写入范围。
来源记录和整理后的数据分别保留
World Bank 的指标 API提供公开查询。这里选择 World Development Indicators(source 2),使用 NY.GDP.MKTP.KD.ZG 和 SL.UEM.TOTL.ZS。获取代码限定国家、年份和指标,并检查响应分页、重复键和记录数量。
原始 JSON 保留 API 返回的值与元数据;CSV 将两个指标整理为国家—年份行。将两者分别保存,才能区分来源修订和整理错误。provenance.json 记录请求地址、获取时间、来源更新日期及文件哈希;网页上的结果对应这次快照,不代表未来重新下载仍会得到相同值。
GDP 指标的单位是年增长率 %。失业率指标是劳动力中的失业比例,来自 ILO 模型估计,包含来源方的模型插补。我们不再补值,不意味着来源中每个数都是直接调查观测。它也不能无条件替代各国通常公布的失业率,更不适合据此排名。
检查年份、差分和实际样本
失业率变化是今年减去年,单位为百分点;它不同于失业率的百分比增长。程序要按国家对齐连续年份,遇到空值保留为空,不能跳过一个年份再把两年的差写成一年。
本次取得 204 个国家—年份行,两个指标都没有空值。去掉仅提供上一年输入的 1991 年,每国参与回归的样本为 33 个观测。正式研究应把“计划取多少年”和“实际用了哪些年”分开核对,不能只看图是否顺眼。
图和回归回答的是哪一个问题?
本案例分别拟合“失业率年度变化对当年 GDP 增长率”的带截距线性关系。每个点代表一个年份,置信带是均值拟合线的 95% 区间,不是未来年份的预测范围。六国使用共同坐标尺度,但没有混合估计一个斜率。
样本中美国和加拿大的负斜率较明显,中国的拟合线接近水平。这个观察提醒我们先看数据,再讨论是否以及怎样体现奥肯关系。模型使用常规 OLS 标准误,没有处理年度自相关、疫情异常点或结构变化。图不能解释增长变化的原因,也不能识别增长对失业的因果效应;正式研究需要另定时期、口径和推断方法。
下载后从快照复做,再决定是否更新数据
完整案例包包含公开 API 响应、数据 CSV、获取代码、Python 与 Stata 分析程序、两套图与结果,以及 README 和数据归属说明。两项指标的官方元数据标示 CC BY 4.0,使用与再分发时须保留来源及数据条款。
先解压到新空目录,保留一份参考成果,按 README 从包根目录运行。Python 的依赖安装会访问软件源,分析程序本身离线;Stata 可以独立读取同一 CSV,不需要 Python 或额外 Stata 命令。核对日志完成标记、六国各 33 个观测、系数和区间。这两套实现已在 macOS 独立实算并对照,Windows 真机复做未覆盖。
只有需要更新时,才显式运行获取程序重新请求 API,然后重跑分析。新数据可能修订,因而应保留原快照并比较获取时间。程序会覆写练习目录内同名成果,Stata 的 clear all 会清空该会话内存,先保存现有分析。
在 Marx Max 中尝试时,可以用这个公开包建立单独的练习项目,围绕实际代码和输出继续修改。公开数据无需访问个人文库;使用云端 AI 时,对话及工具返回内容仍会发送给模型服务,处理范围见研究数据说明。换成自己的研究时,重新确定资料许可与分析设定,而不是只改国家名就沿用解释。