openai-agents-sdk

Original：🇺🇸 English
Translated

OpenAI Agents SDK (Python) development. Use when building AI agents, multi-agent workflows, tool integrations, or streaming applications with the openai-agents package.

5installs
Sourcelaguagu/claude-code-nextjs-skills
Added on

NPX Install

npx skill4agent add laguagu/claude-code-nextjs-skills openai-agents-sdk

Tags

Translated version includes tags in frontmatter
openai-agentsai-agent-developmentpython-sdkmulti-agent-workflowstool-integration

SKILL.md Content

View Translation Comparison →

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 (direct)
OPENAI_API_KEY=sk-...
LLM_PROVIDER=openai

# Azure OpenAI (via LiteLLM)
LLM_PROVIDER=azure
AZURE_API_KEY=...
AZURE_API_BASE=https://your-resource.openai.azure.com
AZURE_API_VERSION=2024-12-01-preview

Basic Agent

python
from agents import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    model="gpt-5.2",  # or "gpt-5", "gpt-5.2-nano"
)

# 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

PatternPurpose
Basic AgentSimple Q&A with instructions
Azure/LiteLLMAzure OpenAI integration
AgentOutputSchemaStrict JSON validation with Pydantic
Function ToolsExternal actions (@function_tool)
StreamingReal-time UI (Runner.run_streamed)
HandoffsSpecialized agents, delegation
Agents as ToolsOrchestration (agent.as_tool)
LLM as JudgeIterative improvement loop
GuardrailsInput/output validation
SessionsAutomatic conversation history
Multi-Agent PipelineMulti-step workflows

Reference Documentation

For detailed information, see:
  • agents.md - Agent creation, Azure/LiteLLM integration
  • tools.md - Function tools, hosted tools, agents as tools
  • structured-output.md - Pydantic output, AgentOutputSchema
  • streaming.md - Streaming patterns, SSE with FastAPI
  • handoffs.md - Agent delegation
  • guardrails.md - Input/output validation
  • sessions.md - Sessions, conversation history
  • patterns.md - Multi-agent workflows, LLM as judge, tracing

Official Documentation