openai/openai-agents-python v0.8.4

on GitHub

Key Changes

Hosted container tool + Skills

This release includes the hosted shell runtime tool along with its native skills support. Developers now can pass a container-based shell runtime with skills this way:

from agents import Agent, ShellTool

agent = Agent(
    name="Shell Agent",
    model="gpt-5.2",
    instructions="Use the available shell tool to answer user requests.",
    tools=[
        ShellTool(
            environment={
                "type": "container_auto",
                "network_policy": {"type": "disabled"},
                "skills": [
                    {
                        "type": "skill_reference",
                        "skill_id": "skill_698bbe879adc81918725cbc69dcae7960bc5613dadaed377",
                        "version": "1",
                    }
                ],
            }
        )
    ],
)

Refer to examples/tools/container_shell_inline_skill.py and examples/tools/container_shell_skill_reference.py for more details.

What's Changed

• feat: add container shell + skills support by @seratch in #2469
• fix(realtime): omit null audio formats in SIP call attach updates by @OiPunk in #2454
• fix(result): support Pydantic model_rebuild for RunResultStreaming by @OiPunk in #2455
• fix(tool): resolve default failure handler at invoke time by @OiPunk in #2460
• fix(agent-tools): inherit parent RunConfig when agent-as-tool is invoked by @OiPunk in #2463
• fix(stream): emit queued events before max-turns exception by @OiPunk in #2458
• fix(prompt): omit tool_choice when prompt manages built-in tools by @OiPunk in #2464

Documents & Other Changes

• docs: update translated document pages by @github-actions[bot] in #2452
• fix(mcp): validate required params before call_tool by @OiPunk in #2453
• docs: clarify Azure Realtime GA endpoint configuration by @OiPunk in #2440
• docs: update translated document pages by @github-actions[bot] in #2466
• Release 0.8.4 by @github-actions[bot] in #2465

Full Changelog: v0.8.3...v0.8.4