Update migration docs to reflect ChatOptions.Reasoning and CreateResponseOptions

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>

Author: Copilot

.github/upgrades/prompts/SemanticKernelToAgentFramework.md

@@ -863,27 +863,41 @@ if (!string.IsNullOrEmpty(generatedCode.ToString()))
 #### Provider-Specific Options Configuration
 
 <configuration_changes>
-For advanced model settings not available in `ChatOptions`, use the `RawRepresentationFactory` property:
+For reasoning model settings, use the `ChatOptions.Reasoning` property:
+
+```csharp
+var agentOptions = new ChatClientAgentRunOptions(new ChatOptions
+{
+    MaxOutputTokens = 8000,
+    Reasoning = new()
+    {
+        Effort = ReasoningEffort.High,
+        Output = ReasoningOutput.Full
+    }
+});
+```
+
+For other advanced model settings not available in `ChatOptions`, use the `RawRepresentationFactory` property:
 
 ```csharp
 var agentOptions = new ChatClientAgentRunOptions(new ChatOptions
 {
     MaxOutputTokens = 8000,
     // Breaking glass to access provider-specific options
-    RawRepresentationFactory = (_) => new OpenAI.Responses.ResponseCreationOptions()
+    RawRepresentationFactory = (_) => new OpenAI.Responses.CreateResponseOptions()
     {
-        ReasoningOptions = new()
-        {
-            ReasoningEffortLevel = OpenAI.Responses.ResponseReasoningEffortLevel.High,
-            ReasoningSummaryVerbosity = OpenAI.Responses.ResponseReasoningSummaryVerbosity.Detailed
-        }
+        // Provider-specific settings here
     }
 });
 ```
 
-**Use this pattern when:**
+**Use the Reasoning property when:**
+1. Configuring reasoning effort level (Low, Medium, High)
+2. Configuring reasoning output format (None, Summary, Full)
+
+**Use RawRepresentationFactory when:**
 1. Standard `ChatOptions` properties don't cover required model settings
-2. Provider-specific configuration is needed (e.g., reasoning effort level)
+2. Provider-specific configuration is needed beyond reasoning
 3. Advanced SDK features need to be accessed
 </configuration_changes>