From 348161e6e9d1bef229175972854cb56bbd3032d2 Mon Sep 17 00:00:00 2001 From: AbdulSamad94 Date: Tue, 19 May 2026 02:30:47 +0500 Subject: [PATCH 1/2] docs: add sandbox category to examples.md --- docs/examples.md | 18 ++++++++++++++++++ docs/ja/examples.md | 18 ++++++++++++++++++ docs/ko/examples.md | 18 ++++++++++++++++++ docs/zh/examples.md | 18 ++++++++++++++++++ 4 files changed, 72 insertions(+) diff --git a/docs/examples.md b/docs/examples.md index 9fda81c382..c23014e847 100644 --- a/docs/examples.md +++ b/docs/examples.md @@ -116,6 +116,24 @@ Check out a variety of sample implementations of the SDK in the examples section - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** Simple deep research clone that demonstrates complex multi-agent research workflows. +- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** + Examples showing how to run agents with an isolated workspace (see [Sandbox agents quickstart](sandbox_agents.md)), including: + + - Basic sandbox session from a manifest (`examples/sandbox/basic.py`) + - Handoffs with sandbox-backed agents (`examples/sandbox/handoffs.py`) + - Configuring a sandbox agent with workspace capabilities (`examples/sandbox/sandbox_agent_capabilities.py`) + - Combining sandbox capabilities with host-defined tools (`examples/sandbox/sandbox_agent_with_tools.py`) + - Exposing sandbox agents as tools for another agent (`examples/sandbox/sandbox_agents_as_tools.py`) + - Starting from a remote sandbox snapshot (`examples/sandbox/sandbox_agent_with_remote_snapshot.py`) + - Agent memory across sandbox runs (`examples/sandbox/memory.py`) + - Multi-agent multi-turn memory in a shared workspace (`examples/sandbox/memory_multi_agent_multiturn.py`) + - S3-backed memory with Docker sandboxes (`examples/sandbox/memory_s3.py`) + - Interactive pseudo-terminal in a Unix-local sandbox (`examples/sandbox/unix_local_pty.py`) + - Running against the Unix-local sandbox backend directly (`examples/sandbox/unix_local_runner.py`) + - Cloud backend extensions (E2B, Modal, Daytona, Blaxel, Cloudflare, Vercel, Runloop) in `examples/sandbox/extensions/` + - Healthcare support workflow with policy agent, memory, and human approvals (`examples/sandbox/healthcare_support/`) + - Tutorials: `sandbox_resume`, `dataroom_qa`, `dataroom_metric_extract`, `repo_code_review`, `vision_website_clone` + - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** Learn how to implement OAI hosted tools and experimental Codex tooling such as: diff --git a/docs/ja/examples.md b/docs/ja/examples.md index 30353d9b72..ef723c7709 100644 --- a/docs/ja/examples.md +++ b/docs/ja/examples.md @@ -120,6 +120,24 @@ SDK のさまざまなサンプル実装は、[リポジトリ](https://github.c - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 複雑なマルチエージェントリサーチワークフローを示す、シンプルなディープリサーチのクローンです。 +- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** + 分離されたワークスペースでエージェントを実行する方法を示すコード例です（[Sandbox エージェントのクイックスタート](sandbox_agents.md)を参照）。以下を含みます: + + - マニフェストからの基本的な sandbox セッション (`examples/sandbox/basic.py`) + - sandbox バックエンドエージェントを使用したハンドオフ (`examples/sandbox/handoffs.py`) + - ワークスペース capabilities を持つ sandbox エージェントの設定 (`examples/sandbox/sandbox_agent_capabilities.py`) + - sandbox capabilities とホスト定義ツールの組み合わせ (`examples/sandbox/sandbox_agent_with_tools.py`) + - 別のエージェントのツールとして sandbox エージェントを公開 (`examples/sandbox/sandbox_agents_as_tools.py`) + - リモート sandbox スナップショットからの起動 (`examples/sandbox/sandbox_agent_with_remote_snapshot.py`) + - sandbox 実行をまたいだエージェントメモリ (`examples/sandbox/memory.py`) + - 共有ワークスペースでのマルチエージェント・マルチターンメモリ (`examples/sandbox/memory_multi_agent_multiturn.py`) + - Docker sandbox での S3 バックエンドメモリ (`examples/sandbox/memory_s3.py`) + - Unix ローカル sandbox での仮想端末 (`examples/sandbox/unix_local_pty.py`) + - Unix ローカル sandbox バックエンドへの直接実行 (`examples/sandbox/unix_local_runner.py`) + - クラウドバックエンド拡張 (E2B、Modal、Daytona、Blaxel、Cloudflare、Vercel、Runloop) (`examples/sandbox/extensions/`) + - ポリシーエージェント・メモリ・人間承認を含むヘルスケアサポートワークフロー (`examples/sandbox/healthcare_support/`) + - チュートリアル: `sandbox_resume`、`dataroom_qa`、`dataroom_metric_extract`、`repo_code_review`、`vision_website_clone` + - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** OpenAI がホストするツールや、次のような実験的な Codex ツール群の実装方法を学びます: diff --git a/docs/ko/examples.md b/docs/ko/examples.md index 7807e02a61..d78f5edd1e 100644 --- a/docs/ko/examples.md +++ b/docs/ko/examples.md @@ -120,6 +120,24 @@ SDK의 다양한 샘플 구현은 [리포지토리](https://github.com/openai/op - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 복잡한 다중 에이전트 연구 워크플로를 보여 주는 간단한 딥 리서치 클론입니다. +- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** + 격리된 워크스페이스에서 에이전트를 실행하는 방법을 보여 주는 예제입니다([Sandbox 에이전트 빠른 시작](sandbox_agents.md) 참조). 포함 항목: + + - 매니페스트를 이용한 기본 sandbox 세션 (`examples/sandbox/basic.py`) + - sandbox 기반 에이전트를 사용하는 핸드오프 (`examples/sandbox/handoffs.py`) + - 워크스페이스 capabilities를 갖는 sandbox 에이전트 구성 (`examples/sandbox/sandbox_agent_capabilities.py`) + - sandbox capabilities와 호스트 정의 도구 결합 (`examples/sandbox/sandbox_agent_with_tools.py`) + - 다른 에이전트의 도구로서 sandbox 에이전트 노출 (`examples/sandbox/sandbox_agents_as_tools.py`) + - 원격 sandbox 스냅샷으로부터 시작 (`examples/sandbox/sandbox_agent_with_remote_snapshot.py`) + - sandbox 실행 간 에이전트 메모리 (`examples/sandbox/memory.py`) + - 공유 워크스페이스에서의 다중 에이전트 멀티턴 메모리 (`examples/sandbox/memory_multi_agent_multiturn.py`) + - Docker sandbox에서 S3 기반 메모리 (`examples/sandbox/memory_s3.py`) + - Unix 로컬 sandbox에서의 대화형 가상 터미널 (`examples/sandbox/unix_local_pty.py`) + - Unix 로컬 sandbox 백엔드에 직접 실행 (`examples/sandbox/unix_local_runner.py`) + - 클라우드 백엔드 확장 (E2B, Modal, Daytona, Blaxel, Cloudflare, Vercel, Runloop) (`examples/sandbox/extensions/`) + - 정책 에이전트, 메모리, 인간 승인을 포함한 의료 지원 워크플로 (`examples/sandbox/healthcare_support/`) + - 튜토리얼: `sandbox_resume`, `dataroom_qa`, `dataroom_metric_extract`, `repo_code_review`, `vision_website_clone` + - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** 다음과 같은 OpenAI 호스트하는 도구와 실험적 Codex 도구 기능을 구현하는 방법을 알아봅니다: diff --git a/docs/zh/examples.md b/docs/zh/examples.md index e5e2ccc806..706c525347 100644 --- a/docs/zh/examples.md +++ b/docs/zh/examples.md @@ -120,6 +120,24 @@ search: - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 一个简单的深度研究克隆，展示复杂的多智能体研究工作流。 +- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** + 展示如何在隔离工作区中运行智能体的示例（参见[沙盒智能体快速入门](sandbox_agents.md)），包括： + + - 从清单创建基本沙盒会话（`examples/sandbox/basic.py`） + - 使用沙盒后端智能体进行任务转移（`examples/sandbox/handoffs.py`） + - 配置具备工作区能力的沙盒智能体（`examples/sandbox/sandbox_agent_capabilities.py`） + - 将沙盒能力与主机定义工具结合（`examples/sandbox/sandbox_agent_with_tools.py`） + - 将沙盒智能体作为另一个智能体的工具公开（`examples/sandbox/sandbox_agents_as_tools.py`） + - 从远程沙盒快照启动（`examples/sandbox/sandbox_agent_with_remote_snapshot.py`） + - 跨沙盒运行的智能体记忆（`examples/sandbox/memory.py`） + - 共享工作区中的多智能体多轮记忆（`examples/sandbox/memory_multi_agent_multiturn.py`） + - Docker 沙盒中基于 S3 的记忆存储（`examples/sandbox/memory_s3.py`） + - Unix 本地沙盒中的交互式伪终端（`examples/sandbox/unix_local_pty.py`） + - 直接使用 Unix 本地沙盒后端运行（`examples/sandbox/unix_local_runner.py`） + - 云后端扩展（E2B、Modal、Daytona、Blaxel、Cloudflare、Vercel、Runloop）位于 `examples/sandbox/extensions/` + - 包含策略智能体、记忆和人工审批的医疗支持工作流（`examples/sandbox/healthcare_support/`） + - 教程：`sandbox_resume`、`dataroom_qa`、`dataroom_metric_extract`、`repo_code_review`、`vision_website_clone` + - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** 了解如何实现由OpenAI托管的工具以及实验性 Codex 工具，例如： From 7756697e49aa9e355b973c3d657f1afd82d14102 Mon Sep 17 00:00:00 2001 From: AbdulSamad94 Date: Tue, 19 May 2026 12:21:46 +0500 Subject: [PATCH 2/2] docs: revert manual edits to generated translation files --- docs/ja/examples.md | 18 ------------------ docs/ko/examples.md | 18 ------------------ docs/zh/examples.md | 18 ------------------ 3 files changed, 54 deletions(-) diff --git a/docs/ja/examples.md b/docs/ja/examples.md index ef723c7709..30353d9b72 100644 --- a/docs/ja/examples.md +++ b/docs/ja/examples.md @@ -120,24 +120,6 @@ SDK のさまざまなサンプル実装は、[リポジトリ](https://github.c - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 複雑なマルチエージェントリサーチワークフローを示す、シンプルなディープリサーチのクローンです。 -- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** - 分離されたワークスペースでエージェントを実行する方法を示すコード例です（[Sandbox エージェントのクイックスタート](sandbox_agents.md)を参照）。以下を含みます: - - - マニフェストからの基本的な sandbox セッション (`examples/sandbox/basic.py`) - - sandbox バックエンドエージェントを使用したハンドオフ (`examples/sandbox/handoffs.py`) - - ワークスペース capabilities を持つ sandbox エージェントの設定 (`examples/sandbox/sandbox_agent_capabilities.py`) - - sandbox capabilities とホスト定義ツールの組み合わせ (`examples/sandbox/sandbox_agent_with_tools.py`) - - 別のエージェントのツールとして sandbox エージェントを公開 (`examples/sandbox/sandbox_agents_as_tools.py`) - - リモート sandbox スナップショットからの起動 (`examples/sandbox/sandbox_agent_with_remote_snapshot.py`) - - sandbox 実行をまたいだエージェントメモリ (`examples/sandbox/memory.py`) - - 共有ワークスペースでのマルチエージェント・マルチターンメモリ (`examples/sandbox/memory_multi_agent_multiturn.py`) - - Docker sandbox での S3 バックエンドメモリ (`examples/sandbox/memory_s3.py`) - - Unix ローカル sandbox での仮想端末 (`examples/sandbox/unix_local_pty.py`) - - Unix ローカル sandbox バックエンドへの直接実行 (`examples/sandbox/unix_local_runner.py`) - - クラウドバックエンド拡張 (E2B、Modal、Daytona、Blaxel、Cloudflare、Vercel、Runloop) (`examples/sandbox/extensions/`) - - ポリシーエージェント・メモリ・人間承認を含むヘルスケアサポートワークフロー (`examples/sandbox/healthcare_support/`) - - チュートリアル: `sandbox_resume`、`dataroom_qa`、`dataroom_metric_extract`、`repo_code_review`、`vision_website_clone` - - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** OpenAI がホストするツールや、次のような実験的な Codex ツール群の実装方法を学びます: diff --git a/docs/ko/examples.md b/docs/ko/examples.md index d78f5edd1e..7807e02a61 100644 --- a/docs/ko/examples.md +++ b/docs/ko/examples.md @@ -120,24 +120,6 @@ SDK의 다양한 샘플 구현은 [리포지토리](https://github.com/openai/op - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 복잡한 다중 에이전트 연구 워크플로를 보여 주는 간단한 딥 리서치 클론입니다. -- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** - 격리된 워크스페이스에서 에이전트를 실행하는 방법을 보여 주는 예제입니다([Sandbox 에이전트 빠른 시작](sandbox_agents.md) 참조). 포함 항목: - - - 매니페스트를 이용한 기본 sandbox 세션 (`examples/sandbox/basic.py`) - - sandbox 기반 에이전트를 사용하는 핸드오프 (`examples/sandbox/handoffs.py`) - - 워크스페이스 capabilities를 갖는 sandbox 에이전트 구성 (`examples/sandbox/sandbox_agent_capabilities.py`) - - sandbox capabilities와 호스트 정의 도구 결합 (`examples/sandbox/sandbox_agent_with_tools.py`) - - 다른 에이전트의 도구로서 sandbox 에이전트 노출 (`examples/sandbox/sandbox_agents_as_tools.py`) - - 원격 sandbox 스냅샷으로부터 시작 (`examples/sandbox/sandbox_agent_with_remote_snapshot.py`) - - sandbox 실행 간 에이전트 메모리 (`examples/sandbox/memory.py`) - - 공유 워크스페이스에서의 다중 에이전트 멀티턴 메모리 (`examples/sandbox/memory_multi_agent_multiturn.py`) - - Docker sandbox에서 S3 기반 메모리 (`examples/sandbox/memory_s3.py`) - - Unix 로컬 sandbox에서의 대화형 가상 터미널 (`examples/sandbox/unix_local_pty.py`) - - Unix 로컬 sandbox 백엔드에 직접 실행 (`examples/sandbox/unix_local_runner.py`) - - 클라우드 백엔드 확장 (E2B, Modal, Daytona, Blaxel, Cloudflare, Vercel, Runloop) (`examples/sandbox/extensions/`) - - 정책 에이전트, 메모리, 인간 승인을 포함한 의료 지원 워크플로 (`examples/sandbox/healthcare_support/`) - - 튜토리얼: `sandbox_resume`, `dataroom_qa`, `dataroom_metric_extract`, `repo_code_review`, `vision_website_clone` - - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** 다음과 같은 OpenAI 호스트하는 도구와 실험적 Codex 도구 기능을 구현하는 방법을 알아봅니다: diff --git a/docs/zh/examples.md b/docs/zh/examples.md index 706c525347..e5e2ccc806 100644 --- a/docs/zh/examples.md +++ b/docs/zh/examples.md @@ -120,24 +120,6 @@ search: - **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):** 一个简单的深度研究克隆，展示复杂的多智能体研究工作流。 -- **[sandbox](https://github.com/openai/openai-agents-python/tree/main/examples/sandbox):** - 展示如何在隔离工作区中运行智能体的示例（参见[沙盒智能体快速入门](sandbox_agents.md)），包括： - - - 从清单创建基本沙盒会话（`examples/sandbox/basic.py`） - - 使用沙盒后端智能体进行任务转移（`examples/sandbox/handoffs.py`） - - 配置具备工作区能力的沙盒智能体（`examples/sandbox/sandbox_agent_capabilities.py`） - - 将沙盒能力与主机定义工具结合（`examples/sandbox/sandbox_agent_with_tools.py`） - - 将沙盒智能体作为另一个智能体的工具公开（`examples/sandbox/sandbox_agents_as_tools.py`） - - 从远程沙盒快照启动（`examples/sandbox/sandbox_agent_with_remote_snapshot.py`） - - 跨沙盒运行的智能体记忆（`examples/sandbox/memory.py`） - - 共享工作区中的多智能体多轮记忆（`examples/sandbox/memory_multi_agent_multiturn.py`） - - Docker 沙盒中基于 S3 的记忆存储（`examples/sandbox/memory_s3.py`） - - Unix 本地沙盒中的交互式伪终端（`examples/sandbox/unix_local_pty.py`） - - 直接使用 Unix 本地沙盒后端运行（`examples/sandbox/unix_local_runner.py`） - - 云后端扩展（E2B、Modal、Daytona、Blaxel、Cloudflare、Vercel、Runloop）位于 `examples/sandbox/extensions/` - - 包含策略智能体、记忆和人工审批的医疗支持工作流（`examples/sandbox/healthcare_support/`） - - 教程：`sandbox_resume`、`dataroom_qa`、`dataroom_metric_extract`、`repo_code_review`、`vision_website_clone` - - **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):** 了解如何实现由OpenAI托管的工具以及实验性 Codex 工具，例如：