Please note that this version includes a small breaking change (breaks Agent into AgentBase + Agent), hence the minor version bump. See https://openai.github.io/openai-agents-python/release/ for the breaking change changelog.
Key changes include:
- Support for
Sessions, a way to manage conversation sessions. - Beta support for Realtime agents (likely buggy, and we are evolving/fixing it as we speak)
What's Changed
- docs: mention 'name' is required in Agent constructor . fix: mention 'name' as required in Agent init doc by @maneeshanif in #1033
- Fix agent lifecycle example output to reflect correct hook execution order by @DanielHashmi in #1015
- Support mcp prompts by @thoo in #1010
- Add on_start support to VoiceWorkflowBase and VoicePipeline by @vrtnis in #922
- Add Makefile check rule to run all the linters and checkers by @ant31 in #1038
- Support for file_input content (#fix 893) by @ant31 in #1009
- description_override is not properly used for function_schema.description by @HafizFasih in #1000
- avoid concat tool call delta id by @DeoLeung in #990
- Fix #976 MCP filtering, make agent and run ctx optional by @njbrake in #977
- Add Sessions for Automatic Conversation History Management by @knowsuchagency in #752
- Updated llm_as_a_judge.py by @zaidrj in #1055
- [1/n] Break Agent into AgentBase+Agent by @rm-openai in #1068
- [2/n] Introduce RealtimeAgent by @rm-openai in #1069
- [3/n] Config and items for realtime by @rm-openai in #1070
- [4/n] Transport interface + events by @rm-openai in #1071
- [5/n] OpenAI realtime transport impl by @rm-openai in #1072
- [6/n] RealtimeSession + events by @rm-openai in #1073
- [7/n] Demo for realtime by @rm-openai in #1074
- Fix typo in Evaluator Instructions (capitalization of "After 5 attemp… by @mshsheikh in #1067
- [8/n] Make realtime more like the rest of agents sdk by @rm-openai in #1076
- Tests for realtime runner by @rm-openai in #1079
- Tests for realtime session by @rm-openai in #1080
- Add tests for openai realtime model by @rm-openai in #1081
- Fix #968 by upgrading openai package to the latest by @seratch in #1034
- Realtime guardrail support by @rm-openai in #1082
- Realtime tracing by @rm-openai in #1084
- enhancement: Add tool_name to ToolContext to support shared tool handlers by @vrtnis in #1043
- Fix incorrect comment order when popping session items by @MuhammadHassaanArain in #1086
- Back out "enhancement: Add tool_name to ToolContext to support shared tool handlers (#1043)" by @rm-openai in #1105
- Realtime: run guardrails without blockign event loop by @rm-openai in #1104
- Run make format by @rm-openai in #1106
- Realtime: forward exceptions from transport layer by @rm-openai in #1107
- Realtime: update model to have a single send_event method by @rm-openai in #1111
- Realtime: send session.update event at connection/handoffs by @rm-openai in #1112
- add numpy dev dependency by @jhills20 in #1117
- feat(function_schema): Add support for pydantic
Fieldannotations in tool arguments (for tools decorated with@function_schema) by @georg-wolflein in #1124 - Fix typos and update async for loop variable by @sarmadalikhanofficial in #1122
- Realtime: export everything by @rm-openai in #1118
- Update examples docs with realtime section by @jhills20 in #1113
- Retry: Add tool_name to ToolContext for generic tool handlers by @vrtnis in #1110
- update-input-guardrail-name by @Quratulain-bilal in #1053
- Realtime: fix item parsing by @rm-openai in #1119
New Contributors
- @maneeshanif made their first contribution in #1033
- @thoo made their first contribution in #1010
- @vrtnis made their first contribution in #922
- @ant31 made their first contribution in #1038
- @HafizFasih made their first contribution in #1000
- @DeoLeung made their first contribution in #990
- @knowsuchagency made their first contribution in #752
- @zaidrj made their first contribution in #1055
- @mshsheikh made their first contribution in #1067
- @MuhammadHassaanArain made their first contribution in #1086
- @georg-wolflein made their first contribution in #1124
- @sarmadalikhanofficial made their first contribution in #1122
- @Quratulain-bilal made their first contribution in #1053
Full Changelog: v0.1.0...v0.2.0