コンテンツにスキップ

モデル

最終的にすべての エージェント は LLM を呼び出します。SDK はモデルを次の 2 つの軽量インターフェースの背後に抽象化します:

  • Model – 特定 API への 1 回 のリクエスト方法を知っています
  • ModelProvider – 人間が読みやすいモデル (例: 'gpt-4o') を Model インスタンスへ解決します

日常的にはモデル と、時折 ModelSettings のみを扱います。

エージェントごとにモデルを指定
import { Agent } from '@openai/agents';
const agent = new Agent({
name: 'Creative writer',
model: 'gpt-4.1',
});

デフォルトの ModelProvider は OpenAI API を使って名前を解決します。2 つの異なるエンドポイントをサポートしています:

API使用用途setOpenAIAPI() の呼び出し
Chat Completions標準的なチャット & 関数呼び出しsetOpenAIAPI('chat_completions')
Responsesストリーミングを第一とした新しい生成 API (ツール呼び出し、柔軟な出力)setOpenAIAPI('responses') (デフォルト)
デフォルト OpenAI キーを設定
import { setDefaultOpenAIKey } from '@openai/agents';
setDefaultOpenAIKey(process.env.OPENAI_API_KEY!); // sk-...

カスタムのネットワーク設定が必要な場合は、setDefaultOpenAIClient(client) で独自の OpenAI クライアントを差し込むこともできます。

OpenAI プロバイダーのデフォルトは gpt-4o です。エージェント単位またはグローバルに上書きできます:

デフォルトモデルを設定
import { Runner } from '@openai/agents';
const runner = new Runner({ model: 'gpt‑4.1-mini' });

ModelSettings は OpenAI のパラメーターを反映しつつ、プロバイダー非依存です。

フィールドメモ
temperaturenumber創造性と決定論のバランス
topPnumberニュークリアスサンプリング
frequencyPenaltynumber繰り返しトークンのペナルティ
presencePenaltynumber新しいトークンを促進
toolChoice'auto' | 'required' | 'none' | stringツールの使用を強制する
parallelToolCallsboolean対応している場合に並列関数呼び出しを許可
truncation'auto' | 'disabled'トークン切り詰め戦略
maxTokensnumber応答内の最大トークン数
storeboolean応答を永続化し、取得 / RAG ワークフローで利用

設定はどちらのレベルにも添付できます:

モデル設定
import { Runner, Agent } from '@openai/agents';
const agent = new Agent({
name: 'Creative writer',
// ...
modelSettings: { temperature: 0.7, toolChoice: 'auto' },
});
// or globally
new Runner({ modelSettings: { temperature: 0.3 } });

Runner レベルの設定は、競合するエージェント単位の設定を上書きします。


独自プロバイダーの実装は簡単です。ModelProviderModel を実装し、Runner コンストラクターに渡します:

最小限のカスタムプロバイダー
import {
ModelProvider,
Model,
ModelRequest,
AgentOutputType,
ModelResponse,
ResponseStreamEvent,
TextOutput,
} from '@openai/agents-core';
import { Agent, Runner } from '@openai/agents';
class EchoModel implements Model {
name: string;
constructor() {
this.name = 'Echo';
}
async getResponse(request: ModelRequest): Promise<ModelResponse> {
return {
usage: {},
output: [{ role: 'assistant', content: request.input as string }],
} as any;
}
async *getStreamedResponse(
_request: ModelRequest,
): AsyncIterable<ResponseStreamEvent> {
yield {
type: 'response.completed',
response: { output: [], usage: {} },
} as any;
}
}
class EchoProvider implements ModelProvider {
getModel(_modelName?: string): Promise<Model> | Model {
return new EchoModel();
}
}
const runner = new Runner({ modelProvider: new EchoProvider() });
console.log(runner.config.modelProvider.getModel());
const agent = new Agent({
name: 'Test Agent',
instructions: 'You are a helpful assistant.',
model: new EchoModel(),
modelSettings: { temperature: 0.7, toolChoice: 'auto' },
});
console.log(agent.model);

OpenAI プロバイダー使用時に API キーを渡せば、自動トレースエクスポートをオプトインできます:

トレーシングエクスポーター
import { setTracingExportApiKey } from '@openai/agents';
setTracingExportApiKey('sk-...');

これによりトレースが OpenAI ダッシュボード へ送信され、ワークフローの完全な実行グラフを確認できます。