模型负责理解自然语言,工具负责执行明确的代码。本章先运行固定数据与规则,看到的输出不是模型回答。
在独立文件夹运行
下载并解压项目包,在该文件夹打开终端。使用 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,审计里没有取消动作。
若结果不对,先看输入与过滤条件,再检查业务规则。此时模型还没有参与,调提示词解决不了代码里的范围错误。
这一节,交付两份工具记录与一个新增反例。
- 实际运行测试与演示,记录命令和输出。
- 打开 domain.mjs,找到独立检查学校、学员和权限的位置。
- 在 test.mjs 末尾增加一条自己的反例,解释它防止什么错误。
怎样检查自己的作品?
- 能区分规则执行与模型回答。
- 能说明拒绝发生在代码的哪一层。
- 保留原测试,并实际运行新增反例。
先自己做,再来核对。
这里使用同一份合成案例。参考输出帮助检查判断,写作品时请保留自己的实际结果。
还没思路?用这份起步模板
先进入解压后的 business-agent-v1 文件夹: node --version node test.mjs node run.mjs 先保存自己的预测,再对照实际输出。
我已尝试,展开参考解法
- 查询结果必须只含当前教学身份可见的行;调用结果是拷贝,不能通过修改返回值偷偷改原数据。
- 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 只预填草稿,由你点击发送。