diff --git a/docs/src/content/docs/guides/models.mdx b/docs/src/content/docs/guides/models.mdx
index 945e0b91..0c8c76a2 100644
--- a/docs/src/content/docs/guides/models.mdx
+++ b/docs/src/content/docs/guides/models.mdx
@@ -61,9 +61,10 @@ const myAgent = new Agent({
   name: 'My Agent',
   instructions: "You're a helpful agent.",
   modelSettings: {
-    reasoning: { effort: 'minimal' },
-    text: { verbosity: 'low' },
-  },
+    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',