C40

课程检索工具

任务说明

AI 工程

实现一个只接收受控参数的课程检索工具：query 1~80 字、track 枚举、limit 1~10，使用 .strict() 拒绝多余字段。返回带 course_code 和 lesson_id 的可定位片段；没有结果时返回 { results: [], total: 0 }，绝不编造课程或来源。交付一个最小 Next.js 工程（next 16 / react 19 / zod），本练习聚焦工具实现，不直接调用模型；真实项目接入模型时，工具参数仍先过同一套 zod 校验，密钥只放服务端 AI_API_KEY / AI_BASE_URL / AI_MODEL。验收：在练习目录执行 node tests/check.mjs solution 应输出 ALL CHECKS PASSED，对 starter 应至少一项 FAIL；本机 npm install && npm run dev 的人工步骤见 tests/README.md。

要求

searchCoursesInput 用 zod 限制 query/track/limit 并 .strict()
searchCoursesTool 的 JSON Schema 含 name: 'search_courses'、additionalProperties: false，参数与 zod 保持一致
searchCourses 在课程标题、简介、课时标题和正文中匹配，结果带 course_code、lesson_id、snippet、score
无命中显式返回空 results；route 先 safeParse，失败返回 400 invalid_tool_args

A15 工具调用的工作过程 A16 工具参数与校验 A21 关键词与混合检索

分层提示

先自己试，再逐层展开。

参考答案

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

课程检索工具

Command Palette