Files
microsoft--semantic-kernel/python/samples/concepts/agents/openai_responses/responses_agent_reasoning.py
T
wehub-resource-sync b957a53def
CodeQL / Analyze (csharp) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:21:23 +08:00

152 lines
6.2 KiB
Python

# 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())