使用 AI SDK 指定任意模型

开箱即用时，Agents SDK 可通过 Responses API 或 Chat Completions API 使用 OpenAI 模型。若您想使用其他模型，Vercel 的 AI SDK 提供了多种受支持的模型，可通过此适配器接入 Agents SDK。

设置

通过安装扩展包来安装 AI SDK 适配器：
Terminal window
```
npm install @openai/agents-extensions
```
从 Vercel 的 AI SDK 选择所需的模型包并安装：
Terminal window
```
npm install @ai-sdk/openai
```

导入适配器和模型以连接到您的智能体：

import { openai } from '@ai-sdk/openai';
import { aisdk } from '@openai/agents-extensions';

初始化一个供智能体使用的模型实例：
```
const model = aisdk(openai('gpt-5-mini'));
```

示例

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

// Import the model package you installed
import { openai } from '@ai-sdk/openai';

// Import the adapter
import { aisdk } from '@openai/agents-extensions';

// Create a model instance to be used by the agent
const model = aisdk(openai('gpt-5-mini'));

// Create an agent with the model
const agent = new Agent({
  name: 'My Agent',
  instructions: 'You are a helpful assistant.',
  model,
});

// Run the agent with the new model
run(agent, 'What is the capital of Germany?');

传递提供方元数据

如果您需要随消息发送提供方特定的选项，请通过 providerMetadata 传递。其值会直接转发给底层的 AI SDK 模型。例如，以下在 Agents SDK 中的 providerData

providerData: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}

在使用 AI SDK 集成时会变为

providerMetadata: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}

AI SDK UI 流式辅助函数

@openai/agents-extensions/ai-sdk-ui 提供用于将 Agents SDK 流接入 AI SDK UI 路由的响应辅助函数：

createAiSdkTextStreamResponse(source, options?)：用于纯文本流式响应。
createAiSdkUiMessageStreamResponse(source, options?)：用于 UIMessageChunk 的流式响应。

两个辅助函数都接受一个 StreamedRunResult、类流来源或兼容的包装对象，并返回带有适合流式传输的响应头的 Response。

端到端用法请参见本仓库中的 examples/ai-sdk-ui 应用。