Skip to content

Commit 638388a

Browse files
docs: update translated document pages (#2999)
1 parent 734d424 commit 638388a

6 files changed

Lines changed: 610 additions & 592 deletions

File tree

docs/ja/sandbox/guide.md

Lines changed: 180 additions & 176 deletions
Large diffs are not rendered by default.

docs/ja/sandbox_agents.md

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -6,35 +6,35 @@ search:
66

77
!!! warning "ベータ機能"
88

9-
Sandbox Agents はベータ版です。一般提供までの間に API の詳細、デフォルト値、対応機能は変更される可能性があり、また時間の経過とともにより高度な機能が追加される予定です
9+
Sandbox Agents はベータ版です。一般提供までに API の詳細、デフォルト設定、対応機能は変更される可能性があり、また時間とともにより高度な機能が追加される予定です
1010

11-
現代的なエージェントは、ファイルシステム内の実際のファイルを操作できるときに最も効果的に動作します。Agents SDK の **Sandbox Agents** は、モデルに永続的なワークスペースを提供し、そこでは大規模なドキュメント群の検索、ファイル編集、コマンド実行、成果物の生成、保存された sandbox 状態からの作業再開が可能です
11+
モダンなエージェントは、ファイルシステム内の実際のファイルを操作できるときに最も効果を発揮します。Agents SDK の **Sandbox Agents** は、モデルに永続的なワークスペースを提供し、そこで大規模なドキュメント集合を検索し、ファイルを編集し、コマンドを実行し、成果物を生成し、保存された sandbox state から作業を再開できます
1212

13-
SDK は、ファイルのステージング、ファイルシステムツール、シェルアクセス、sandbox のライフサイクル、スナップショット、プロバイダー固有の接続処理を自分で組み合わせることなく、その実行ハーネスを提供します。通常の `Agent``Runner` のフローはそのまま維持しつつ、ワークスペース用の `Manifest`sandbox ネイティブツール用の capabilities 、そして作業の実行場所を指定する `SandboxRunConfig` を追加できます
13+
SDK は、ファイルのステージング、ファイルシステムツール、シェルアクセス、sandbox のライフサイクル、スナップショット、プロバイダー固有の接続処理を自分で組み合わせることなく、その実行ハーネスを提供します。通常の `Agent``Runner` のフローはそのままに、ワークスペース用の `Manifest`sandbox ネイティブツール用の capabilities、作業の実行場所を指定する `SandboxRunConfig` を追加するだけです
1414

1515
## 前提条件
1616

1717
- Python 3.10 以上
18-
- OpenAI Agents SDK の基本的な知識
19-
- sandbox クライアント。ローカル開発では、まず `UnixLocalSandboxClient` から始めてください
18+
- OpenAI Agents SDK の基本的な理解
19+
- sandbox クライアント。ローカル開発では、まず `UnixLocalSandboxClient` を使用してください
2020

2121
## インストール
2222

23-
まだ SDK をインストールしていない場合は、次を実行してください
23+
まだ SDK をインストールしていない場合は、次を実行します
2424

2525
```bash
2626
pip install openai-agents
2727
```
2828

29-
Docker ベースの sandbox の場合:
29+
Docker ベースの sandbox の場合は、次を実行します。
3030

3131
```bash
3232
pip install "openai-agents[docker]"
3333
```
3434

3535
## ローカル sandbox エージェントの作成
3636

37-
この例では、ローカルのリポジトリを `repo/` 配下にステージングし、ローカル skills を遅延読み込みし、 runner が実行時に Unix ローカル sandbox セッションを作成できるようにします。
37+
この例では、`repo/` 配下にローカルリポジトリをステージングし、ローカル skills を遅延読み込みし、runner が実行時に Unix ローカル sandbox セッションを作成できるようにします。
3838

3939
```python
4040
import asyncio
@@ -69,6 +69,8 @@ def build_agent(model: str) -> SandboxAgent[None]:
6969
capabilities=Capabilities.default() + [
7070
Skills(
7171
lazy_from=LocalDirLazySkillSource(
72+
# This is a host path read by the SDK process.
73+
# Requested skills are copied into `skills_path` in the sandbox.
7274
source=LocalDir(src=HOST_SKILLS_DIR),
7375
)
7476
),
@@ -99,17 +101,17 @@ if __name__ == "__main__":
99101
基本的な実行が動作したら、次に多くの人が選ぶ項目は以下です。
100102

101103
- `default_manifest`: 新しい sandbox セッション用のファイル、リポジトリ、ディレクトリ、マウント
102-
- `instructions`: プロンプト全体に適用される短いワークフロールール
104+
- `instructions`: プロンプト全体にわたって適用される短いワークフロールール
103105
- `base_instructions`: SDK の sandbox プロンプトを置き換えるための高度なエスケープハッチ
104-
- `capabilities`: ファイルシステム編集 / 画像検査、シェル、 skills 、メモリ、 compaction などの sandbox ネイティブツール
105-
- `run_as`: モデル向けツールにおける sandbox ユーザー ID
106+
- `capabilities`: ファイルシステム編集 / 画像検査、シェル、skills、メモリ、コンパクションなどの sandbox ネイティブツール
107+
- `run_as`: モデル向けツールに対する sandbox ユーザー ID
106108
- `SandboxRunConfig.client`: sandbox バックエンド
107-
- `SandboxRunConfig.session``session_state` 、または `snapshot`: 後続の実行を以前の作業に再接続する方法
109+
- `SandboxRunConfig.session``session_state`、または `snapshot`: 後続の実行を以前の作業に再接続する方法
108110

109111
## 次の参照先
110112

111-
- [概念](sandbox/guide.md): manifests 、 capabilities 、 permissions 、 snapshots 、 run config 、構成パターンを理解します。
112-
- [Sandbox クライアント](sandbox/clients.md): Unix ローカル、 Docker 、ホスト型プロバイダー、マウント戦略を選びます
113-
- [エージェントメモリ](sandbox/memory.md): 以前の sandbox 実行から得た学びを保持し、再利用します。
113+
- [概念](sandbox/guide.md): manifest、capabilities、権限、スナップショット、run config、構成パターンを理解します。
114+
- [sandbox クライアント](sandbox/clients.md): Unix ローカル、Docker、ホスト型プロバイダー、マウント戦略を選択します
115+
- [エージェントメモリ](sandbox/memory.md): 以前の sandbox 実行から得た知見を保持し、再利用します。
114116

115-
シェルアクセスが時々使うツールの 1 つにすぎない場合は、[ツールガイド](tools.md) のホスト型シェルから始めてください。ワークスペースの分離、sandbox クライアントの選択、または sandbox セッションの再開動作が設計の一部である場合は、sandbox エージェントを使用してください。
117+
シェルアクセスが単発でたまに使うツールの 1 つにすぎない場合は、[tools ガイド](tools.md) の hosted shell から始めてください。ワークスペース分離、sandbox クライアントの選択、または sandbox セッションの再開動作が設計の一部である場合は、sandbox エージェントを使用してください。

0 commit comments

Comments
 (0)