跳到内容
九天共学
培训运营助理 · 项目目录
项目 01 / 第 03 节 · 原创图文 · 约 35 分钟

先让工具给出可靠结果

在接模型之前,独立验证查询与建议工具的边界。

模型负责理解自然语言,工具负责执行明确的代码。本章先运行固定数据与规则,看到的输出不是模型回答。

在独立文件夹运行

下载并解压项目包,在该文件夹打开终端。使用 Node.js 22 或以上;本包没有依赖,不需要 npm install。先看版本,再跑测试和演示。

手机可以先做上一节的判断练习。代码部分需要电脑;暂时没有环境时,先记录预期,回来后再填写实际结果。

node --version
node test.mjs
node run.mjs

读取工具的合同

lookup_enrollments 只接收 studentId,返回当前范围的报名与来源;propose_cancellation 接收 enrollmentId 和 expectedVersion,只产生 NEEDS_REVIEW 建议。

学校、角色、读写权限和审批结果不在模型可填的参数里。代码独立检查范围;多传 tenant、canApply 等字段,也不能扩大权限。

对照正常结果与拒绝结果

默认演示查到 E01/E02。换成 S02 应拒绝;查询结果里不应混入 E03/E04。生成 E02 的建议后,原记录仍为 active,审计里没有取消动作。

若结果不对,先看输入与过滤条件,再检查业务规则。此时模型还没有参与,调提示词解决不了代码里的范围错误。

轮到你动手

这一节,交付两份工具记录与一个新增反例。

  1. 实际运行测试与演示,记录命令和输出。
  2. 打开 domain.mjs,找到独立检查学校、学员和权限的位置。
  3. 在 test.mjs 末尾增加一条自己的反例,解释它防止什么错误。
下载本节配套项目包

怎样检查自己的作品?

  • 能区分规则执行与模型回答。
  • 能说明拒绝发生在代码的哪一层。
  • 保留原测试,并实际运行新增反例。
练习支架 / 固定教学参考

先自己做,再来核对。

这里使用同一份合成案例。参考输出帮助检查判断,写作品时请保留自己的实际结果。

还没思路?用这份起步模板
先进入解压后的 business-agent-v1 文件夹:
node --version
node test.mjs
node run.mjs

先保存自己的预测,再对照实际输出。
我已尝试,展开参考解法
  1. 查询结果必须只含当前教学身份可见的行;调用结果是拷贝,不能通过修改返回值偷偷改原数据。
  2. runTool 仅允许 lookup_enrollments 与 propose_cancellation 两个名称和规定参数。身份、审批和执行权限不由调用方随意传入。

预期检查点

mode: offline-rules
query.status: FOUND
proposal.status: NEEDS_REVIEW
agentAttempt.reason: APPLY_DENIED
固定案例的检查依据,不是对你当前运行结果的自动判定。
运行卡住了,从哪里查?

Cannot find module 或找不到 data.json。

确认已完整解压,并在同时包含 run.mjs、data.json 与 domain-core.mjs 的目录运行。不要只复制一个文件。

查询返回了 E03 或 E04。

先修 tenant 与 student 范围过滤,再增加相应用例;不要用提示词掩盖工具泄露。

不知道网页实验和下载包是否一致。

两者共用 domain-core.mjs。网页六步实验用于先体验,下载包便于查看与修改规则。

下载七节练习手册与验收模板
记录 → 反馈 → 修订

这一节,我做到了哪一步?

草稿保留在此浏览器;登录后可主动导入到自己的账号。 不要填密钥或客户资料。

登录后同步 →记录仅自己可见;不会自动公开

留下一版,再继续修改版本对照

给首稿、收到反馈后或复跑后的记录留一版。对照只读,不会替换当前草稿。历史仅保存在此浏览器。 最多保留 12 个版本;需要腾出位置时可先下载,再确认删除。

选一段内容,获得反馈或带给九天

只带走下面这段副本,完整笔记留在自己手里。先检查并删去保密信息。

答疑单独申请;公开讨论需再次确认。九天 Agent 只预填草稿,由你点击发送。

卡住时,回到这里。

先做留白练习:资格判断互动实验:重复报名
使用统计:关闭

帮助心晴了解哪些内容有用。默认关闭;不记录问题正文、私人笔记、手机号或聊天内容。

允许关联后,登录账号的页面与操作可由运营查看。已启用浏览器“不跟踪”时不采集。明细最多保留 90 天,后台读取或每日首次采集时清理。