OpenAI Agents APIは、サンドボックス内でのコード実行、ツール呼び出し、サブタスクの委任が可能な高耐久でステートフルなAIエージェントを展開するためのマネージドCodexハーネスを提供します。
製品の機能と公式な位置づけ
OpenAI Agents APIは、マネージドサービスとしてCodexハーネスへのプログラムによるアクセスをアプリケーションに提供します。開発者がモデル、指示、ツールを設定する一方で、セッションの永続化、実行のオーケストレーション、ターンの復旧、自動コンテキスト圧縮を処理します。
エージェントはOpenAIが管理するサンドボックスまたはセルフホスト環境のいずれかで動作し、コードの実行、ファイルの編集、成果物の作成を行います。ワークフローはリアルタイムの誘導、Model Context Protocolサーバーを介した外部データ接続、専門サブエージェントへの並行委任をサポートします。
公式情報で確認できる活用例
インフラストラクチャのアラートを調査し、インシデントデータを評価して、修復タスクを実行する前に確認を求めます。
サンドボックス環境で再現スクリプトを実行して報告されたソフトウェアのバグを調査し、結果をGitHub上で共有します。
読み取り専用SQLを使用してデータウェアハウスにクエリを実行し、運用データを分析してビジネス上の質問に回答します。
提出された文書を正式なポリシー基準に照らして評価するため、個別のチェックを専門のサブエージェントに委任します。
公式情報に記載された利用手順
OpenAIが実行環境をプロビジョニングする間に、エージェントのモデル、指示、ツールを構成します。
構成された環境が準備できたら、ユーザー入力を送信して作業ターンを開始します。
実行出力をストリーミングするかWebhookを受信して進捗を追跡し、エージェントが入力を必要としているか、または完了したかを検知します。
アクティブなターン中にエージェントを誘導するか、既存の永続セッションに対して追加のタスクを送信します。
Agents APIは、複雑な実行ロジックをクライアントアプリケーションから抽象化するマネージドCodexハーネスを中心としています。プラットフォームは複数ターンにわたって永続的なセッションを維持するため、リクエストごとに過去の会話履歴を再送信する必要がありません。モデルのコンテキスト制限内に収めるため、ハーネスは過去のターンを要約して自動的にコンテキストを圧縮します。
実行は設定された環境内で行われ、OpenAIホストのサンドボックスとセルフホスト環境の両方をサポートします。これらの環境内で、エージェントはローカルファイルシステムへのアクセス、機能ディレクトリからのカスタムスキルのロード、シェルコマンドの実行、Model Context Protocolサーバーとの対話、生成された成果物の出力を行うことができます。
自分の素材とワークフローで確認したい項目
確認した情報源とその日時
情報源を確認した製品情報に基づく回答
エージェントは、OpenAIによって管理されるOpenAIホストのサンドボックス内、またはローカルの機能ディレクトリを設定したセルフホスト環境内で実行できます。
Agents APIではZero Data Retentionはサポートされておらず、セルフホストのサンドボックスを選択した場合でもZDRの適用対象にはなりません。
Agents APIにおけるデータレジデンシーは、現時点では米国内のみに限定されて排他的にサポートされています。
マネージドCodexハーネスが自動コンテキスト圧縮を提供し、過去の作業内容を要約することで、アクティブなコンテキストウィンドウをモデルの制限内に維持します。
はい。APIはマルチエージェント実行をサポートしており、エージェントが複雑な作業を分割して並行して動作するサブエージェントに委任することが可能です。
