This directory contains samples demonstrating how to use the OpenAI Agents SDK with Temporal's durable execution engine. These samples are adapted from the OpenAI Agents SDK examples and extended with Temporal's durability and orchestration capabilities.
See the module documentation for more information.
The integration combines:
- Temporal workflows for orchestrating agent control flow and state management
- OpenAI Agents SDK for AI agent creation and tool interactions
This approach ensures that AI agent workflows are durable, observable, and can handle failures gracefully.
- Temporal server running locally
- Required dependencies installed via
uv sync --group openai-agents - OpenAI API key set as environment variable:
export OPENAI_API_KEY=your_key_here
-
Start the worker (supports all samples):
uv run openai_agents/run_worker.py
-
Run individual samples in separate terminals:
-
Hello World Agent - Simple agent that responds in haikus:
uv run openai_agents/run_hello_world_workflow.py
-
Tools Agent - Agent with access to external tools (weather API):
uv run openai_agents/run_tools_workflow.py
-
Research Workflow - Multi-agent research system with specialized roles:
uv run openai_agents/run_research_workflow.py
Features a planner agent, search agent, and writer agent working together.
-
Customer Service Workflow - Customer service agent with escalation capabilities (interactive):
uv run openai_agents/run_customer_service_client.py --conversation-id my-conversation-123
-
Agents as Tools - Demonstrate using agents as tools within other agents:
uv run openai_agents/run_agents_as_tools_workflow.py