chore: import upstream snapshot with attribution

python/samples/concepts/agents/openai_responses/responses_agent_reasoning.py

@@ -0,0 +1,151 @@
+# Copyright (c) Microsoft. All rights reserved.
+import asyncio
+
+from semantic_kernel.agents.open_ai.azure_responses_agent import AzureResponsesAgent
+from semantic_kernel.agents.open_ai.openai_responses_agent import OpenAIResponsesAgent
+from semantic_kernel.connectors.ai.open_ai import AzureOpenAISettings, OpenAISettings
+from semantic_kernel.contents.reasoning_content import ReasoningContent
+
+"""
+The following sample demonstrates how to create an OpenAI Responses Agent
+with reasoning capabilities using either OpenAI or Azure OpenAI. The sample
+shows how to enable basic reasoning and reasoning with summaries, which exposes
+the agent's internal thought process via the on_intermediate_message callback.
+
+Two reasoning configurations are demonstrated:
+
+1. Basic reasoning:
+   - Works for all OpenAI organizations
+   - Reasoning happens internally but no intermediate thoughts are exposed
+   - Still benefits from the model's reasoning process in final responses
+
+2. Reasoning with summary:
+   - Requires verified OpenAI organization access
+   - Exposes the model's internal thought process via ReasoningContent
+   - Shows step-by-step reasoning through the intermediate message callback
+
+The reasoning content shows the internal thought process of models that
+support reasoning (like gpt-5, o3, o1-mini). This sample uses non-streaming
+invocation patterns.
+"""
+
+
+async def create_reasoning_agent():
+    """Create a reasoning-enabled agent without summary (works for all orgs)."""
+    openai_settings = OpenAISettings()
+    model_id = openai_settings.responses_model_id or openai_settings.chat_model_id
+    if openai_settings.api_key and model_id:
+        client = OpenAIResponsesAgent.create_client()
+        return OpenAIResponsesAgent(
+            ai_model_id=model_id,
+            client=client,
+            name="ReasoningAgent",
+            instructions="You are a helpful assistant that thinks step-by-step.",
+            reasoning={"effort": "high"},
+        )
+
+    # Fallback to Azure OpenAI
+    azure_settings = AzureOpenAISettings()
+    if azure_settings.endpoint and azure_settings.responses_deployment_name:
+        client = AzureResponsesAgent.create_client()
+        return AzureResponsesAgent(
+            ai_model_id=azure_settings.responses_deployment_name,
+            client=client,
+            name="ReasoningAgent",
+            instructions="You are a helpful assistant that thinks step-by-step.",
+            reasoning={"effort": "high"},
+        )
+
+    return None
+
+
+async def create_reasoning_agent_with_summary():
+    """Create a reasoning-enabled agent with summary (requires verified org)."""
+    openai_settings = OpenAISettings()
+    model_id = openai_settings.responses_model_id or openai_settings.chat_model_id
+    if openai_settings.api_key and model_id:
+        client = OpenAIResponsesAgent.create_client()
+        return OpenAIResponsesAgent(
+            ai_model_id=model_id,
+            client=client,
+            name="ReasoningAgent",
+            instructions="You are a helpful assistant that thinks step-by-step.",
+            reasoning={"effort": "high", "summary": "detailed"},
+        )
+
+    azure_settings = AzureOpenAISettings()
+    if azure_settings.endpoint and azure_settings.responses_deployment_name:
+        client = AzureResponsesAgent.create_client()
+        return AzureResponsesAgent(
+            ai_model_id=azure_settings.responses_deployment_name,
+            client=client,
+            name="ReasoningAgent",
+            instructions="You are a helpful assistant that thinks step-by-step.",
+            reasoning={"effort": "high", "summary": "detailed"},
+        )
+
+    return None
+
+
+async def handle_reasoning_message(message):
+    """Handle reasoning content from the agent's intermediate messages.
+
+    This callback function will be called for each intermediate message
+    when reasoning summaries are enabled, allowing access to the model's
+    internal thought process via ReasoningContent items.
+
+    Args:
+        message: The intermediate message containing potential ReasoningContent items.
+    """
+    reasoning_items = [item for item in message.items if isinstance(item, ReasoningContent)]
+    for reasoning in reasoning_items:
+        if reasoning.text:
+            print(f"\033[36m{reasoning.text}\033[0m", end="", flush=True)
+
+
+async def main():
+    """The main function that demonstrates OpenAI Reasoning responses."""
+    # Define the query to test reasoning capabilities
+    query = "Plan a birthday party for 15 people with a $500 budget. What are the key decisions I need to make?"
+
+    # 1. Create and use a basic reasoning agent
+    try:
+        reasoning_agent = await create_reasoning_agent()
+        if not reasoning_agent:
+            print("Failed to create reasoning agent. Please check your API configuration.")
+            return
+
+        print("===== Basic Reasoning =====")
+        print(f"Query: {query}")
+        print("\nResponse:")
+        await reasoning_agent.add_chat_message(content=query, role="user")
+        reasoning_response = await reasoning_agent.invoke()
+        print(f"{reasoning_response.content}")
+    except Exception as e:
+        print(f"Basic reasoning example failed. Error: {e}")
+        print("Please check your API configuration and model availability.")
+        return
+
+    # 2. Create and use a reasoning agent with summaries enabled
+    try:
+        reasoning_with_summary_agent = await create_reasoning_agent_with_summary()
+        if not reasoning_with_summary_agent:
+            print("Failed to create reasoning agent with summary. This requires verified OpenAI organization access.")
+            print("===== Done! =====")
+            return
+
+        print("\n\n===== Reasoning with Summaries =====")
+        print(f"Query: {query}")
+        print("\nReasoning summary:")
+        await reasoning_with_summary_agent.add_chat_message(content=query, role="user")
+        summary_response = await reasoning_with_summary_agent.invoke(handle_reasoning_message)
+        print(f"\n\nAnswer: {summary_response.content}")
+    except Exception as e:
+        print(f"\nSummary examples require a verified organization. Error: {e}")
+        print("The reasoning summary feature is only available to verified OpenAI organizations.")
+
+    print("\n\n===== Done! =====")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())