Azure OpenAI Basic Reasoning Stream

Stream reasoning events from an agent backed by GPT-4.1 on Azure OpenAI.

basic_reasoning_stream.py

"""
Basic Reasoning Stream
======================

Demonstrates this reasoning cookbook example.
"""

import asyncio

from agno.agent import Agent
from agno.models.azure.openai_chat import AzureOpenAI
from agno.run.agent import RunEvent  # noqa


# ---------------------------------------------------------------------------
# Create Example
# ---------------------------------------------------------------------------
def run_example() -> None:
    async def streaming_reasoning():
        """Test streaming reasoning with a Azure OpenAI model."""
        # Create an agent with reasoning enabled
        agent = Agent(
            reasoning_model=AzureOpenAI(id="gpt-4.1"),
            reasoning=True,
            instructions="Think step by step about the problem.",
        )

        prompt = "What is 25 * 37? Show your reasoning."

        await agent.aprint_response(prompt, stream=True, stream_events=True)

        # Use manual event loop to see all events
        # async for run_output_event in agent.arun(
        #     prompt,
        #     stream=True,
        #     stream_events=True,
        # ):
        #     if run_output_event.event == RunEvent.run_started:
        #         print(f"\nEVENT: {run_output_event.event}")

        #     elif run_output_event.event == RunEvent.reasoning_started:
        #         print(f"\nEVENT: {run_output_event.event}")
        #         print("Reasoning started...\n")

        #     elif run_output_event.event == RunEvent.reasoning_content_delta:
        #         # This is the NEW streaming event for reasoning content
        #         print(run_output_event.reasoning_content, end="", flush=True)

        #     elif run_output_event.event == RunEvent.reasoning_step:
        #         print(f"\nEVENT: {run_output_event.event}")

        #     elif run_output_event.event == RunEvent.reasoning_completed:
        #         print(f"\n\nEVENT: {run_output_event.event}")

        #     elif run_output_event.event == RunEvent.run_content:
        #         if run_output_event.content:
        #             print(run_output_event.content, end="", flush=True)

        #     elif run_output_event.event == RunEvent.run_completed:
        #         print(f"\n\nEVENT: {run_output_event.event}")

    if __name__ == "__main__":
        asyncio.run(streaming_reasoning())


# ---------------------------------------------------------------------------
# Run Example
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    run_example()

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno openai
   
3. Export environment variables

   Mac/Linux

   export AZURE_OPENAI_API_KEY="your_azure_openai_api_key_here"
   export AZURE_OPENAI_ENDPOINT="your_azure_openai_endpoint_here"
   export OPENAI_API_KEY="your_openai_api_key_here"
   

   $Env:AZURE_OPENAI_API_KEY="your_azure_openai_api_key_here"
   $Env:AZURE_OPENAI_ENDPOINT="your_azure_openai_endpoint_here"
   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   
4. Run the example

   Save the code above as basic_reasoning_stream.py, then run:

   python basic_reasoning_stream.py
   

Full source: cookbook/10_reasoning/models/azure_openai/basic_reasoning_stream.py