Skip to content

docs: update translated document pages#2891

Merged
seratch merged 1 commit into
mainfrom
update-translated-docs-24467413335
Apr 15, 2026
Merged

docs: update translated document pages#2891
seratch merged 1 commit into
mainfrom
update-translated-docs-24467413335

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Automated update of translated documentation.

Triggered by commit: 2d665c9a67fdf3198a0daa0f9978b8239d78e78b.
Message: `Sandbox Agents (#2889)

Sandbox Agents

This release adds Sandbox Agents, a beta SDK surface for running
agents with a persistent, isolated workspace. Sandbox agents keep the
normal Agent and Runner flow, but add workspace manifests,
sandbox-native capabilities, sandbox clients, snapshots, and resume
support so agents can work over real files, run commands, edit
repositories, generate artifacts, and continue work across runs.

Key pieces:

  • SandboxAgent: an Agent with sandbox defaults such as
    default_manifest, sandbox instructions, capabilities, and run_as.
  • Manifest: a fresh-workspace contract for files, directories, local
    files, local directories, Git repos, environment, users, groups, and
    mounts.
  • SandboxRunConfig: per-run sandbox wiring for client creation, live
    session injection, serialized session resume, manifest overrides,
    snapshots, and materialization concurrency limits.
  • Built-in capabilities for shell access, filesystem editing and image
    inspection, skills, memory, and compaction.
  • Workspace snapshots and serialized sandbox session state for
    reconnecting to existing work or seeding a fresh sandbox from saved
    contents.

Sandbox clients and hosted providers

Sandbox agents now support local, containerized, and hosted execution
backends:

  • UnixLocalSandboxClient for fast local development.
  • DockerSandboxClient for container isolation and image parity.
  • Hosted sandbox clients for Blaxel, Cloudflare, Daytona, E2B, Modal,
    Runloop, and Vercel through optional extras.

The release also adds provider-specific examples and mount strategies
for common storage backends, including S3, Cloudflare R2, Google Cloud
Storage, Azure Blob Storage, and S3 Files where supported by the
selected backend.

Sandbox memory

Adds a sandbox memory capability that lets future sandbox-agent runs
learn from prior runs. Memory stores extracted lessons in the sandbox
workspace, injects a concise summary into later runs, and uses
progressive disclosure so agents can search deeper rollout summaries
only when useful.

Memory supports:

  • Read-only or generate-only modes.
  • Live updates when the agent discovers stale memory.
  • Multi-turn grouping through conversation_id, SDK Session,
    RunConfig.group_id, or generated run IDs.
  • Separate memory layouts for isolating memory across agents or
    workflows.
  • S3-backed examples for persisted memory across runs.

Workspace mounts, snapshots, and resume

This release adds a full workspace entry and mount model for sandbox
sessions:

  • Local files and directories.
  • Synthetic files and directories.
  • Git repository entries.
  • Remote storage mounts for S3, R2, GCS, Azure Blob Storage, and S3
    Files.
  • Provider-specific mount strategies across Docker, Modal, Cloudflare,
    Blaxel, Daytona, E2B, and Runloop.
  • Portable snapshots with path normalization, symlink preservation,
    mount-safe snapshotting, and remote snapshot support.
  • Resume paths through runner-managed RunState, explicit
    SandboxSessionState, or saved snapshots.

Examples and tutorials

Adds a large examples/sandbox/ suite covering:

  • Local Unix and Docker sandbox runners.
  • Docker mount smoke tests for S3, GCS, Azure Blob Storage, and S3
    Files.
  • Sandbox coding tasks with skills.
  • Sandbox agents as tools and handoff patterns.
  • Memory examples, including multi-agent/multi-turn memory and S3-backed
    memory.
  • Tax-prep and healthcare-support workflows.
  • Dataroom QA and metric extraction tutorials.
  • Repository code review tutorial.
  • Vision website clone tutorial.
  • Provider examples for Blaxel, Cloudflare, Daytona, E2B, Modal,
    Runloop, Temporal, and Vercel.

Runtime, tracing, and model plumbing

The release includes the runtime plumbing needed to make sandbox agents
work naturally inside the existing SDK:

  • Runner-managed sandbox preparation, capability binding, session
    lifecycle, state serialization, and resume behavior.
  • Sandbox-aware RunState serialization.
  • Unified sandbox tracing with SDK spans.
  • Token usage on tracing spans.
  • Runner-managed prompt cache key defaults.
  • OpenAI agent registration and harness ID configuration.
  • Safer redaction of sensitive MCP tool outputs when sensitive tracing
    is disabled.
  • Additional OpenAI client/model utilities and Chat Completions
    coverage.

Documentation & Other Changes

  • docs: add Asqav to external tracing processors list.
  • docs: update translated document pages.

Co-authored-by: Abdulrahman Alfozan alfozan@openai.com
Co-authored-by: Aditya Singh 60082699+adityasingh2400@users.noreply.github.com
Co-authored-by: Andi Liu andi@openai.com
Co-authored-by: Aron 263346377+aron-cf@users.noreply.github.com
Co-authored-by: ashwinnathan-openai ashwinnathan@openai.com
Co-authored-by: Codex noreply@openai.com
Co-authored-by: cploujoux cploujoux@blaxel.ai
Co-authored-by: elainegan-openai 168589666+elainegan-openai@users.noreply.github.com
Co-authored-by: Elias Freider freider@users.noreply.github.com
Co-authored-by: Erik Dunteman erik@erikds-macbook-air.local
Co-authored-by: Jason Liu jasonliu@openai.com
Co-authored-by: Jason Steving 32336750+jasonsteving99@users.noreply.github.com
Co-authored-by: Kazuhiro Sera seratch@openai.com
Co-authored-by: Lovre Pešut lovre.pesut@gmail.com
Co-authored-by: Lucas Wang lucas_wang@lucas-futures.com
Co-authored-by: Matt Brockman matt.brockman@e2b.dev
Co-authored-by: Mish Ushakov mishushakov@users.noreply.github.com
Co-authored-by: Naresh ghostwriternr@gmail.com
Co-authored-by: nicholasclark-openai nicholasclark@openai.com
Co-authored-by: qiyaoq-oai qiyaoq@openai.com
Co-authored-by: Scott Trinh scott@scotttrinh.com
Co-authored-by: tode-rl tony@runloop.ai
Co-authored-by: Wendy Jiao wendyjiao@openai.com`

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1a9b887f3

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread docs/ja/sandbox/guide.md

<div class="sandbox-harness-image" markdown="1">

![Sandbox agent harness with compute](../assets/images/harness_with_compute.png)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the correct assets path in localized sandbox guides

The image link uses ../assets/images/harness_with_compute.png, which resolves to /ja/assets/... from this page and returns 404 because the image actually lives under /assets/images/...; this makes the hero diagram disappear in localized docs. The same relative path was introduced in docs/ko/sandbox/guide.md and docs/zh/sandbox/guide.md, so all three translated sandbox guides are affected.

Useful? React with 👍 / 👎.

@seratch seratch added the documentation Improvements or additions to documentation label Apr 15, 2026
@seratch seratch merged commit e336667 into main Apr 15, 2026
@seratch seratch deleted the update-translated-docs-24467413335 branch April 15, 2026 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant