此版本新增对 OpenAI Responses API 的 WebSocket 模式支持。这是一个新的可选功能，默认行为保持不变。如需将所有 Responses API 调用切换为 WebSocket 模式，请调用 setOpenAIResponsesTransport('websocket') 为所有 OpenAI Responses 模型代理启用。

也可以使用 withResponsesWebSocketSession 启用可复用的 WebSocket 连接：

import { Agent, withResponsesWebSocketSession } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
  model: 'gpt-5.2-codex',
});
await withResponsesWebSocketSession(async ({ run }) => {
  const streamed = await run(agent, 'Say hello in one sentence.', {
    stream: true,
  });
  for await (const _event of streamed.toStream()) {
    // Drain the stream.
  }
  console.log(streamed.finalOutput);
});

变更内容

功能：添加 responses websocket 传输和 websocket 会话辅助函数

v0.4.15

发布时间：2026-02-20

变更内容

修复(agents-core)：函数工具调用时尊重 tracingDisabled 设置

v0.4.14

发布时间：2026-02-20

变更内容

修复(agents-core)：在恢复时保留嵌套代理工具批准的归属信息

v0.4.13

发布时间：2026-02-19

关键变更

reasoningItemIdPolicy: 为推理模型添加 omit 选项

为缓解使用推理模型时因项目集不一致导致的 400 错误，此版本为 Runner 选项和 run 工具函数引入 reasoningItemIdPolicy: 'omit' 选项。这是一个新的可选选项，默认行为保持不变。

const result = await run(
  agent,
  'What is the weather in San Francisco?',
  { reasoningItemIdPolicy: 'omit' },
);

变更内容

修复(agents-core)：恢复时重新激活 RunState 中断项目
修复(agents-core)：在恢复时持久化推理项目 ID 策略并澄清过滤器交互
修复(agents-core)：在非流式运行中解析回合前等待并行输入护栏完成

v0.4.12

发布时间：2026-02-18

变更内容

功能：将运行上下文传递到 applyPatch 编辑器操作
修复：防止重新连接后重复实时会话事件
修复：在实时 agent_end 事件中保留工具前助手转录
修复：为 AI SDK 提供商规范化 data URL 图片
修复：避免 Bun 浏览器启动崩溃（当 shim 模块暂时未解析时）
修复：在 Chat Completions 追踪和输出项目中使用流式块 ID
修复：将输出护栏上下文类型传播到 OutputGuardrailFunctionArgs
修复：在工具生命周期更新后尊重 toolChoice none 覆盖
修复：将响应消息内容元数据规范化到 providerData

v0.4.11

发布时间：2026-02-17

变更内容

修复：将 realtime turnDetection modelVersion 规范化为 model_version
修复：为 shell、apply_patch 和 computer 工具发出追踪函数 span

文档与其他变更

文档：添加函数工具超时说明
构建：将 OpenAI 包组从 linked 版本控制切换为 fixed 版本控制

v0.4.10

发布时间：2026-02-14

变更内容

功能(core,realtime)：添加函数工具超时支持

v0.4.9

发布时间：2026-02-13

变更内容

修复(tracing)：避免在 OpenAI 追踪导出器中使用内部 dist 类型导入
修复(tracing)：将追踪元数据传播到处理器 span

v0.4.8

发布时间：2026-02-13

变更内容

修复(tracing)：通过 usage.details 保留生成使用元数据
修复(agents-realtime)：在解析 connect() 前等待 session.updated 确认

import { Agent } from '@openai/agents';

const agent = new Agent({
  name: 'Container Shell Agent',
  model: 'gpt-5.2',
  instructions: 'Use the available container to answer user requests.',
  tools: [
    shellTool({
      environment: {
        type: 'container_auto',
        skills: [{type: 'skill_reference', skillId: "skill_xxx", version: "1"}],
      },
    }),
  ],
});