从第一次调用，
到你自己的 Agent。

用同一个 Python 文件走完三个步骤。默认离线运行，无需密钥；跑通后，再接入真实模型。

0. 准备好环境

安装 Python 3.11 或更新版本（新标签页），新建 agent-lab 文件夹，将两个文件放进去，再用终端打开这个文件夹。项目只用标准库，无需安装第三方依赖。

py -3 --version
py -3 -m venv .venv
.\.venv\Scripts\python.exe agent_lab.py --self-test

python3 --version
python3 -m venv .venv
.venv/bin/python agent_lab.py --self-test

预期输出包含 "ok": true, "mode": "offline", "checks": 9。找不到 Python 或 venv 时，按下载的运行说明排查。

1 → 2 → 3. 一步一步运行

下面的 python 替换成上方虚拟环境的解释器路径，不必激活环境。

python agent_lab.py --step plan
python agent_lab.py --step tool
python agent_lab.py --step agent

1. 任务提取：校验 title、owner、due_date，得到小林的任务。读 validate_plan，试着把 title 改成数字。
2. 只读工具：get_task 返回 T-1。读 execute_tool，尝试不存在的 ID 和非法参数。
3. Agent 循环：第一轮请求工具，第二轮收到结果。读 run_agent，对照 tool_use_id，确认最多三轮停止。

离线模式使用固定假数据，不理解自然语言。日志中的 fixture: true 用来提醒你区分模拟与真实调用。

让它失败一次

python agent_lab.py --step plan --simulate schema-error
python agent_lab.py --step agent --simulate unknown-tool
python agent_lab.py --step agent --max-turns 1

三次运行都应该退出，返回 ok: false。依次观察 schema_error、turn_limit、turn_limit，失败也是验收的一部分。

准备好了，再接真实模型

运行说明包含 Windows 和 macOS / Linux 的配置命令。密钥与模型 ID 只在你的终端设置；加 --mode live 后才请求 Claude 官方 API，并消耗你的额度。每轮最多 512 输出 token，默认最多三轮，无自动重试。

真实模式使用 HTTP 请求和本地 JSON 校验，接口拒绝、超时或不合格输出会报错。学习网页不发起模型调用，也不接收你的密钥。