C41

工具执行回路

任务说明

AI 工程

实现有界工具执行回路：模型返回 tool_call 后，服务端校验工具白名单与参数、执行工具、把结果以 tool 角色回传，最多 MAX_ROUNDS=4 轮；超过轮次返回 max_rounds，取消时及时结束并返回 499。每一步都写入 trace。交付一个最小 Next.js 工程（next 16 / react 19 / zod），真实模型调用位置使用受控 mock：未配置 AI_API_KEY 时走 mock，配置 AI_API_KEY、AI_BASE_URL、AI_MODEL 后走 OpenAI 兼容接口。验收：在练习目录执行 node tests/check.mjs solution 应输出 ALL CHECKS PASSED，对 starter 应至少一项 FAIL；本机 npm install && npm run dev 的人工步骤见 tests/README.md。

要求

lib/tools.ts 固定 ALLOWED_TOOLS，只包含 get_course_outline 和 search_lessons，两个参数 schema 都 .strict()
executeTool 先 isAllowedTool 再 parse 参数，白名单外抛 tool_not_allowed
lib/agent.ts 用 for 循环最多 MAX_ROUNDS 轮，每轮检查 signal.aborted，超过上限返回 code: 'max_rounds'
每轮 trace 记录 tool_call / tool_result / final，工具结果以 role: 'tool' 回传
route 校验 messages 后调用 runAgent，abort 返回 499

A15 工具调用的工作过程 A17 多轮工具执行

分层提示

先自己试，再逐层展开。

参考答案

卡住时再看；查看操作会记录下来用于复盘。测试版本 1.0.0

工具执行回路

Command Palette