工具 · · 1 分钟。阅读

为什么需要 OpenAI Agents SDK:基于已验证参数的确认

按操作实际执行时的样子去确认它,并在恢复时不丢失拒绝的原因。

简短回答

OpenAI Agents SDK 中基于已验证参数的确认带来了什么?

2026 年 9 月 17 日的 0.22.3 版本使条件确认与已验证的工具调用参数保持一致,并在服务端会话恢复时传递“未找到工具”的结果。确认针对的是具体操作,因此人的决定应当依据真正会被使用的那些数据。

Elena Artemova(叶莲娜·阿尔捷莫娃 / Елена Артемова) · 发布 · 更新 · 该工具的目的 · 附应用实例.

确认是针对具体操作的约定

确认某项操作的人,认可的不是意图,而是具体的调用:操作的名称及其参数。如果确认之后参数被换成另一种形式、补上默认值或被重新组装,那么同意所针对的已是另一项操作。

因此,按已验证参数来校验条件确认并不是表面修补。它恢复了确认的本意:进入决策的应当是随后交给工具的那个同一对象。这是任何有人参与循环的系统的通用规则。

0.22.3 版本改变了什么

除确认之外,2026 年 9 月 17 日的版本还列出:在由服务器管理的会话恢复时传递“未找到工具”的结果;在 Windows 主机上以 POSIX 格式保留命令路径;会话存储的正确并发启动;把 shell 调用与文件修改纳入工具使用统计;在流提前关闭时终止子进程。

每一条看起来都很细小,但它们都指向同一件事:运行时对已发生情况的描述,在中断前后必须一致。

恢复不应悄无声息

中断之后状态分裂为两部分:此前已决定的内容,以及当前可用的内容。如果恢复时工具已不可用,这一差异就必须被说出来。默不作声地继续,会产生一份把操作记为已执行、而实际并未执行的报告。

这是长时流程出错的常见原因。这里的可观察性不是日志的体量,而是描述与事实的一致。关于子进程的那一条属于同一类:已结束的会话不应当留下仍在运行的进程。

会演变成故障的细节

把 shell 调用与文件修改计入统计,对限制很重要:如果这些动作不进入报告,用量上限就是按不完整的数据计算的。不同系统之间的路径差异会影响隔离:同一条记录可能指向不同的目录。

实际结论很简单:不能依据核算与进程生命周期都只是近似的运行环境来设定上限、检验隔离。描述必须先变精确,然后才能以它为依据。

示例

参数被改动后的操作确认

任务
在一个假想流程中,代理提议修改一条记录。人确认了这次调用,但应用随后用默认值补齐了参数。
工具的作用
确认按最终交给工具的同一组参数进行校验。如果校验之后这组参数发生改变,就重新请求确认。
预期结果
预期结果是人的同意针对实际执行的操作,参数上的出入不会被漏掉。
要检查什么
如果在参数规范化之前校验确认,形式上有了校验,实质上却没有决定。示例仅作说明。

确认只有在针对操作真正据以执行的参数时才有意义。

来源及原因

发售日期:

主要来源描述了该仪器及其开发。关于选择的结论 - 实验室的编辑分析。 一个例子解释了该工具的用途;没有对其进行任何测量。 来源日期已验证为 2026 年 9 月 8 日。

关于主题的问题

在参数校验之前确认有什么危险?

人同意的是这一次调用,执行的却是另一次。形式上完成了确认,实质上没有。

为什么恢复时的明确拒绝很重要?

否则报告会把操作描述为已执行,而当时工具并不可用。

为什么要把 shell 调用计入报告?

否则用量上限与工作评估都建立在数据不完整的基础之上。