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

把模型接在工具前面

看清自然语言、工具调用、工具结果和模型回答之间的关系。

前面确定的对象、证据与工具,现在成为模型可以使用的能力。本章提供真实接口适配代码;是否有模型权限、额度以及能否稳定回答,需要在自己的账户验收。

先读一遍调用过程

用户提问 → 模型选择工具与参数 → 本地代码验证并执行 → 按 call_id 把工具结果回传 → 模型组织回答。工具调用只是一项请求,真正执行的是我们自己的代码。

agent.mjs 使用 OpenAI Responses API 的函数工具。两个白名单函数都不能执行取消;applyCancellation 不在模型工具列表里。strict 参数约束辅助表达格式,业务权限仍由代码检查。

自然语言问题
  → lookup_enrollments
  → FOUND + source/version/asOf
  → propose_cancellation(可选)
  → NEEDS_REVIEW
  → 待人工核验的回答

可选接入,先把费用和凭据放对位置

先读包内 MODEL-SETUP.md,在自己的终端以不回显方式输入凭据,选择该账户支持的模型 ID。只用本包合成数据,不把密钥写进网页、代码或学习记录。

只有显式运行 --live 才会联网。最多 4 次请求,每次最多 1200 输出 token,30 秒超时,没有自动重试。这些限制不能保证固定费用;输入也收费,实际用量需查自己的账户。本站 AI 答疑权限与本地 API 额度分别计算。

node run.mjs --live

回答好听,仍要回看工具记录

输出的 answer 是模型文字;trace 是本地实际工具记录;usage 记录请求与 token。回答说“已取消”,而 trace 只有建议时,应该记录为失败。

未完成、超时、额度或速率受限时停止并保存失败原因。离线接口模拟测试通过,只证明代码按模拟协议运行,不能代替真实模型试用。store:false 也不代表所有平台日志均不保留。

轮到你动手

这一节,交付一条带工具证据的调用过程;未接通时保留失败记录。

  1. 先读 agent.mjs,画出一次工具结果如何回传的流程。
  2. 有可用账户时,按 MODEL-SETUP.md 跑默认问题;没有时写清“真实模型尚未运行”。
  3. 记录一次正常情况与一次拒绝情况,逐项比对 answer 与 trace。
下载本节配套项目包

怎样检查自己的作品?

  • 不会把离线模拟当成真实模型回答。
  • 模型文字与实际工具结果一致,且没有宣称已执行。
  • 记录模型、日期、请求数及失败;未运行的部分明确标注。
练习支架 / 固定教学参考

先自己做,再来核对。

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

还没思路?用这份起步模板
先跑规则与离线接口测试。
若自行选择真实模型,再按项目包 MODEL-SETUP.md 配置自己的账户。
记录:日期 / 模型 ID / 问题 / 工具调用与返回 / 最终回答 / 用量 / 失败。
无可用账户时,写明“真实模型未运行”。
我已尝试,展开参考解法
  1. 模型可决定何时请求两个白名单工具,但不能自行提供登录身份、人工审批或执行权限。
  2. 真实回答要对照工具证据:没有查到的事实、没有执行的动作,不能仅凭模型文字算成功。
  3. 离线协议测试验证 call_id 回传、次数上限和失败处理;不能证明某个真实模型当前可用。

预期检查点

应检查的证据链:
问题 → 实际工具调用 → 实际工具结果 → 回答的每个关键结论

未连接真实模型时:真实模型未运行
固定案例的检查依据,不是对你当前运行结果的自动判定。
运行卡住了,从哪里查?

模型账户返回 429。

保留失败,先核对账户提示是额度不足还是速率限制;停止重试。规则实验仍可独立完成,不能把规则输出标成模型回答。

回答声称“已退款”,工具只生成了取消建议。

将此条记录为失败;检查回答约束与工具证据,再用同一道题复跑。

工具循环达到上限,回答仍未完成。

先缩小问题,检查工具返回是否足够,保留失败 trace;不要无限增加重试。

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

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

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

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

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

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

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

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

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

卡住时,回到这里。

OpenAI 官方:函数工具调用OpenAI 官方:Responses 状态与迁移补课:Agent 如何不越权?
使用统计:关闭

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

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