@@ -4,41 +4,41 @@ search:
44---
55# OpenAI Agents SDK
66
7- [ OpenAI Agents SDK] ( https://github.com/openai/openai-agents-python ) は、非常に少ない抽象化で軽量かつ使いやすいパッケージとして、エージェント型 AI アプリを構築できるようにします。これは、エージェント向けの以前の実験的プロジェクトである [ Swarm] ( https://github.com/openai/swarm/tree/main ) を本番対応にアップグレードしたものです 。Agents SDK には、ごく少数の基本コンポーネントがあります 。
7+ [ OpenAI Agents SDK] ( https://github.com/openai/openai-agents-python ) は、非常に少ない抽象化で、軽量かつ使いやすいパッケージとしてエージェント型 AI アプリを構築できるようにします。これは、以前のエージェント向け実験である [ Swarm] ( https://github.com/openai/swarm/tree/main ) を本番対応向けにアップグレードしたものです 。Agents SDK には、非常に小さな基本コンポーネントのセットがあります 。
88
99- ** エージェント** : instructions と tools を備えた LLM
10- - ** Agents as tools / ハンドオフ** : エージェントが特定のタスクをほかのエージェントに委任できる仕組み
11- - ** ガードレール** : エージェントの入力と出力を検証できる仕組み
10+ - ** Agents as tools / ハンドオフ** : エージェントが特定タスクのために他のエージェントへ委任できるようにします
11+ - ** ガードレール** : エージェントの入力と出力の検証を可能にします
1212
13- これらの基本コンポーネントは Python と組み合わせることで、ツールとエージェント間の複雑な関係を表現でき、急な学習コストなしで実運用アプリケーションを構築できます 。さらに SDK には組み込みの ** トレーシング** があり、エージェントフローの可視化やデバッグ、評価、さらにはアプリケーション向けのモデルのファインチューニングまで行えます 。
13+ これらの基本コンポーネントは Python と組み合わせることで、ツールとエージェント間の複雑な関係を表現できるほど強力であり、急な学習コストなしに実運用アプリケーションを構築できます 。さらに SDK には、エージェント型フローを可視化・デバッグできる組み込みの ** トレーシング** があり、評価の実行や、アプリケーション向けモデルのファインチューニングまで可能です 。
1414
1515## Agents SDK を使う理由
1616
17- SDK には 2 つの主要な設計原則があります 。
17+ SDK には 2 つの中核となる設計原則があります 。
1818
19- 1 . 使う価値があるだけの機能を備えつつ、素早く学べるよう基本コンポーネントは少なく保つこと 。
20- 2 . そのままですぐに使えて、かつ挙動を細かくカスタマイズできること 。
19+ 1 . 使う価値があるだけの十分な機能を持ちつつ、素早く学べるよう基本コンポーネントは少数にすること 。
20+ 2 . そのままですぐに優れた動作をしつつ、何が起きるかを正確にカスタマイズできること 。
2121
2222以下が SDK の主な機能です。
2323
24- - ** エージェントループ** : ツール呼び出しを処理し、結果を LLM に返し、タスク完了まで継続する組み込みループ 。
25- - ** Python ファースト** : 新しい抽象化を学ぶ代わりに、言語組み込み機能でエージェントのオーケストレーションや連携を実現 。
26- - ** Agents as tools / ハンドオフ** : 複数のエージェント間で作業を調整・委任するための強力な仕組み 。
27- - ** ガードレール** : 入力検証と安全性チェックをエージェント実行と並列で実行し、チェックに失敗した場合は早期に停止 。
28- - ** 関数ツール** : 任意の Python 関数を、スキーマ自動生成と Pydantic ベースの検証付きツールに変換 。
29- - ** MCP サーバーツール呼び出し** : 関数ツールと同様に動作する、組み込みの MCP サーバーツール連携 。
30- - ** セッション** : エージェントループ内で作業コンテキストを維持するための永続メモリレイヤー 。
31- - ** Human in the loop** : エージェント実行全体に人間を関与させるための組み込みメカニズム 。
32- - ** トレーシング** : ワークフローの可視化・デバッグ・監視のための組み込みトレーシング。 OpenAI の評価・ファインチューニング・蒸留ツール群をサポート 。
33- - ** Realtime Agents** : 自動割り込み検知、コンテキスト管理、ガードレールなどの機能を備えた強力な音声エージェントを構築 。
24+ - ** エージェントループ** : ツール呼び出しを処理し、結果を LLM に返し、タスク完了まで継続する組み込みのエージェントループです 。
25+ - ** Python ファースト** : 新しい抽象化を学ぶ必要なく、組み込みの言語機能を使ってエージェントをオーケストレーションし、連結できます 。
26+ - ** Agents as tools / ハンドオフ** : 複数エージェント間で作業を調整・委任するための強力な仕組みです 。
27+ - ** ガードレール** : エージェント実行と並行して入力検証と安全性チェックを実行し、チェック不合格時には即座に失敗させます 。
28+ - ** 関数ツール** : 自動スキーマ生成と Pydantic による検証で、任意の Python 関数をツール化できます 。
29+ - ** MCP サーバーツール呼び出し** : 関数ツールと同様に動作する、組み込みの MCP サーバーツール統合です 。
30+ - ** セッション** : エージェントループ内で作業コンテキストを維持するための永続メモリレイヤーです 。
31+ - ** Human in the loop** : エージェント実行全体で人間を関与させるための組み込みメカニズムです 。
32+ - ** トレーシング** : ワークフローの可視化・デバッグ・監視のための組み込みトレーシングで、 OpenAI の評価・ファインチューニング・蒸留ツール群をサポートします 。
33+ - ** Realtime Agents** : ` gpt-realtime-1.5 ` 、 自動割り込み検知、コンテキスト管理、ガードレールなどにより、強力な音声エージェントを構築できます 。
3434
3535## インストール
3636
3737``` bash
3838pip install openai-agents
3939```
4040
41- ## Hello World 例
41+ ## Hello world 例
4242
4343``` python
4444from agents import Agent, Runner
@@ -53,29 +53,29 @@ print(result.final_output)
5353# Infinite loop's dance.
5454```
5555
56- (これを実行する場合は 、` OPENAI_API_KEY ` 環境変数を設定してください )
56+ (_ これを実行する場合は 、` OPENAI_API_KEY ` 環境変数を設定してください _ )
5757
5858``` bash
5959export OPENAI_API_KEY=sk-...
6060```
6161
6262## 開始地点
6363
64- - [ Quickstart] ( quickstart.md ) で最初のテキストベースのエージェントを構築します 。
65- - 次に、 [ Running agents] ( running_agents.md#choose-a-memory-strategy ) でターン間の状態保持方法を決めます 。
66- - handoffs とマネージャー型オーケストレーションのどちらにするか検討している場合は 、[ Agent orchestration] ( multi_agent.md ) を参照してください。
64+ - [ Quickstart] ( quickstart.md ) で最初のテキストベースエージェントを構築します 。
65+ - 次に [ Running agents] ( running_agents.md#choose-a-memory-strategy ) で、ターン間で状態をどのように保持するかを決めます 。
66+ - handoffs と manager スタイルのオーケストレーションのどちらにするか検討している場合は 、[ Agent orchestration] ( multi_agent.md ) を参照してください。
6767
6868## パスの選択
6969
70- やりたいことは分かっているが、どのページに説明があるか分からない場合はこの表を使ってください 。
70+ やりたい作業は分かっているが、どのページに説明があるか分からない場合は、この表を使ってください 。
7171
7272| 目標 | 開始地点 |
7373| --- | --- |
74- | 最初のテキストエージェントを作成し 、1 回の完全な実行を確認する | [ Quickstart] ( quickstart.md ) |
75- | 関数ツール、ホストツール 、または agents as tools を追加する | [ Tools] ( tools.md ) |
76- | handoffs とマネージャー型オーケストレーションのどちらにするか決める | [ Agent orchestration] ( multi_agent.md ) |
74+ | 最初のテキストエージェントを構築し 、1 回の完全な実行を確認する | [ Quickstart] ( quickstart.md ) |
75+ | 関数ツール、ホスト型ツール 、または Agents as tools を追加する | [ Tools] ( tools.md ) |
76+ | handoffs と manager スタイルのオーケストレーションのどちらにするか決める | [ Agent orchestration] ( multi_agent.md ) |
7777| ターン間でメモリを保持する | [ Running agents] ( running_agents.md#choose-a-memory-strategy ) と [ Sessions] ( sessions/index.md ) |
78- | OpenAI モデル、websocket トランスポート、または非 OpenAI プロバイダーを使用する | [ Models] ( models/index.md ) |
79- | 出力、実行項目、割り込み 、再開状態を確認する | [ Results] ( results.md ) |
80- | 低遅延の音声エージェントを構築する | [ Realtime agents quickstart] ( realtime/quickstart.md ) と [ Realtime transport] ( realtime/transport.md ) |
78+ | OpenAI モデル、websocket トランスポート、または非 OpenAI プロバイダーを使う | [ Models] ( models/index.md ) |
79+ | 出力、実行項目、中断 、再開状態を確認する | [ Results] ( results.md ) |
80+ | ` gpt-realtime-1.5 ` で低レイテンシの音声エージェントを構築する | [ Realtime agents quickstart] ( realtime/quickstart.md ) と [ Realtime transport] ( realtime/transport.md ) |
8181| speech-to-text / agent / text-to-speech パイプラインを構築する | [ Voice pipeline quickstart] ( voice/quickstart.md ) |
0 commit comments