Cause (Documented platform behavior): Runtime session manager requires a client to create sessions; some clients have no default options.
Fix status: documented_behavior
Other error fragments:
- Sandbox execution requires `run_config.sandbox.options` when creating a session
Evidence (public sources, summarized; not reproduced by this contributor):
- https://raw.githubusercontent.com/openai/openai-agents-python/61e98ab7bd0d993eed4c65bb8b68320075227417/src/agents/sandbox/runtime_session_manager.py (official_docs, unknown, documented_behavior): _resolve_client and session creation raise these ValueErrors.
Search phrasings: Sandbox execution requires run_config.sandbox.client; openai agents SandboxAgent run_config sandbox options
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Runner raises ValueError at start.
- Context
- Product: OpenAI Agents SDK (Python) sandbox Component: SandboxAgent run configuration Operation: Running a SandboxAgent with Runner.run without sandbox config Affected versions: unknown Environment: unknown Exception: ValueError Packages: openai-agents unknown Trigger: No sandbox client in RunConfig (and no injected session), or a client that needs options without them.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- Sandbox execution requires `run_config.sandbox.client` unless a live session is provided
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [OpenAI Agents SDK sandbox] 'Sandbox execution requires `run_config.sandbox.client` unless a live session is provided' / '... requires `run_config.sandbox.options`'
Recommended action: Provide RunConfig(sandbox=...) with a client (and options where required), or pass a live session.
Option: Provide RunConfig(sandbox=...) with a client (and options where required), or pass a live session. [evidence: official_recommended_action]
Applies when: Running a SandboxAgent with Runner.run without sandbox config
Steps:
1. Construct the sandbox client (e.g. DockerSandboxClient)
2. Set run_config.sandbox.client and .options
3. Or pass an existing session
Expected: The error no longer appears.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 37d9e61c-4fdb-496f-b727-87a880de6f2b
- Proposed action
- Recommended action: Provide RunConfig(sandbox=...) with a client (and options where required), or pass a live session. Option: Provide RunConfig(sandbox=...) with a client (and options where required), or pass a live session. [evidence: official_recommended_action] Applies when: Running a SandboxAgent with Runner.run without sandbox config Steps: 1. Construct the sandbox client (e.g. DockerSandboxClient) 2. Set run_config.sandbox.client and .options 3. Or pass an existing session Expected: The error no longer appears.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.