エージェントは、ツールを使ってタスクを計画し、完了まで進めることができます。他のエージェントと連携したり、複数のステップにわたってコンテキストを維持したりすることもできます。
初めてのエージェントの実行
まずは Agents SDK クイックスタートに沿って SDK をインストールし、エージェントを 1 つ定義して実行します。動作を確認したら、このページに戻り、アプリケーションに次に追加する機能を選んでください。
Agents SDK の入手先
その他のサンプル、イシュー、各言語の詳しいリファレンスは、GitHub リポジトリを参照してください。
目的別のガイド
| 目的 | 最初に読むガイド | 選ぶ理由 |
|---|---|---|
| コードでエージェントアプリを構築する | クイックスタート | SDK を組み込み、動作を確認するまでの最短の手順を紹介します。 |
| 専門エージェントを 1 つ定義し、役割を明確にする | エージェントの定義 | 単一のエージェントに何を任せ、どのような応答を求めるかを決める段階で役立ちます。 |
| モデル、デフォルト設定、通信方式を選ぶ | モデルとプロバイダー | モデルの選択、プロバイダーの設定、通信方式がワークフローに影響する場合に参照してください。 |
| 実行ループと状態を理解する | エージェントの実行 | エージェントループ、ストリーミング、実行を継続する方法を解説します。 |
| コンテナ環境で処理を実行する | サンドボックス内のエージェント | エージェントがファイル、コマンド、パッケージ、スナップショット、マウント、プロバイダーへの接続を必要とする場合に参照してください。 |
| 専門エージェント間の役割分担を設計する | オーケストレーションとハンドオフ | 複数のエージェントが必要で、どのエージェントが応答を担当するかを決める場合に役立ちます。 |
| 検証や人によるレビューを追加する | ガードレールと人によるレビュー | リスクのある処理を続ける前に、ワークフローを停止または一時停止する必要がある場合に参照してください。 |
| 実行時の戻り値を理解する | 結果と状態 | 最終出力、実行再開に使う状態、次のターンで使えるインターフェースを解説します。 |
| ホスト型ツール、関数ツール、MCP を追加する | ツールの使用と統合とオブザーバビリティ | ツールの動作はプラットフォームのツールドキュメントで、SDK 固有の MCP の使い方とトレーシングは統合ガイドで解説します。 |
| 実行内容を調べて改善する | 統合とオブザーバビリティとエージェントワークフローの評価 | まずトレースを使ってデバッグし、その後、評価を繰り返して改善を進めます。 |
| 音声を中心としたワークフローを構築する | 音声エージェント | SDK の音声パイプラインとリアルタイムエージェントの実装パターンを利用できます。 |
SDK を使った開発
デプロイ、ツールの実装、状態の保存、承認の判断を自分のサーバー側で管理し、エージェントループの実行とツールの呼び出しを SDK に任せる場合は、SDK のガイドに沿って進めてください。この方法は、次のような要件に特に適しています。
- TypeScript または Python での型付きアプリケーションコードの記述
- ツール、MCP サーバー、実行時の動作の直接制御
- 独自のストレージの利用や、サーバー側での会話の管理
- 既存のプロダクトロジックやインフラとの緊密な統合
SDK のガイドは、通常、次の順に読み進めます。
- まずクイックスタートに沿ってエージェントを一度実行し、結果を画面で確認します。
- エージェントの定義とモデルとプロバイダーを参考に、役割を明確にした専門エージェントを 1 つ定義します。
- ワークフローが複雑になったら、エージェントの実行、オーケストレーションとハンドオフ、ガードレールと人によるレビューに進みます。
- アプリケーションのロジックで実行オブジェクトを使う場合や、実行時の動作を詳しく把握する必要がある場合は、結果と状態と統合とオブザーバビリティを参照してください。
エージェントの実行環境の比較
エージェントの概要では、Agents SDK、Agents API、Responses API を比較できます。Agents SDK はアプリケーション内で動作します。一方、Agents API は OpenAI のサービス上でマネージドハーネスを実行します。