From 8a5e8dca79119809a882dc5030f1b987101836d7 Mon Sep 17 00:00:00 2001
From: Drew Robbins <drew@drewby.com>
Date: Sun, 14 Sep 2025 17:11:04 +0900
Subject: [PATCH 1/3] GPT5 Settings need to be in providerData

Updated modelSettings to include providerData structure.
---
 docs/src/content/docs/guides/models.mdx | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/src/content/docs/guides/models.mdx b/docs/src/content/docs/guides/models.mdx
index 945e0b91..adb4729c 100644
--- a/docs/src/content/docs/guides/models.mdx
+++ b/docs/src/content/docs/guides/models.mdx
@@ -60,10 +60,15 @@ import { Agent } from '@openai/agents';
 const myAgent = new Agent({
   name: 'My Agent',
   instructions: "You're a helpful agent.",
-  modelSettings: {
-    reasoning: { effort: 'minimal' },
-    text: { verbosity: 'low' },
-  },
+    modelSettings: {
+      providerData: {
+        reasoning: {
+          effort: 'minimal',
+        },
+        text: {
+          verbosity: 'low',
+        },
+      },
   // If OPENAI_DEFAULT_MODEL=gpt-5 is set, passing only modelSettings works.
   // It's also fine to pass a GPT-5 model name explicitly:
   // model: 'gpt-5',

From aa95241d0473f849c4fcde55a7adde5eb5cd8724 Mon Sep 17 00:00:00 2001
From: Drew Robbins <drew@drewby.com>
Date: Sun, 14 Sep 2025 08:41:31 +0000
Subject: [PATCH 2/3] Fix indentation.

---
 docs/src/content/docs/guides/models.mdx | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/src/content/docs/guides/models.mdx b/docs/src/content/docs/guides/models.mdx
index adb4729c..6a33f15e 100644
--- a/docs/src/content/docs/guides/models.mdx
+++ b/docs/src/content/docs/guides/models.mdx
@@ -60,15 +60,15 @@ import { Agent } from '@openai/agents';
 const myAgent = new Agent({
   name: 'My Agent',
   instructions: "You're a helpful agent.",
-    modelSettings: {
-      providerData: {
-        reasoning: {
-          effort: 'minimal',
-        },
-        text: {
-          verbosity: 'low',
-        },
+  modelSettings: {
+    providerData: {
+      reasoning: {
+        effort: 'minimal',
       },
+      text: {
+        verbosity: 'low',
+      },
+    },
   // If OPENAI_DEFAULT_MODEL=gpt-5 is set, passing only modelSettings works.
   // It's also fine to pass a GPT-5 model name explicitly:
   // model: 'gpt-5',

From abce3235d3ef5e69a6f8dd35aa6ed2c1fbc3286e Mon Sep 17 00:00:00 2001
From: Kazuhiro Sera <seratch@openai.com>
Date: Mon, 15 Sep 2025 20:38:54 +0900
Subject: [PATCH 3/3] Update docs/src/content/docs/guides/models.mdx

---
 docs/src/content/docs/guides/models.mdx | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/docs/src/content/docs/guides/models.mdx b/docs/src/content/docs/guides/models.mdx
index 6a33f15e..0c8c76a2 100644
--- a/docs/src/content/docs/guides/models.mdx
+++ b/docs/src/content/docs/guides/models.mdx
@@ -62,12 +62,8 @@ const myAgent = new Agent({
   instructions: "You're a helpful agent.",
   modelSettings: {
     providerData: {
-      reasoning: {
-        effort: 'minimal',
-      },
-      text: {
-        verbosity: 'low',
-      },
+      reasoning: { effort: 'minimal' },
+      text: { verbosity: 'low' },
     },
   // If OPENAI_DEFAULT_MODEL=gpt-5 is set, passing only modelSettings works.
   // It's also fine to pass a GPT-5 model name explicitly: