๐Ÿค– April 2026 Release

The Next Evolution of the
Agents SDK

OpenAI upgrades its open-source Agents SDK with enterprise-grade sandboxing, a long-horizon harness, subagents, code mode, and support for 100+ LLMs.

Sandboxing โœฆ New Long-Horizon Harness โœฆ New Subagents โŸถ Coming Soon Code Mode โŸถ Coming Soon 100+ LLMs Python ยท TypeScript
What Changed

Agents SDK โ€” Production-Ready, Enterprise-Safe

๐Ÿ”—

OpenAI's Agents SDK โ€” the production successor to the experimental Swarm project โ€” receives its most significant update yet. New capabilities address the two hardest enterprise concerns: safety during autonomous operation, and support for complex multi-step work.

๐Ÿ”’
Agents run inside isolated workspaces, accessing only designated files and code. System integrity is preserved even during fully autonomous operation.
๐Ÿ”ญ
Orchestration scaffolding for complex, multi-step tasks. Developers bring their own infrastructure; the harness provides persistent state and coordination.
๐ŸŒ
Works with any model exposing a Chat Completions-compatible endpoint โ€” enabling 100+ non-OpenAI LLMs alongside OpenAI models.
New Capabilities

What's New in the April 2026 Update

๐Ÿ”—

Two capabilities ship now in Python; two more are on the roadmap for both Python and TypeScript.

๐Ÿ—๏ธ
Sandboxing Python ยท Now
Places agents in controlled computer environments where they are siloed within a designated workspace. Only permitted files and code are accessible. Solves the core enterprise risk of agents running unsupervised with broad system access.
๐Ÿ”—
Long-Horizon Harness Python ยท Now
Provides the infrastructure to build long-horizon agents โ€” complex, multi-step tasks requiring persistent state. Developers bring their own compute and storage; the harness handles coordination. TypeScript support follows.
๐Ÿค–
Subagents Coming Soon
An orchestrator spawns specialised subordinate subagents for modular, parallelisable task decomposition. Coming to both Python and TypeScript.
๐Ÿ’ป
Code Mode Coming Soon
Extends agents with specialised code execution and generation abilities. Coming to both Python and TypeScript, enabling SDK-native developer agents.
Foundation

The Four Core SDK Primitives

๐Ÿ”—

Every Agents SDK workflow is built from four composable building blocks.

A
LLM-powered workers configured with instructions (system prompt) and tools. The primary unit of work in any Agents SDK workflow.
H
Agent-to-agent task delegation. Supports full handoffs and 'Agents as Tools' patterns where agents are called like functions.
G
Input and output validation. Lightweight checks that enforce safety policies, content rules, and formatting requirements across the workflow.
T
Built-in observability: automatic recording of the full execution graph for visualisation, debugging, and monitoring. Integrates with OpenAI's eval and fine-tuning tools.
API Landscape

The Responses API is the Future

๐Ÿ”—

Three APIs matter for agent development. The Responses API unifies the best of the others and is the recommended foundation going forward. The Assistants API is being deprecated in mid-2026.

Responses API Recommended
Combines Chat Completions language capability with Assistants tool-use. The recommended foundation for all new agent development. Future-proofed and actively developed.
OpenAI's established conversational API. Still fully supported for backwards compatibility and for provider-agnostic use with third-party LLMs that expose a compatible endpoint.
Assistants API Deprecated Mid-2026
Legacy stateful assistant API. Being sunset in mid-2026. Developers should migrate to the Responses API using the official migration guide.
History

From Swarm to Enterprise Agents SDK

๐Ÿ”—
๐Ÿงช
2024
Swarm โ€” Experimental Prototype
OpenAI releases Swarm as a lightweight, experimental framework for exploring multi-agent patterns. Not intended for production use.
๐Ÿš€
Mar 2025
Agents SDK v1 โ€” Production Release
Production-ready evolution of Swarm. Introduces formal primitives: Agents, Handoffs, Guardrails, and built-in Tracing. Python and TypeScript. Provider-agnostic support for 100+ LLMs.
โšก
Apr 2026
Next Evolution โ€” Enterprise Update
Adds sandboxing and long-horizon harness (Python). Subagents and code mode coming to both languages. Assistants API deprecation announced for mid-2026.
HowTo

Get Started with the Agents SDK

๐Ÿ”—
1
Run pip install openai-agents. Set OPENAI_API_KEY in your environment. For TypeScript: npm install @openai/agents. Available to all OpenAI API customers at standard pricing.
2
Create an Agent with a system prompt (instructions) and tools. Tools can be Python functions decorated with @function_tool or built-in tools like web search and code execution.
3
Define Guardrail objects to validate inputs before execution and outputs before return. Guardrails are lightweight checks that can block or modify messages violating safety policies.
4
For multi-agent workflows, create specialised agents and wire them via handoffs. Your orchestrator automatically delegates subtasks to the right specialist agent.
5
For production workloads involving files or code, enable the sandbox option on your agent runner to isolate it within a controlled environment. Currently Python-only; TypeScript support coming.
6
Execute via Runner.run(). Built-in tracing captures the full execution graph automatically. View traces in the OpenAI platform dashboard for debugging and evaluation.
7
If using the Assistants API (deprecated mid-2026), follow OpenAI's migration guide to move to the Responses API. All new agent development should use the Responses API as its foundation.
FAQ

Frequently Asked Questions

๐Ÿ”—
What is the OpenAI Agents SDK?โ–พ

A lightweight, production-ready open-source framework for building multi-agent workflows in Python and TypeScript. Evolved from the experimental Swarm project. Supports OpenAI APIs and 100+ third-party LLMs.

What does the new sandboxing do?โ–พ

Sandboxing isolates the agent inside a controlled computer environment where it can only access designated files and code. This protects the broader host system from unpredictable agent behaviour during autonomous operation.

What is the long-horizon harness?โ–พ

New orchestration infrastructure for building long-horizon agents โ€” complex, multi-step tasks. Developers bring their own compute and storage; the harness provides the coordination layer. Launching in Python first.

What are the three core SDK primitives?โ–พ

(1) Agents โ€” LLM workers with instructions and tools; (2) Handoffs โ€” agent-to-agent task delegation; (3) Guardrails โ€” I/O validation for safety and policy compliance. Plus built-in Tracing.

What does provider-agnostic mean?โ–พ

The Agents SDK works with any model that exposes a Chat Completions-compatible API endpoint โ€” enabling 100+ non-OpenAI LLMs from third-party and open-source providers.

Why is the Responses API the recommended foundation?โ–พ

It combines the language capability of the Chat Completions API with the tool-use functionality of the Assistants API in one modern API. The Assistants API will be deprecated in mid-2026.

How do agent handoffs work?โ–พ

A primary agent delegates a subtask to another specialised agent. The receiving agent has its own instructions and tools. Agents can also be exposed as tools ('Agents as Tools'), letting an orchestrator call them like any other function.

What are subagents and when are they available?โ–พ

Subagents allow an orchestrator to spawn specialised subordinate agents for parallel, modular task decomposition. They are forthcoming โ€” being added to both Python and TypeScript versions of the SDK.

How does built-in tracing work?โ–พ

Tracing automatically records the full execution graph โ€” tool calls, handoffs, model outputs โ€” with no extra instrumentation required. Traces are viewable in the OpenAI platform and integrate with eval and fine-tuning tools.

How does the Agents SDK differ from Swarm?โ–พ

Swarm was experimental and not production-ready. The Agents SDK adds formal primitives (handoffs, guardrails, tracing), enterprise safety (sandboxing), long-horizon support (harness), and provider-agnostic model compatibility.

Is the SDK free to use?โ–พ

The Agents SDK itself is open-source and free. It is available to all OpenAI API customers. API calls use standard OpenAI pricing.

What is TypeScript support status?โ–พ

The core Agents SDK is available in both Python and TypeScript. The new sandboxing and harness capabilities launch in Python first; TypeScript support is planned. Subagents and code mode will come to both.

Glossary

Key Terms

๐Ÿ”—
LLM-powered worker with instructions and tools. The primary unit of work in any Agents SDK workflow.
Delegation of a task from one agent to another. Also supports 'Agents as Tools' patterns.
Input/output validation primitive enforcing safety policies and formatting requirements.
Isolated environment restricting agent file and code access to a designated workspace.
Orchestration scaffolding for long-horizon, multi-step agentic tasks with user-provided infrastructure.
Subordinate agent spawned by an orchestrator for modular, parallel task decomposition. Coming soon.
Automatic execution graph recording for visualisation, debugging, and monitoring. No instrumentation needed.
Complex, multi-step task requiring persistent state across many actions and extended execution time.
SDK design enabling use with any Chat Completions-compatible model โ€” 100+ non-OpenAI LLMs supported.
Top-level agent or host application coordinating the overall workflow and delegating to specialists.