@@ -4,25 +4,29 @@ search:
44---
55# 設定
66
7- このページでは、デフォルトの OpenAI キーやクライアント 、デフォルトの OpenAI API 形式、トレーシングのエクスポート既定値、ロギングの動作など、通常はアプリケーション起動時に一度だけ設定する SDK 全体のデフォルトについて説明します 。
7+ このページでは、通常はアプリケーション起動時に一度だけ設定する SDK 全体のデフォルト値( デフォルトの OpenAI キーまたはクライアント 、デフォルトの OpenAI API 形式、トレーシングエクスポートのデフォルト値、ロギング動作など)について説明します 。
88
9- 代わりに特定のエージェントや実行を設定する必要がある場合は、次から始めてください 。
9+ これらのデフォルト値は sandbox ベースのワークフローにも適用されますが、sandbox ワークスペース、sandbox クライアント、セッション再利用は個別に設定します 。
1010
11- - ` RunConfig ` 、セッション、会話状態オプションについては [ エージェントの実行] ( running_agents.md ) 。
12- - モデル選択とプロバイダー設定については [ モデル] ( models/index.md ) 。
13- - 実行ごとのトレーシングメタデータとカスタムトレースプロセッサーについては [ トレーシング] ( tracing.md ) 。
11+ 代わりに特定のエージェントまたは実行を設定する必要がある場合は、次から始めてください。
12+
13+ - 通常の ` Agent ` における instructions、tools、出力型、ハンドオフ、ガードレールは [ Agents] ( agents.md ) を参照してください。
14+ - ` RunConfig ` 、セッション、会話状態オプションは [ Running agents] ( running_agents.md ) を参照してください。
15+ - ` SandboxRunConfig ` 、マニフェスト、機能、sandbox クライアント固有のワークスペース設定は [ Sandbox agents] ( sandbox/guide.md ) を参照してください。
16+ - モデル選択とプロバイダー設定は [ Models] ( models/index.md ) を参照してください。
17+ - 実行ごとのトレーシングメタデータとカスタムトレースプロセッサーは [ Tracing] ( tracing.md ) を参照してください。
1418
1519## API キーとクライアント
1620
17- デフォルトでは、 SDK は LLM リクエストとトレーシングに ` OPENAI_API_KEY ` 環境変数を使用します。このキーは SDK が最初に OpenAI クライアントを作成したときに解決されるため (遅延初期化)、最初のモデル呼び出しの前に環境変数を設定してください 。アプリ起動前にその環境変数を設定できない場合は、キーを設定するために [ set_default_openai_key()] [ agents.set_default_openai_key ] 関数を使用できます。
21+ デフォルトでは、SDK は LLM リクエストとトレーシングに ` OPENAI_API_KEY ` 環境変数を使用します。キーは SDK が最初に OpenAI クライアントを作成するとき (遅延初期化)に解決されるため、最初のモデル呼び出し前に環境変数を設定してください 。アプリ起動前にその環境変数を設定できない場合は、キーを設定するために [ set_default_openai_key()] [ agents.set_default_openai_key ] 関数を使用できます。
1822
1923``` python
2024from agents import set_default_openai_key
2125
2226set_default_openai_key(" sk-..." )
2327```
2428
25- 別の方法として 、使用する OpenAI クライアントを設定することもできます。デフォルトでは、 SDK は ` AsyncOpenAI ` インスタンスを作成し、環境変数の API キーまたは上で設定したデフォルトキーを使用します 。これは [ set_default_openai_client()] [ agents.set_default_openai_client ] 関数で変更できます。
29+ また 、使用する OpenAI クライアントを設定することもできます。デフォルトでは、SDK は環境変数の API キーまたは上記で設定したデフォルトキーを使用して ` AsyncOpenAI ` インスタンスを作成します 。これは [ set_default_openai_client()] [ agents.set_default_openai_client ] 関数で変更できます。
2630
2731``` python
2832from openai import AsyncOpenAI
@@ -32,7 +36,7 @@ custom_client = AsyncOpenAI(base_url="...", api_key="...")
3236set_default_openai_client(custom_client)
3337```
3438
35- 最後に、使用する OpenAI API をカスタマイズすることもできます。デフォルトでは OpenAI Responses API を使用します。[ set_default_openai_api()] [ agents.set_default_openai_api ] 関数を使用すると、これを上書きして Chat Completions API を使用できます 。
39+ 最後に、使用する OpenAI API をカスタマイズすることもできます。デフォルトでは OpenAI Responses API を使用します。これは [ set_default_openai_api()] [ agents.set_default_openai_api ] 関数を使って Chat Completions API を使用するように上書きできます 。
3640
3741``` python
3842from agents import set_default_openai_api
@@ -42,15 +46,15 @@ set_default_openai_api("chat_completions")
4246
4347## トレーシング
4448
45- トレーシングはデフォルトで有効です。デフォルトでは、上記セクションのモデルリクエストと同じ OpenAI API キー(つまり環境変数または設定したデフォルトキー )を使用します。トレーシングで使用する API キーは 、[ ` set_tracing_export_api_key ` ] [ agents.set_tracing_export_api_key ] 関数で個別に設定できます 。
49+ トレーシングはデフォルトで有効です。デフォルトでは、上記セクションのモデルリクエストと同じ OpenAI API キー(つまり、環境変数または設定したデフォルトキー )を使用します。トレーシングに使用する API キーを明示的に設定するには 、[ ` set_tracing_export_api_key ` ] [ agents.set_tracing_export_api_key ] 関数を使用します 。
4650
4751``` python
4852from agents import set_tracing_export_api_key
4953
5054set_tracing_export_api_key(" sk-..." )
5155```
5256
53- デフォルトのエクスポーター使用時にトレースを特定の organization や project に紐付ける必要がある場合は 、アプリ起動前に次の環境変数を設定してください。
57+ デフォルトエクスポーター使用時に、特定の組織またはプロジェクトにトレースを紐付ける必要がある場合は 、アプリ起動前に次の環境変数を設定してください。
5458
5559``` bash
5660export OPENAI_ORG_ID=" org_..."
@@ -77,7 +81,7 @@ from agents import set_tracing_disabled
7781set_tracing_disabled(True )
7882```
7983
80- トレーシングは有効のままにしつつ、機密性の高い可能性がある入出力をトレースペイロードから除外したい場合は 、[ ` RunConfig.trace_include_sensitive_data ` ] [ agents.run.RunConfig.trace_include_sensitive_data ] を ` False ` に設定してください 。
84+ トレーシングは有効のままにしつつ、機密性がある可能性のある入力/出力をトレースペイロードから除外したい場合は 、[ ` RunConfig.trace_include_sensitive_data ` ] [ agents.run.RunConfig.trace_include_sensitive_data ] を ` False ` に設定します 。
8185
8286``` python
8387from agents import Runner, RunConfig
@@ -89,27 +93,27 @@ await Runner.run(
8993)
9094```
9195
92- アプリ起動前にこの環境変数を設定すれば、コードを書かずにデフォルトを変更することもできます 。
96+ コードを書かずにデフォルトを変更するには、アプリ起動前にこの環境変数を設定することもできます 。
9397
9498``` bash
9599export OPENAI_AGENTS_TRACE_INCLUDE_SENSITIVE_DATA=0
96100```
97101
98- トレーシング制御の詳細は、 [ トレーシングガイド ] ( tracing.md ) を参照してください。
102+ トレーシング制御の全体については、 [ tracing guide ] ( tracing.md ) を参照してください。
99103
100104## デバッグロギング
101105
102106SDK は 2 つの Python ロガー(` openai.agents ` と ` openai.agents.tracing ` )を定義しており、デフォルトではハンドラーをアタッチしません。ログはアプリケーションの Python ロギング設定に従います。
103107
104- 詳細なロギングを有効にするには 、[ ` enable_verbose_stdout_logging() ` ] [ agents.enable_verbose_stdout_logging ] 関数を使用します。
108+ 詳細ログを有効にするには 、[ ` enable_verbose_stdout_logging() ` ] [ agents.enable_verbose_stdout_logging ] 関数を使用します。
105109
106110``` python
107111from agents import enable_verbose_stdout_logging
108112
109113enable_verbose_stdout_logging()
110114```
111115
112- または、ハンドラー、フィルター、フォーマッターなどを追加してログをカスタマイズすることもできます。詳しくは [ Python logging guide] ( https://docs.python.org/3/howto/logging.html ) を参照してください。
116+ または、ハンドラー、フィルター、フォーマッターなどを追加してログをカスタマイズすることもできます。詳細は [ Python logging guide] ( https://docs.python.org/3/howto/logging.html ) を参照してください。
113117
114118``` python
115119import logging
@@ -130,9 +134,9 @@ logger.addHandler(logging.StreamHandler())
130134
131135### ログ内の機密データ
132136
133- 一部のログには機密データ(たとえばユーザーデータ)が含まれる可能性があります 。
137+ 一部のログには機密データ(たとえば、ユーザーデータ)が含まれる場合があります 。
134138
135- デフォルトでは、 SDK は LLM の入出力やツールの入出力を ** ログに記録しません ** 。これらの保護は次によって制御されます 。
139+ デフォルトでは、SDK は LLM の入力/出力やツールの入力/出力を ** 記録しません ** 。これらの保護は次で制御されます 。
136140
137141``` bash
138142OPENAI_AGENTS_DONT_LOG_MODEL_DATA=1
0 commit comments