Python: Add load_dotenv() to samples for .env file support (#4043)

* Initial plan

* Add load_dotenv() to 303 Python samples for environment variable loading

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Update SAMPLE_GUIDELINES.md to document load_dotenv() requirement

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Update samples README.md to document .env file usage

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Run ruff format on all changed sample files

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Clarify load_dotenv() usage in README - local dev vs production

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Remove deprecated getting_started folder as requested

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Document env_file_path parameter for per-client configuration

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Merge main branch to resolve conflicts

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Fix run_evaluation.py file that was empty in merge commit

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Remove dotnet changes from merge - out of scope for this PR

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Remove package and test changes from merge - only sample changes needed

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Remove test_func_utils.py - only sample changes needed

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Revert sample files not in original changeset - keep only load_dotenv additions

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Move load_dotenv() outside snippet tag in 06_host_your_agent.py

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Fix comment placement - move load_dotenv before code comments

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Fix load_dotenv() placement across all samples - after docstring, before code comments

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Merge latest main branch with load_dotenv changes

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Remove non-sample changes from merge - keep only load_dotenv additions

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Revert non-load_dotenv sample changes from merge

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Fix run_evaluation.py - use main's improved version (file already had load_dotenv)

Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>

* Manual update

* Manual update 2

* Fix Role usage and load_dotenv placement per PR review feedback

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix Role usage - use string literals not enum attributes

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix SAMPLE_GUIDELINES.md example - load_dotenv before docstring per guidance

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Move load_dotenv() before docstrings in all samples per SAMPLE_GUIDELINES ordering

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Address PR review: rename files, fix placement, add session usage, remove note

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Update Redis README to reference renamed file redis_history_provider.py

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: TaoChenOSU <12570346+TaoChenOSU@users.noreply.github.com>
Co-authored-by: Tao Chen <taochen@microsoft.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

python/samples/03-workflows/_start-here/step2_agents_in_a_workflow.py

@@ -7,6 +7,10 @@ from typing import cast
 from agent_framework import AgentResponse, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Step 2: Agents in a Workflow non-streaming

python/samples/03-workflows/_start-here/step3_streaming.py

@@ -6,6 +6,10 @@ import os
 from agent_framework import AgentResponseUpdate, Message, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Step 3: Agents in a workflow with streaming

python/samples/03-workflows/agents/azure_ai_agents_streaming.py

@@ -6,6 +6,10 @@ import os
 from agent_framework import AgentResponseUpdate, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Azure AI Agents in a Workflow with Streaming

python/samples/03-workflows/agents/azure_ai_agents_with_shared_session.py

@@ -15,6 +15,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Agents with a shared thread in a workflow

python/samples/03-workflows/agents/azure_chat_agents_and_executor.py

@@ -15,6 +15,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: AzureOpenAI Chat Agents and an Executor in a Workflow with Streaming

python/samples/03-workflows/agents/azure_chat_agents_streaming.py

@@ -6,6 +6,10 @@ import os
 from agent_framework import AgentResponseUpdate, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: AzureOpenAI Chat Agents in a Workflow with Streaming

python/samples/03-workflows/agents/azure_chat_agents_tool_calls_with_feedback.py

@@ -24,9 +24,13 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Tool-enabled agents with human feedback
 

python/samples/03-workflows/agents/concurrent_workflow_as_agent.py

@@ -6,6 +6,10 @@ import os
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Build a concurrent workflow orchestration and wrap it as an agent.

python/samples/03-workflows/agents/custom_agent_executors.py

@@ -13,6 +13,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Custom Agent Executors in a Workflow

python/samples/03-workflows/agents/group_chat_workflow_as_agent.py

@@ -7,6 +7,10 @@ from agent_framework import Agent
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import GroupChatBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Group Chat Orchestration

python/samples/03-workflows/agents/handoff_workflow_as_agent.py

@@ -15,6 +15,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import HandoffAgentUserRequest, HandoffBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """Sample: Handoff Workflow as Agent with Human-in-the-Loop.
 

python/samples/03-workflows/agents/magentic_workflow_as_agent.py

@@ -9,6 +9,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import MagenticBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Build a Magentic orchestration and wrap it as an agent.

python/samples/03-workflows/agents/sequential_workflow_as_agent.py

@@ -6,6 +6,10 @@ import os
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Build a sequential workflow orchestration and wrap it as an agent.

python/samples/03-workflows/agents/workflow_as_agent_human_in_the_loop.py

@@ -10,6 +10,7 @@ from typing import Any
 
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 
 # Ensure local package can be imported when running as a script.
 _SAMPLES_ROOT = Path(__file__).resolve().parents[3]
@@ -55,6 +56,9 @@ Prerequisites:
   workflow_as_agent_reflection.py.
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 @dataclass
 class HumanReviewRequest:

python/samples/03-workflows/agents/workflow_as_agent_kwargs.py

@@ -9,8 +9,12 @@ from agent_framework import tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Workflow as Agent with kwargs Propagation to @tool Tools
 

python/samples/03-workflows/agents/workflow_as_agent_reflection_pattern.py

@@ -16,8 +16,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Workflow as Agent with Reflection and Retry Pattern
 

python/samples/03-workflows/agents/workflow_as_agent_with_session.py

@@ -7,6 +7,10 @@ from agent_framework import AgentSession, InMemoryHistoryProvider
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Workflow as Agent with Session Conversation History and Checkpointing

python/samples/03-workflows/checkpoint/checkpoint_with_human_in_the_loop.py

@@ -8,18 +8,6 @@ from datetime import datetime
 from pathlib import Path
 from typing import Any
 
-from azure.identity import AzureCliCredential
-
-if sys.version_info >= (3, 12):
-    from typing import override  # type: ignore # pragma: no cover
-else:
-    from typing_extensions import override  # type: ignore[import] # pragma: no cover
-
-
-# NOTE: the Azure client imports above are real dependencies. When running this
-# sample outside of Azure-enabled environments you may wish to swap in the
-# `agent_framework.builtin` chat client or mock the writer executor. We keep the
-# concrete import here so readers can see an end-to-end configuration.
 from agent_framework import (
     AgentExecutor,
     AgentExecutorRequest,
@@ -34,6 +22,16 @@ from agent_framework import (
     response_handler,
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
+from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+if sys.version_info >= (3, 12):
+    from typing import override  # type: ignore # pragma: no cover
+else:
+    from typing_extensions import override  # type: ignore[import] # pragma: no cover
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Checkpoint + human-in-the-loop quickstart.

python/samples/03-workflows/checkpoint/workflow_as_agent_checkpoint.py

@@ -34,10 +34,15 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def basic_checkpointing() -> None:
     """Demonstrate basic checkpoint storage with workflow-as-agent."""
+
     print("=" * 60)
     print("Basic Checkpointing with Workflow as Agent")
     print("=" * 60)

python/samples/03-workflows/composition/sub_workflow_basics.py

@@ -141,10 +141,7 @@ def create_sub_workflow() -> WorkflowExecutor:
     print("Setting up sub-workflow...")
 
     text_processor = TextProcessor()
-    processing_workflow = (
-        WorkflowBuilder(start_executor=text_processor)
-        .build()
-    )
+    processing_workflow = WorkflowBuilder(start_executor=text_processor).build()
 
     return WorkflowExecutor(processing_workflow, id="text_processor_workflow")
 

python/samples/03-workflows/composition/sub_workflow_kwargs.py

@@ -13,6 +13,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Sub-Workflow kwargs Propagation

python/samples/03-workflows/composition/sub_workflow_request_interception.py

@@ -271,7 +271,9 @@ async def main() -> None:
     # Build the main workflow
     smart_email_orchestrator = SmartEmailOrchestrator(id="smart_email_orchestrator", approved_domains=approved_domains)
     email_delivery = EmailDelivery(id="email_delivery")
-    email_validation_workflow = WorkflowExecutor(build_email_address_validation_workflow(), id="email_validation_workflow")
+    email_validation_workflow = WorkflowExecutor(
+        build_email_address_validation_workflow(), id="email_validation_workflow"
+    )
 
     workflow = (
         WorkflowBuilder(start_executor=smart_email_orchestrator)

python/samples/03-workflows/control-flow/edge_condition.py

@@ -16,9 +16,13 @@ from agent_framework import (  # Core chat primitives used to build requests
 )
 from agent_framework.azure import AzureOpenAIResponsesClient  # Thin client wrapper for Azure OpenAI chat models
 from azure.identity import AzureCliCredential  # Uses your az CLI login for credentials
+from dotenv import load_dotenv
 from pydantic import BaseModel  # Structured outputs for safer parsing
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Conditional routing with structured outputs
 

python/samples/03-workflows/control-flow/multi_selection_edge_group.py

@@ -22,9 +22,13 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Multi-Selection Edge Group for email triage and response.
 

python/samples/03-workflows/control-flow/sequential_executors.py

@@ -66,9 +66,7 @@ async def main() -> None:
     reverse_text_executor = ReverseTextExecutor(id="reverse_text_executor")
 
     workflow = (
-        WorkflowBuilder(start_executor=upper_case_executor)
-        .add_edge(upper_case_executor, reverse_text_executor)
-        .build()
+        WorkflowBuilder(start_executor=upper_case_executor).add_edge(upper_case_executor, reverse_text_executor).build()
     )
 
     # Step 2: Stream events for a single input.

python/samples/03-workflows/control-flow/sequential_streaming.py

@@ -55,11 +55,7 @@ async def main():
     """Build a two-step sequential workflow and run it with streaming to observe events."""
     # Step 1: Build the workflow with the defined edges.
     # Order matters. upper_case_executor runs first, then reverse_text_executor.
-    workflow = (
-        WorkflowBuilder(start_executor=to_upper_case)
-        .add_edge(to_upper_case, reverse_text)
-        .build()
-    )
+    workflow = WorkflowBuilder(start_executor=to_upper_case).add_edge(to_upper_case, reverse_text).build()
 
     # Step 2: Run the workflow and stream events in real time.
     async for event in workflow.run("hello world", stream=True):

python/samples/03-workflows/control-flow/simple_loop.py

@@ -18,6 +18,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Simple Loop (with an Agent Judge)

python/samples/03-workflows/control-flow/switch_case_edge_group.py

@@ -20,9 +20,13 @@ from agent_framework import (  # Core chat primitives used to form LLM requests
 )
 from agent_framework.azure import AzureOpenAIResponsesClient  # Thin client for Azure OpenAI chat models
 from azure.identity import AzureCliCredential  # Uses your az CLI login for credentials
+from dotenv import load_dotenv
 from pydantic import BaseModel  # Structured outputs with validation
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Switch-Case Edge Group with an explicit Uncertain branch.
 

python/samples/03-workflows/declarative/customer_support/main.py

@@ -34,11 +34,16 @@ from agent_framework.declarative import (
     WorkflowFactory,
 )
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel, Field
 from ticketing_plugin import TicketingPlugin
 
 logging.basicConfig(level=logging.ERROR)
 
+# Load environment variables from .env file
+load_dotenv()
+
+
 # ANSI color codes for output formatting
 CYAN = "\033[36m"
 GREEN = "\033[32m"
@@ -118,8 +123,6 @@ Assure the user that their issue will be resolved and provide them with a ticket
 
 
 # Pydantic models for structured outputs
-
-
 class SelfServiceResponse(BaseModel):
     """Response from self-service agent evaluation."""
 

python/samples/03-workflows/declarative/deep_research/main.py

@@ -28,10 +28,13 @@ from pathlib import Path
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.declarative import WorkflowFactory
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel, Field
 
-# Agent Instructions
+# Load environment variables from .env file
+load_dotenv()
 
+# Agent Instructions
 RESEARCH_INSTRUCTIONS = """In order to help begin addressing the user request, please answer the following pre-survey to the best of your ability.
 Keep in mind that you are Ken Jennings-level with trivia, and Mensa-level with puzzles, so there should be a deep well to draw from.
 
@@ -92,8 +95,6 @@ WEATHER_INSTRUCTIONS = """You are a weather expert that can provide weather info
 
 
 # Pydantic models for structured outputs
-
-
 class ReasonedAnswer(BaseModel):
     """A response with reasoning and answer."""
 

python/samples/03-workflows/declarative/function_tools/main.py

@@ -15,8 +15,12 @@ from agent_framework import FileCheckpointStorage, tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework_declarative import ExternalInputRequest, ExternalInputResponse, WorkflowFactory
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 TEMP_DIR = Path(__file__).with_suffix("").parent / "tmp" / "checkpoints"
 TEMP_DIR.mkdir(parents=True, exist_ok=True)
 
@@ -39,7 +43,9 @@ MENU_ITEMS = [
 ]
 
 
-# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/02-agents/tools/function_tool_with_approval.py and samples/02-agents/tools/function_tool_with_approval_and_sessions.py.
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production;
+# see samples/02-agents/tools/function_tool_with_approval.py
+# and samples/02-agents/tools/function_tool_with_approval_and_sessions.py.
 @tool(approval_mode="never_require")
 def get_menu() -> list[dict[str, Any]]:
     """Get all menu items."""

python/samples/03-workflows/declarative/marketing/main.py

@@ -19,6 +19,10 @@ from pathlib import Path
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.declarative import WorkflowFactory
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 ANALYST_INSTRUCTIONS = """You are a product analyst. Analyze the given product and identify:
 1. Key features and benefits

python/samples/03-workflows/declarative/student_teacher/main.py

@@ -26,6 +26,10 @@ from pathlib import Path
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.declarative import WorkflowFactory
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 STUDENT_INSTRUCTIONS = """You are a curious math student working on understanding mathematical concepts.
 When given a problem:

python/samples/03-workflows/human-in-the-loop/agents_with_HITL.py

@@ -20,8 +20,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Azure AI Agents in workflow with human feedback
 

python/samples/03-workflows/human-in-the-loop/agents_with_approval_requests.py

@@ -18,8 +18,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Agents in a workflow with AI functions requiring approval
 
@@ -196,12 +200,7 @@ class EmailPreprocessor(Executor):
     @handler
     async def preprocess(self, email: Email, ctx: WorkflowContext[str]) -> None:
         """Preprocess the incoming email."""
-        email_payload = (
-            f"Incoming email:\n"
-            f"From: {email.sender}\n"
-            f"Subject: {email.subject}\n"
-            f"Body: {email.body}"
-        )
+        email_payload = f"Incoming email:\nFrom: {email.sender}\nSubject: {email.subject}\nBody: {email.body}"
         message = email_payload
         if email.sender in self.special_email_addresses:
             note = (

python/samples/03-workflows/human-in-the-loop/agents_with_declaration_only_tools.py

@@ -29,6 +29,10 @@ from typing import Any
 from agent_framework import Content, FunctionTool, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 # A declaration-only tool: the schema is sent to the LLM, but the framework
 # has no implementation to execute. The caller must supply the result.

python/samples/03-workflows/human-in-the-loop/concurrent_request_info.py

@@ -35,6 +35,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import AgentRequestInfoResponse, ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 # Store chat client at module level for aggregator access
 _chat_client: AzureOpenAIResponsesClient | None = None

python/samples/03-workflows/human-in-the-loop/group_chat_request_info.py

@@ -36,11 +36,14 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import AgentRequestInfoResponse, GroupChatBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def process_event_stream(stream: AsyncIterable[WorkflowEvent]) -> dict[str, AgentRequestInfoResponse] | None:
     """Process events from the workflow stream to capture human feedback requests."""
-
     requests: dict[str, AgentExecutorResponse] = {}
     async for event in stream:
         if event.type == "request_info" and isinstance(event.data, AgentExecutorResponse):

python/samples/03-workflows/human-in-the-loop/guessing_game_with_human_input.py

@@ -19,8 +19,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Human in the loop guessing game
 

python/samples/03-workflows/human-in-the-loop/sequential_request_info.py

@@ -35,11 +35,14 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import AgentRequestInfoResponse, SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def process_event_stream(stream: AsyncIterable[WorkflowEvent]) -> dict[str, AgentRequestInfoResponse] | None:
     """Process events from the workflow stream to capture human feedback requests."""
-
     requests: dict[str, AgentExecutorResponse] = {}
     async for event in stream:
         if event.type == "request_info" and isinstance(event.data, AgentExecutorResponse):

python/samples/03-workflows/orchestrations/concurrent_agents.py

@@ -7,6 +7,10 @@ from agent_framework import Message
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Concurrent fan-out/fan-in (agent-only API) with default aggregator

python/samples/03-workflows/orchestrations/concurrent_custom_agent_executors.py

@@ -15,6 +15,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Concurrent Orchestration with Custom Agent Executors

python/samples/03-workflows/orchestrations/concurrent_custom_aggregator.py

@@ -7,6 +7,10 @@ from agent_framework import Message
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Concurrent Orchestration with Custom Aggregator
@@ -86,9 +90,7 @@ async def main() -> None:
     #   • Default aggregator -> returns list[Message] (one user + one assistant per agent)
     #   • Custom callback    -> return value becomes workflow output (string here)
     #   The callback can be sync or async; it receives list[AgentExecutorResponse].
-    workflow = (
-        ConcurrentBuilder(participants=[researcher, marketer, legal]).with_aggregator(summarize_results).build()
-    )
+    workflow = ConcurrentBuilder(participants=[researcher, marketer, legal]).with_aggregator(summarize_results).build()
 
     events = await workflow.run("We are launching a new budget-friendly electric bike for urban commuters.")
     outputs = events.get_outputs()

python/samples/03-workflows/orchestrations/group_chat_agent_manager.py

@@ -11,6 +11,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import GroupChatBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Group Chat with Agent-Based Manager

python/samples/03-workflows/orchestrations/group_chat_philosophical_debate.py

@@ -12,6 +12,7 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import GroupChatBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 
 logging.basicConfig(level=logging.WARNING)
 
@@ -40,6 +41,9 @@ Prerequisites:
 - OpenAI environment variables configured for OpenAIChatClient
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 def _get_chat_client() -> AzureOpenAIChatClient:
     return AzureOpenAIChatClient(credential=AzureCliCredential())

python/samples/03-workflows/orchestrations/group_chat_simple_selector.py

@@ -11,6 +11,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import GroupChatBuilder, GroupChatState
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Group Chat with a round-robin speaker selector

python/samples/03-workflows/orchestrations/handoff_autonomous.py

@@ -13,6 +13,7 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import HandoffBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 
 logging.basicConfig(level=logging.ERROR)
 
@@ -35,6 +36,9 @@ Key Concepts:
     - Turn limits: use `.with_autonomous_mode(turn_limits={agent_name: N})` to cap iterations per agent
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 def create_agents(
     client: AzureOpenAIChatClient,

python/samples/03-workflows/orchestrations/handoff_simple.py

@@ -14,6 +14,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import HandoffAgentUserRequest, HandoffBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """Sample: Simple handoff workflow.
 

python/samples/03-workflows/orchestrations/handoff_with_code_interpreter_file.py

@@ -31,6 +31,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import HandoffAgentUserRequest, HandoffBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def _drain(stream: AsyncIterable[WorkflowEvent]) -> list[WorkflowEvent]:

python/samples/03-workflows/orchestrations/handoff_with_tool_approval_checkpoint_resume.py

@@ -17,6 +17,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import HandoffAgentUserRequest, HandoffBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Handoff Workflow with Tool Approvals + Checkpoint Resume

python/samples/03-workflows/orchestrations/magentic.py

@@ -13,6 +13,7 @@ from agent_framework import (
 )
 from agent_framework.openai import OpenAIChatClient, OpenAIResponsesClient
 from agent_framework.orchestrations import GroupChatRequestSentEvent, MagenticBuilder, MagenticProgressLedger
+from dotenv import load_dotenv
 
 logging.basicConfig(level=logging.WARNING)
 logger = logging.getLogger(__name__)
@@ -42,6 +43,9 @@ Prerequisites:
 - OpenAI credentials configured for `OpenAIChatClient` and `OpenAIResponsesClient`.
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 async def main() -> None:
     researcher_agent = Agent(

python/samples/03-workflows/orchestrations/magentic_checkpoint.py

@@ -17,6 +17,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import MagenticBuilder, MagenticPlanReviewRequest
 from azure.identity._credentials import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Magentic Orchestration + Checkpointing

python/samples/03-workflows/orchestrations/magentic_human_plan_review.py

@@ -13,6 +13,10 @@ from agent_framework import (
 )
 from agent_framework.openai import OpenAIChatClient
 from agent_framework.orchestrations import MagenticBuilder, MagenticPlanReviewRequest, MagenticPlanReviewResponse
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Magentic Orchestration with Human Plan Review

python/samples/03-workflows/orchestrations/sequential_agents.py

@@ -7,6 +7,10 @@ from agent_framework import Message
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Sequential workflow (agent-focused API) with shared conversation context

python/samples/03-workflows/orchestrations/sequential_custom_executors.py

@@ -13,6 +13,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Sequential workflow mixing agents and a custom summarizer executor

python/samples/03-workflows/parallelism/fan_out_fan_in_edges.py

@@ -17,8 +17,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential  # Uses your az CLI login for credentials
+from dotenv import load_dotenv
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Concurrent fan out and fan in with three domain agents
 

python/samples/03-workflows/state-management/state_with_agents.py

@@ -18,9 +18,13 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Workflow state with agents and conditional routing.
 

python/samples/03-workflows/state-management/workflow_kwargs.py

@@ -9,8 +9,12 @@ from agent_framework import Message, tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Workflow kwargs Flow to @tool Tools
 

python/samples/03-workflows/tool-approval/concurrent_builder_tool_approval.py

@@ -14,6 +14,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Concurrent Workflow with Tool Approval Requests

python/samples/03-workflows/tool-approval/group_chat_builder_tool_approval.py

@@ -14,6 +14,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import GroupChatBuilder, GroupChatState
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Group Chat Workflow with Tool Approval Requests

python/samples/03-workflows/tool-approval/sequential_builder_tool_approval.py

@@ -14,6 +14,10 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.orchestrations import SequentialBuilder
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Sample: Sequential Workflow with Tool Approval Requests

python/samples/03-workflows/visualization/concurrent_with_visualization.py

@@ -17,8 +17,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Sample: Concurrent (Fan-out/Fan-in) with Agents + Visualization