@@ -6,15 +6,15 @@ search:
66
77## API キーとクライアント
88
9- デフォルトでは、 SDK はインポートされるとすぐに、 LLM リクエストとトレーシングのために ` OPENAI_API_KEY ` 環境変数を探します。 アプリの起動前にその環境変数を設定できない場合は、 [ set_default_openai_key()] [ agents.set_default_openai_key ] 関数を使用してキーを設定できます 。
9+ デフォルトでは、SDK は LLM リクエストと トレーシング に ` OPENAI_API_KEY ` 環境変数を使用します。このキーは、SDK が最初に OpenAI クライアントを作成するとき(遅延初期化)に解決されるため、最初の モデル 呼び出しの前に環境変数を設定してください。アプリの起動前にその環境変数を設定できない場合は、 [ set_default_openai_key()] [ agents.set_default_openai_key ] 関数を使ってキーを設定できます 。
1010
1111``` python
1212from agents import set_default_openai_key
1313
1414set_default_openai_key(" sk-..." )
1515```
1616
17- また、 使用する OpenAI クライアントを設定することもできます。 デフォルトでは、 SDK は環境変数の API キー、 または上で設定したデフォルトキーを使用して ` AsyncOpenAI ` インスタンスを作成します。 これは、 [ set_default_openai_client()] [ agents.set_default_openai_client ] 関数を使用して変更できます 。
17+ 代わりに、 使用する OpenAI クライアントを設定することもできます。デフォルトでは、SDK は ` AsyncOpenAI ` インスタンスを作成し、環境変数の API キー、または上で設定したデフォルトキーを使用します。これは [ set_default_openai_client()] [ agents.set_default_openai_client ] 関数で変更できます 。
1818
1919``` python
2020from openai import AsyncOpenAI
@@ -24,7 +24,7 @@ custom_client = AsyncOpenAI(base_url="...", api_key="...")
2424set_default_openai_client(custom_client)
2525```
2626
27- 最後に、 使用する OpenAI API もカスタマイズできます。 デフォルトでは、 OpenAI Responses API を使用します。 [ set_default_openai_api()] [ agents.set_default_openai_api ] 関数を使用して、 これを上書きし Chat Completions API を使用できます 。
27+ 最後に、使用する OpenAI API もカスタマイズできます。デフォルトでは OpenAI Responses API を使用します。[ set_default_openai_api()] [ agents.set_default_openai_api ] 関数を使うことで、 Chat Completions API を使用するように上書きできます 。
2828
2929``` python
3030from agents import set_default_openai_api
@@ -34,22 +34,22 @@ set_default_openai_api("chat_completions")
3434
3535## トレーシング
3636
37- トレーシングはデフォルトで有効です。 デフォルトでは上記セクションの OpenAI API キー(つまり、 環境変数または設定したデフォルトキー)を使用します。 トレーシングに使用する API キーを明示的に設定するには、 [ ` set_tracing_export_api_key ` ] [ agents.set_tracing_export_api_key ] 関数を使用します。
37+ トレーシング はデフォルトで有効です。デフォルトでは、上のセクションの OpenAI API キー(つまり、環境変数または設定したデフォルトキー)を使用します。トレーシング に使用する API キーを明示的に設定するには、[ ` set_tracing_export_api_key ` ] [ agents.set_tracing_export_api_key ] 関数を使用します。
3838
3939``` python
4040from agents import set_tracing_export_api_key
4141
4242set_tracing_export_api_key(" sk-..." )
4343```
4444
45- デフォルトの exporter を使用する際に、 トレースを特定の組織またはプロジェクトに紐付ける必要がある場合は、 アプリの起動前に次の環境変数を設定してください。
45+ デフォルトのエクスポーターを使用する際に、トレースを特定の organization または project に紐付ける必要がある場合は、 アプリの起動前に次の環境変数を設定してください:
4646
4747``` bash
4848export OPENAI_ORG_ID=" org_..."
4949export OPENAI_PROJECT_ID=" proj_..."
5050```
5151
52- グローバル exporter を変更せずに、 実行ごとにトレーシング API キーを設定することもできます。
52+ グローバルなエクスポーターを変更せずに、実行ごとに トレーシング の API キーを設定することもできます。
5353
5454``` python
5555from agents import Runner, RunConfig
@@ -61,27 +61,47 @@ await Runner.run(
6161)
6262```
6363
64- [ ` set_tracing_disabled() ` ] [ agents.set_tracing_disabled ] 関数を使用して、 トレーシングを完全に無効化することもできます 。
64+ [ ` set_tracing_disabled() ` ] [ agents.set_tracing_disabled ] 関数を使用すると、トレーシング を完全に無効化することもできます 。
6565
6666``` python
6767from agents import set_tracing_disabled
6868
6969set_tracing_disabled(True )
7070```
7171
72- ## デバッグログ
72+ トレーシング は有効のままにしつつ、トレースのペイロードから機密性の高い可能性がある入力 / 出力を除外したい場合は、 [ ` RunConfig.trace_include_sensitive_data ` ] [ agents.run.RunConfig.trace_include_sensitive_data ] を ` False ` に設定します:
7373
74- SDK は 2 つの Python ロガー(` openai.agents ` と ` openai.agents.tracing ` )を定義しており、 デフォルトではハンドラーをアタッチしません。 ログは、 アプリケーションの Python logging 設定に従います。
74+ ``` python
75+ from agents import Runner, RunConfig
76+
77+ await Runner.run(
78+ agent,
79+ input = " Hello" ,
80+ run_config = RunConfig(trace_include_sensitive_data = False ),
81+ )
82+ ```
83+
84+ コードなしでデフォルトを変更するには、アプリの起動前にこの環境変数を設定することもできます:
85+
86+ ``` bash
87+ export OPENAI_AGENTS_TRACE_INCLUDE_SENSITIVE_DATA=0
88+ ```
89+
90+ トレーシング の制御の全体像については、[ トレーシング ガイド] ( tracing.md ) を参照してください。
91+
92+ ## デバッグ ロギング
93+
94+ SDK は 2 つの Python ロガー(` openai.agents ` と ` openai.agents.tracing ` )を定義しており、デフォルトではハンドラーをアタッチしません。ログは、アプリケーションの Python ロギング設定に従います。
7595
76- 詳細なログを有効にするには、 [ ` enable_verbose_stdout_logging() ` ] [ agents.enable_verbose_stdout_logging ] 関数を使用します。
96+ 詳細ログを有効にするには、 [ ` enable_verbose_stdout_logging() ` ] [ agents.enable_verbose_stdout_logging ] 関数を使用します。
7797
7898``` python
7999from agents import enable_verbose_stdout_logging
80100
81101enable_verbose_stdout_logging()
82102```
83103
84- または、 ハンドラー、 フィルター、 フォーマッターなどを追加してログをカスタマイズできます。 詳細は、 [ Python logging guide] ( https://docs.python.org/3/howto/logging.html ) を参照してください。
104+ または、ハンドラー、フィルター、フォーマッターなどを追加してログをカスタマイズできます。詳しくは [ Python logging guide] ( https://docs.python.org/3/howto/logging.html ) を参照してください。
85105
86106``` python
87107import logging
@@ -100,18 +120,20 @@ logger.setLevel(logging.WARNING)
100120logger.addHandler(logging.StreamHandler())
101121```
102122
103- ### ログ内の機微情報
123+ ### ログ内の機密データ
104124
105- 一部のログには機微情報 (例: ユーザーデータ )が含まれる場合があります。 こうしたデータがログに記録されないようにするには、 次の環境変数を設定してください 。
125+ 一部のログには機密データ (例: ユーザー データ )が含まれる場合があります。
106126
107- LLM の入力と出力のログ記録を無効化するには :
127+ デフォルトでは、SDK は LLM の入力 / 出力やツールの入力 / 出力をログに ** 記録しません ** 。これらの保護は次で制御されます :
108128
109129``` bash
110- export OPENAI_AGENTS_DONT_LOG_MODEL_DATA=1
130+ OPENAI_AGENTS_DONT_LOG_MODEL_DATA=1
131+ OPENAI_AGENTS_DONT_LOG_TOOL_DATA=1
111132```
112133
113- ツールの入力と出力のログ記録を無効化するには :
134+ デバッグのために一時的にこのデータを含める必要がある場合は、アプリの起動前にいずれかの変数を ` 0 ` (または ` false ` )に設定してください :
114135
115136``` bash
116- export OPENAI_AGENTS_DONT_LOG_TOOL_DATA=1
137+ export OPENAI_AGENTS_DONT_LOG_MODEL_DATA=0
138+ export OPENAI_AGENTS_DONT_LOG_TOOL_DATA=0
117139```
0 commit comments