Skip to content

Commit e336667

Browse files
docs: update translated document pages (#2891)
1 parent a7ccef4 commit e336667

27 files changed

+3924
-709
lines changed

docs/ja/agents.md

Lines changed: 71 additions & 66 deletions
Large diffs are not rendered by default.

docs/ja/config.md

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

2226
set_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
2832
from openai import AsyncOpenAI
@@ -32,7 +36,7 @@ custom_client = AsyncOpenAI(base_url="...", api_key="...")
3236
set_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
3842
from 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
4852
from agents import set_tracing_export_api_key
4953

5054
set_tracing_export_api_key("sk-...")
5155
```
5256

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

5559
```bash
5660
export OPENAI_ORG_ID="org_..."
@@ -77,7 +81,7 @@ from agents import set_tracing_disabled
7781
set_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
8387
from agents import Runner, RunConfig
@@ -89,27 +93,27 @@ await Runner.run(
8993
)
9094
```
9195

92-
アプリ起動前にこの環境変数を設定すれば、コードを書かずにデフォルトを変更することもできます
96+
コードを書かずにデフォルトを変更するには、アプリ起動前にこの環境変数を設定することもできます
9397

9498
```bash
9599
export OPENAI_AGENTS_TRACE_INCLUDE_SENSITIVE_DATA=0
96100
```
97101

98-
トレーシング制御の詳細は、[トレーシングガイド](tracing.md) を参照してください。
102+
トレーシング制御の全体については、[tracing guide](tracing.md) を参照してください。
99103

100104
## デバッグロギング
101105

102106
SDK は 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
107111
from agents import enable_verbose_stdout_logging
108112

109113
enable_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
115119
import logging
@@ -130,9 +134,9 @@ logger.addHandler(logging.StreamHandler())
130134

131135
### ログ内の機密データ
132136

133-
一部のログには機密データ(たとえばユーザーデータ)が含まれる可能性があります
137+
一部のログには機密データ(たとえば、ユーザーデータ)が含まれる場合があります
134138

135-
デフォルトでは、 SDK は LLM の入出力やツールの入出力を **ログに記録しません** 。これらの保護は次によって制御されます
139+
デフォルトでは、SDK は LLM の入力/出力やツールの入力/出力を **記録しません**。これらの保護は次で制御されます
136140

137141
```bash
138142
OPENAI_AGENTS_DONT_LOG_MODEL_DATA=1

0 commit comments

Comments
 (0)