Skip to content

Commit b96b0ce

Browse files
docs: update translated document pages (#2509)
1 parent 6375b97 commit b96b0ce

9 files changed

Lines changed: 539 additions & 331 deletions

File tree

docs/ja/config.md

Lines changed: 39 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -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
1212
from agents import set_default_openai_key
1313

1414
set_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
2020
from openai import AsyncOpenAI
@@ -24,7 +24,7 @@ custom_client = AsyncOpenAI(base_url="...", api_key="...")
2424
set_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
3030
from 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
4040
from agents import set_tracing_export_api_key
4141

4242
set_tracing_export_api_key("sk-...")
4343
```
4444

45-
デフォルトの exporter を使用する際に、 トレースを特定の組織またはプロジェクトに紐付ける必要がある場合は、 アプリの起動前に次の環境変数を設定してください
45+
デフォルトのエクスポーターを使用する際に、トレースを特定の organization または project に紐付ける必要がある場合は、アプリの起動前に次の環境変数を設定してください:
4646

4747
```bash
4848
export OPENAI_ORG_ID="org_..."
4949
export OPENAI_PROJECT_ID="proj_..."
5050
```
5151

52-
グローバル exporter を変更せずに、 実行ごとにトレーシング API キーを設定することもできます。
52+
グローバルなエクスポーターを変更せずに、実行ごとに トレーシング の API キーを設定することもできます。
5353

5454
```python
5555
from 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
6767
from agents import set_tracing_disabled
6868

6969
set_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
7999
from agents import enable_verbose_stdout_logging
80100

81101
enable_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
87107
import logging
@@ -100,18 +120,20 @@ logger.setLevel(logging.WARNING)
100120
logger.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

Comments
 (0)