openai-agents-sdk

# OpenAI Agents SDK (Python) Use this skill when developing AI agents using OpenAI Agents SDK (`openai-agents` package). ## Quick Reference ### Installation ```bash pip install openai-agents ``` ### Environment Variables ```bash OPENAI_API_KEY=sk-... ``` Using Azure or another provider instead? See [agents.md](references/agents.md#other-providers-litellm) — don't hardcode provider env vars here, they vary and go stale. ### Basic Agent ```python from agents import Agent, Runner agent = Agent( name="Assistant", instructions="You are a helpful assistant.", model="gpt-5.6", # or "gpt-5.6-terra" / "gpt-5.6-luna" (cheaper tiers); verify current IDs from the model catalog ) # Synchronous result = Runner.run_sync(agent, "Tell me a joke") print(result.final_output) # Asynchronous result = await Runner.run(agent, "Tell me a joke") ``` ### Key Patterns | Pattern | Purpose | |---------|---------| | Basic Agent | Simple Q&A with instructions | | Azure/LiteLLM | Azure OpenAI integration | | AgentOutputSchema | Strict JSON validation with Pydantic | | Function Tools | External actions (@function_tool) | | Streaming | Real-time UI (Runner.run_streamed) | | Handoffs | Specialized agents, delegation | | Agents as Tools | Orchestration (agent.as_tool) | | LLM as Judge | Iterative improvement loop | | Guardrails | Input/output validation | | Sessions | Automatic conversation history | | Multi-Agent Pipeline | Multi-step workflows | | Sandboxing | Isolated execution env...