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/packages/redis/README.md

@@ -30,7 +30,7 @@ The `RedisChatMessageStore` provides persistent conversation storage using Redis
 
 #### Basic Usage Examples
 
-See the complete [Redis history provider examples](../../samples/02-agents/conversations/redis_chat_message_store_session.py) including:
+See the complete [Redis history provider examples](../../samples/02-agents/conversations/redis_history_provider.py) including:
 - User session management
 - Conversation persistence across restarts
 - Session serialization and deserialization

python/samples/01-get-started/01_hello_agent.py

@@ -5,6 +5,10 @@ import os
 
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Hello Agent — Simplest possible agent

python/samples/01-get-started/02_add_tools.py

@@ -8,8 +8,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Add Tools — Give your agent a function tool
 

python/samples/01-get-started/03_multi_turn.py

@@ -5,6 +5,10 @@ import os
 
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Multi-Turn Conversations — Use AgentSession to maintain context

python/samples/01-get-started/04_memory.py

@@ -7,6 +7,10 @@ from typing import Any
 from agent_framework._sessions import AgentSession, BaseContextProvider, SessionContext
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Agent Memory with Context Providers

python/samples/01-get-started/05_first_workflow.py

@@ -44,11 +44,7 @@ async def reverse_text(text: str, ctx: WorkflowContext[Never, str]) -> None:
 def create_workflow():
     """Build the workflow: UpperCase → reverse_text."""
     upper = UpperCase(id="upper_case")
-    return (
-        WorkflowBuilder(start_executor=upper)
-        .add_edge(upper, reverse_text)
-        .build()
-    )
+    return WorkflowBuilder(start_executor=upper).add_edge(upper, reverse_text).build()
 # </create_workflow>
 
 

python/samples/01-get-started/06_host_your_agent.py

@@ -1,5 +1,14 @@
 # Copyright (c) Microsoft. All rights reserved.
 
+from typing import Any
+
+from agent_framework.azure import AgentFunctionApp, AzureOpenAIChatClient
+from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
+
 """Host your agent with Azure Functions.
 
 This sample shows the Python hosting pattern used in docs:
@@ -15,11 +24,6 @@ Environment variables:
   AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
 """
 
-from typing import Any
-
-from agent_framework.azure import AgentFunctionApp, AzureOpenAIChatClient
-from azure.identity import AzureCliCredential
-
 
 # <create_agent>
 def _create_agent() -> Any:
@@ -28,8 +32,6 @@ def _create_agent() -> Any:
         name="HostedAgent",
         instructions="You are a helpful assistant hosted in Azure Functions.",
     )
-
-
 # </create_agent>
 
 # <host_agent>

python/samples/02-agents/background_responses.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework import Agent
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """Background Responses Sample.
 

python/samples/02-agents/chat_client/built_in_chat_clients.py

@@ -13,8 +13,12 @@ from agent_framework.azure import (
 from agent_framework.openai import OpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from azure.identity.aio import AzureCliCredential as AsyncAzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Built-in Chat Clients Example
 

python/samples/02-agents/chat_client/chat_response_cancellation.py

@@ -3,6 +3,10 @@
 import asyncio
 
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Chat Response Cancellation Example

python/samples/02-agents/context_providers/mem0/mem0_basic.py

@@ -7,9 +7,15 @@ from agent_framework import tool
 from agent_framework.azure import AzureAIAgentClient
 from agent_framework.mem0 import Mem0ContextProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
-# 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 retrieve_company_report(company_code: str, detailed: bool) -> str:
     if company_code != "CNTS":
@@ -24,6 +30,7 @@ def retrieve_company_report(company_code: str, detailed: bool) -> str:
 
 async def main() -> None:
     """Example of memory usage with Mem0 context provider."""
+
     print("=== Mem0 Context Provider Example ===")
 
     # Each record in Mem0 should be associated with agent_id or user_id or application_id or thread_id.

python/samples/02-agents/context_providers/mem0/mem0_oss.py

@@ -7,11 +7,15 @@ from agent_framework import tool
 from agent_framework.azure import AzureAIAgentClient
 from agent_framework.mem0 import Mem0ContextProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from mem0 import AsyncMemory
 
+# Load environment variables from .env file
+load_dotenv()
 
-# NOTE: approval_mode="never_require" is for sample brevity.
-# Use "always_require" in production; see samples/02-agents/tools/function_tool_with_approval.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 retrieve_company_report(company_code: str, detailed: bool) -> str:
@@ -27,6 +31,7 @@ def retrieve_company_report(company_code: str, detailed: bool) -> str:
 
 async def main() -> None:
     """Example of memory usage with local Mem0 OSS context provider."""
+
     print("=== Mem0 Context Provider Example ===")
 
     # Each record in Mem0 should be associated with agent_id or user_id or application_id or thread_id.

python/samples/02-agents/context_providers/mem0/mem0_sessions.py

@@ -7,12 +7,19 @@ from agent_framework import tool
 from agent_framework.azure import AzureAIAgentClient
 from agent_framework.mem0 import Mem0ContextProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
-# 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_user_preferences(user_id: str) -> str:
     """Mock function to get user preferences."""
+
     preferences = {
         "user123": "Prefers concise responses and technical details",
         "user456": "Likes detailed explanations with examples",

python/samples/02-agents/context_providers/redis/azure_redis_conversation.py

@@ -25,8 +25,12 @@ from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.redis import RedisHistoryProvider
 from azure.identity import AzureCliCredential
 from azure.identity.aio import AzureCliCredential as AsyncAzureCliCredential
+from dotenv import load_dotenv
 from redis.credentials import CredentialProvider
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 class AzureCredentialProvider(CredentialProvider):
     """Credential provider for Azure AD authentication with Redis Enterprise."""

python/samples/02-agents/context_providers/redis/redis_basics.py

@@ -34,9 +34,13 @@ from agent_framework import Message, tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.redis import RedisContextProvider
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from redisvl.extensions.cache.embeddings import EmbeddingsCache
 from redisvl.utils.vectorize import OpenAITextVectorizer
 
+# Load environment variables from .env file
+load_dotenv()
+
 # Default Redis URL for local Redis Stack.
 # Override via the REDIS_URL environment variable for remote or authenticated instances.
 REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379")

python/samples/02-agents/context_providers/redis/redis_conversation.py

@@ -5,6 +5,10 @@
 This example demonstrates how to use the Redis context provider to persist
 conversational details. Pass it as a constructor argument to create_agent.
 
+Note: For session history persistence, see RedisHistoryProvider in the
+conversations/redis_history_provider.py sample. RedisContextProvider is for
+AI context (RAG, memories), while RedisHistoryProvider stores message history.
+
 Requirements:
   - A Redis instance with RediSearch enabled (e.g., Redis Stack)
   - agent-framework with the Redis extra installed: pip install "agent-framework-redis"
@@ -17,12 +21,17 @@ Run:
 import asyncio
 import os
 
+from agent_framework import AgentSession
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.redis import RedisContextProvider
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from redisvl.extensions.cache.embeddings import EmbeddingsCache
 from redisvl.utils.vectorize import OpenAITextVectorizer
 
+# Load environment variables from .env file
+load_dotenv()
+
 # Default Redis URL for local Redis Stack.
 # Override via the REDIS_URL environment variable for remote or authenticated instances.
 REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379")
@@ -73,35 +82,38 @@ async def main() -> None:
         context_providers=[provider],
     )
 
+    # Create a session to manage conversation state
+    session = agent.create_session()
+
     # Teach a user preference; the agent writes this to the provider's memory
     query = "Remember that I enjoy gumbo"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
 
     # Ask the agent to recall the stored preference; it should retrieve from memory
     query = "What do I enjoy?"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
 
     query = "What did I say to you just now?"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
 
     query = "Remember that I have a meeting at 3pm tomorro"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
 
     query = "Tulips are red"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
 
     query = "What was the first thing I said to you this conversation?"
-    result = await agent.run(query)
+    result = await agent.run(query, session=session)
     print("User: ", query)
     print("Agent: ", result)
     # Drop / delete the provider index in Redis

python/samples/02-agents/context_providers/redis/redis_sessions.py

@@ -32,17 +32,20 @@ import os
 from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.redis import RedisContextProvider
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from redisvl.extensions.cache.embeddings import EmbeddingsCache
 from redisvl.utils.vectorize import OpenAITextVectorizer
 
+# Load environment variables from .env file
+load_dotenv()
+
 # Default Redis URL for local Redis Stack.
 # Override via the REDIS_URL environment variable for remote or authenticated instances.
 REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379")
 
+
 # Please set OPENAI_API_KEY to use the OpenAI vectorizer.
 # For chat responses, also set AZURE_AI_PROJECT_ENDPOINT and AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME.
-
-
 def create_chat_client() -> AzureOpenAIResponsesClient:
     """Create an Azure OpenAI Responses client using a Foundry project endpoint."""
     return AzureOpenAIResponsesClient(

python/samples/02-agents/context_providers/simple_context_provider.py

@@ -8,8 +8,12 @@ from typing import Any
 from agent_framework import Agent, AgentSession, BaseContextProvider, SessionContext, SupportsChatGetResponse
 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()
+
 
 class UserInfo(BaseModel):
     name: str | None = None

python/samples/02-agents/conversations/custom_history_provider.py

@@ -6,6 +6,10 @@ from typing import Any
 
 from agent_framework import AgentSession, BaseHistoryProvider, Message
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Custom History Provider Example

python/samples/02-agents/conversations/redis_history_provider.py

@@ -7,6 +7,10 @@ from uuid import uuid4
 from agent_framework import AgentSession
 from agent_framework.openai import OpenAIChatClient
 from agent_framework.redis import RedisHistoryProvider
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Redis History Provider Session Example
@@ -16,6 +20,7 @@ management, enabling persistent conversation history storage across sessions
 with Redis as the backend data store.
 """
 
+
 # Default Redis URL for local Redis Stack.
 # Override via the REDIS_URL environment variable for remote or authenticated instances.
 REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379")

python/samples/02-agents/conversations/suspend_resume_session.py

@@ -6,6 +6,10 @@ from agent_framework import AgentSession
 from agent_framework.azure import AzureAIAgentClient
 from agent_framework.openai import OpenAIChatClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Session Suspend and Resume Example

python/samples/02-agents/declarative/azure_openai_responses_agent.py

@@ -4,6 +4,10 @@ from pathlib import Path
 
 from agent_framework.declarative import AgentFactory
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def main():

python/samples/02-agents/declarative/get_weather_agent.py

@@ -9,11 +9,13 @@ from agent_framework.declarative import AgentFactory
 from azure.identity import AzureCliCredential
 from dotenv import load_dotenv
 
+# Load environment variables from .env file
 load_dotenv()
 
 
 def get_weather(location: str, unit: Literal["celsius", "fahrenheit"] = "celsius") -> str:
     """A simple function tool to get weather information."""
+
     return f"The weather in {location} is {randint(-10, 30) if unit == 'celsius' else randint(30, 100)} degrees {unit}."
 
 

python/samples/02-agents/declarative/inline_yaml.py

@@ -5,6 +5,7 @@ from agent_framework.declarative import AgentFactory
 from azure.identity.aio import AzureCliCredential
 from dotenv import load_dotenv
 
+# Load environment variables from .env file
 load_dotenv()
 
 """
@@ -37,7 +38,9 @@ model:
     # create the agent from the yaml
     async with (
         AzureCliCredential() as credential,
-        AgentFactory(client_kwargs={"credential": credential}, safe_mode=False).create_agent_from_yaml(yaml_definition) as agent,
+        AgentFactory(client_kwargs={"credential": credential}, safe_mode=False).create_agent_from_yaml(
+            yaml_definition
+        ) as agent,
     ):
         response = await agent.run("What can you do for me?")
         print("Agent response:", response.text)

python/samples/02-agents/declarative/mcp_tool_yaml.py

@@ -28,6 +28,7 @@ import asyncio
 from agent_framework.declarative import AgentFactory
 from dotenv import load_dotenv
 
+# Load environment variables from .env file
 load_dotenv()
 
 # Example 1: OpenAI.Responses with API key authentication

python/samples/02-agents/declarative/microsoft_learn_agent.py

@@ -6,11 +6,13 @@ from agent_framework.declarative import AgentFactory
 from azure.identity.aio import AzureCliCredential
 from dotenv import load_dotenv
 
+# Load environment variables from .env file
 load_dotenv()
 
 
 async def main():
     """Create an agent from a declarative yaml specification and run it."""
+
     # get the path
     current_path = Path(__file__).parent
     yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "foundry" / "MicrosoftLearnAgent.yaml"
@@ -18,7 +20,9 @@ async def main():
     # create the agent from the yaml
     async with (
         AzureCliCredential() as credential,
-        AgentFactory(client_kwargs={"credential": credential}, safe_mode=False).create_agent_from_yaml_path(yaml_path) as agent,
+        AgentFactory(client_kwargs={"credential": credential}, safe_mode=False).create_agent_from_yaml_path(
+            yaml_path
+        ) as agent,
     ):
         response = await agent.run("How do I create a storage account with private endpoint using bicep?")
         print("Agent response:", response.text)

python/samples/02-agents/declarative/openai_responses_agent.py

@@ -5,11 +5,13 @@ from pathlib import Path
 from agent_framework.declarative import AgentFactory
 from dotenv import load_dotenv
 
+# Load environment variables from .env file
 load_dotenv()
 
 
 async def main():
     """Create an agent from a declarative yaml specification and run it."""
+
     # get the path
     current_path = Path(__file__).parent
     yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "openai" / "OpenAIResponses.yaml"

python/samples/02-agents/devui/azure_responses_agent/agent.py

@@ -23,6 +23,10 @@ from typing import Annotated
 
 from agent_framework import Agent, tool
 from agent_framework.azure import AzureOpenAIResponsesClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 logger = logging.getLogger(__name__)
 

python/samples/02-agents/devui/foundry_agent/agent.py

@@ -11,10 +11,16 @@ from typing import Annotated
 from agent_framework import Agent, tool
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/devui/in_memory_mode.py

@@ -13,12 +13,16 @@ from typing import Annotated
 from agent_framework import Agent, Executor, WorkflowBuilder, WorkflowContext, handler, tool
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.devui import serve
+from dotenv import load_dotenv
 from typing_extensions import Never
 
+# Load environment variables from .env file
+load_dotenv()
 
-# 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")
-# Tool functions for the agent
+
+# 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_weather(
     location: Annotated[str, "The location to get the weather for."],

python/samples/02-agents/devui/weather_agent_azure/agent.py

@@ -16,19 +16,23 @@ from agent_framework import (
     Message,
     MiddlewareTermination,
     ResponseStream,
-    Role,
     chat_middleware,
     function_middleware,
     tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework_devui import register_cleanup
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 logger = logging.getLogger(__name__)
 
 
 def cleanup_resources():
     """Cleanup function that runs when DevUI shuts down."""
+
     logger.info("=" * 60)
     logger.info(" Cleaning up resources...")
     logger.info("   (In production, this would close credentials, sessions, etc.)")
@@ -45,7 +49,7 @@ async def security_filter_middleware(
 
     # Check only the last message (most recent user input)
     last_message = context.messages[-1] if context.messages else None
-    if last_message and last_message.role == Role.USER and last_message.text:
+    if last_message and last_message.role == "user" and last_message.text:
         message_lower = last_message.text.lower()
         for term in blocked_terms:
             if term in message_lower:
@@ -60,19 +64,17 @@ async def security_filter_middleware(
                     async def blocked_stream(msg: str = error_message) -> AsyncIterable[ChatResponseUpdate]:
                         yield ChatResponseUpdate(
                             contents=[Content.from_text(text=msg)],
-                            role=Role.ASSISTANT,
+                            role="assistant",
                         )
 
-                    response = ChatResponse(
-                        messages=[Message(role=Role.ASSISTANT, text=error_message)]
-                    )
+                    response = ChatResponse(messages=[Message(role="assistant", text=error_message)])
                     context.result = ResponseStream(blocked_stream(), finalizer=lambda _, r=response: r)
                 else:
                     # Non-streaming mode: return complete response
                     context.result = ChatResponse(
                         messages=[
                             Message(
-                                role=Role.ASSISTANT,
+                                role="assistant",
                                 text=error_message,
                             )
                         ]
@@ -101,7 +103,9 @@ async def atlantis_location_filter_middleware(
     await call_next()
 
 
-# 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_weather(
     location: Annotated[str, "The location to get the weather for."],

python/samples/02-agents/devui/workflow_agents/workflow.py

@@ -19,8 +19,12 @@ from typing import Any
 
 from agent_framework import AgentExecutorResponse, WorkflowBuilder
 from agent_framework.azure import AzureOpenAIChatClient
+from dotenv import load_dotenv
 from pydantic import BaseModel
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 # Define structured output for review results
 class ReviewResult(BaseModel):

python/samples/02-agents/mcp/agent_as_mcp_server.py

@@ -5,6 +5,10 @@ from typing import Annotated, Any
 import anyio
 from agent_framework import tool
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 This sample demonstrates how to expose an Agent as an MCP server.

python/samples/02-agents/mcp/mcp_api_key_auth.py

@@ -5,8 +5,12 @@ import os
 
 from agent_framework import Agent, MCPStreamableHTTPTool
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
 from httpx import AsyncClient
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 MCP Authentication Example
 

python/samples/02-agents/middleware/agent_and_run_level_middleware.py

@@ -15,8 +15,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Agent-Level and Run-Level MiddlewareTypes Example
 
@@ -54,7 +58,9 @@ Agent Middleware Execution Order:
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/chat_middleware.py

@@ -16,8 +16,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Chat MiddlewareTypes Example
 
@@ -37,7 +41,9 @@ The example covers:
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/class_based_middleware.py

@@ -17,8 +17,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Class-based MiddlewareTypes Example
 
@@ -34,7 +38,9 @@ from object-oriented design patterns.
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/decorator_middleware.py

@@ -10,6 +10,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Decorator MiddlewareTypes Example
@@ -42,7 +46,9 @@ Key benefits of decorator approach:
 """
 
 
-# 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_current_time() -> str:
     """Get the current time."""

python/samples/02-agents/middleware/exception_handling_with_middleware.py

@@ -7,8 +7,12 @@ from typing import Annotated
 from agent_framework import FunctionInvocationContext, tool
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Exception Handling with MiddlewareTypes
 
@@ -24,7 +28,9 @@ a helpful message for the user, preventing raw exceptions from reaching the end
 """
 
 
-# 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 unstable_data_service(
     query: Annotated[str, Field(description="The data query to execute.")],

python/samples/02-agents/middleware/function_based_middleware.py

@@ -13,8 +13,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Function-based MiddlewareTypes Example
 
@@ -31,7 +35,9 @@ can be implemented as async functions that accept context and call_next paramete
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/middleware_termination.py

@@ -15,8 +15,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 MiddlewareTypes Termination Example
 
@@ -30,7 +34,9 @@ This is useful for implementing security checks, rate limiting, or early exit co
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/override_result_with_middleware.py

@@ -19,8 +19,12 @@ from agent_framework import (
     tool,
 )
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Result Override with MiddlewareTypes (Regular and Streaming)
 
@@ -39,7 +43,9 @@ it creates a custom async generator that yields the override message in chunks.
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/runtime_context_delegation.py

@@ -6,8 +6,12 @@ from typing import Annotated
 
 from agent_framework import FunctionInvocationContext, function_middleware, tool
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Runtime Context Delegation Patterns
 
@@ -285,9 +289,7 @@ async def pattern_2_hierarchical_with_kwargs_propagation() -> None:
         await call_next()
 
     @function_middleware
-    async def sms_kwargs_tracker(
-        context: FunctionInvocationContext, call_next: Callable[[], Awaitable[None]]
-    ) -> None:
+    async def sms_kwargs_tracker(context: FunctionInvocationContext, call_next: Callable[[], Awaitable[None]]) -> None:
         sms_agent_kwargs.update(context.kwargs)
         print(f"[SMSAgent] Received runtime context: {list(context.kwargs.keys())}")
         await call_next()

python/samples/02-agents/middleware/session_behavior_middleware.py

@@ -11,8 +11,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Thread Behavior MiddlewareTypes Example
 
@@ -32,7 +36,9 @@ Key behaviors demonstrated:
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/middleware/shared_state_middleware.py

@@ -11,8 +11,12 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Shared State Function-based MiddlewareTypes Example
 
@@ -27,7 +31,9 @@ This approach shows how middleware can work together by sharing state within the
 """
 
 
-# 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_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/02-agents/multimodal_input/azure_chat_multimodal.py

@@ -5,6 +5,10 @@ import asyncio
 from agent_framework import Content, Message
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 def create_sample_image() -> str:

python/samples/02-agents/multimodal_input/azure_responses_multimodal.py

@@ -6,6 +6,10 @@ from pathlib import Path
 from agent_framework import Content, Message
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 ASSETS_DIR = Path(__file__).resolve().parents[2] / "shared" / "sample_assets"
 

python/samples/02-agents/multimodal_input/openai_chat_multimodal.py

@@ -7,6 +7,10 @@ from pathlib import Path
 
 from agent_framework import Content, Message
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 ASSETS_DIR = Path(__file__).resolve().parents[2] / "shared" / "sample_assets"
 

python/samples/02-agents/observability/advanced_manual_setup_console_output.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework import Message, tool
 from agent_framework.observability import enable_instrumentation
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
 from opentelemetry._logs import set_logger_provider
 from opentelemetry.metrics import set_meter_provider
 from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
@@ -21,6 +22,9 @@ from opentelemetry.semconv._incubating.attributes.service_attributes import SERV
 from opentelemetry.trace import set_tracer_provider
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 This sample shows how to manually configure to send traces, logs, and metrics to the console,
 without using the `configure_otel_providers` helper function.

python/samples/02-agents/observability/advanced_zero_code.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING, Annotated
 from agent_framework import Message, tool
 from agent_framework.observability import get_tracer
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
 from opentelemetry.trace import SpanKind
 from opentelemetry.trace.span import format_trace_id
 from pydantic import Field
@@ -40,6 +41,9 @@ You can also set the environment variables instead of passing them as CLI argume
 
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 
 # NOTE: approval_mode="never_require" is for sample brevity.
 # Use "always_require" in production; see samples/02-agents/tools/function_tool_with_approval.py

python/samples/02-agents/observability/agent_observability.py

@@ -7,10 +7,14 @@ from typing import Annotated
 from agent_framework import Agent, tool
 from agent_framework.observability import configure_otel_providers, get_tracer
 from agent_framework.openai import OpenAIChatClient
+from dotenv import load_dotenv
 from opentelemetry.trace import SpanKind
 from opentelemetry.trace.span import format_trace_id
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 This sample shows how you can observe an agent in Agent Framework by using the
 same observability setup function.

python/samples/02-agents/observability/configure_otel_providers_with_env_var.py

@@ -9,6 +9,7 @@ from typing import TYPE_CHECKING, Annotated, Literal
 from agent_framework import Message, tool
 from agent_framework.observability import configure_otel_providers, get_tracer
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
 from opentelemetry import trace
 from opentelemetry.trace.span import format_trace_id
 from pydantic import Field
@@ -27,6 +28,9 @@ If no OTLP endpoint or Application Insights connection string is configured, the
 output traces, logs, and metrics to the console.
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 # Define the scenarios that can be run to show the telemetry data collected by the SDK
 SCENARIOS = ["client", "client_stream", "tool", "all"]
 

python/samples/02-agents/observability/configure_otel_providers_with_parameters.py

@@ -10,6 +10,7 @@ from typing import TYPE_CHECKING, Annotated, Literal
 from agent_framework import Message, tool
 from agent_framework.observability import configure_otel_providers, get_tracer
 from agent_framework.openai import OpenAIResponsesClient
+from dotenv import load_dotenv
 from opentelemetry import trace
 from opentelemetry.trace.span import format_trace_id
 from pydantic import Field
@@ -28,6 +29,9 @@ For standard OTLP setup, it's recommended to use environment variables (see conf
 Use this approach when you need custom exporter configuration beyond what environment variables provide.
 """
 
+# Load environment variables from .env file
+load_dotenv()
+
 # Define the scenarios that can be run to show the telemetry data collected by the SDK
 SCENARIOS = ["client", "client_stream", "tool", "all"]
 

python/samples/02-agents/observability/workflow_observability.py

@@ -80,9 +80,7 @@ async def run_sequential_workflow() -> None:
 
     # Step 2: Build the workflow with the defined edges.
     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 3: Run the workflow with an initial message.

python/samples/02-agents/providers/amazon/bedrock_chat_client.py

@@ -5,8 +5,12 @@ from typing import Annotated
 
 from agent_framework import Agent, tool
 from agent_framework.amazon import BedrockChatClient
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Bedrock Chat Client Example
 

python/samples/02-agents/providers/anthropic/anthropic_advanced.py

@@ -3,6 +3,10 @@
 import asyncio
 
 from agent_framework.anthropic import AnthropicChatOptions, AnthropicClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Anthropic Chat Agent Example

python/samples/02-agents/providers/anthropic/anthropic_basic.py

@@ -6,6 +6,10 @@ from typing import Annotated
 
 from agent_framework import tool
 from agent_framework.anthropic import AnthropicClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Anthropic Chat Agent Example
@@ -14,7 +18,9 @@ This sample demonstrates using Anthropic with an agent and a single custom tool.
 """
 
 
-# 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_weather(
     location: Annotated[str, "The location to get the weather for."],
@@ -28,8 +34,7 @@ async def non_streaming_example() -> None:
     """Example of non-streaming response (get the complete result at once)."""
     print("=== Non-streaming Response Example ===")
 
-    agent = AnthropicClient(
-    ).as_agent(
+    agent = AnthropicClient().as_agent(
         name="WeatherAgent",
         instructions="You are a helpful weather agent.",
         tools=get_weather,
@@ -45,8 +50,7 @@ async def streaming_example() -> None:
     """Example of streaming response (get results as they are generated)."""
     print("=== Streaming Response Example ===")
 
-    agent = AnthropicClient(
-    ).as_agent(
+    agent = AnthropicClient().as_agent(
         name="WeatherAgent",
         instructions="You are a helpful weather agent.",
         tools=get_weather,

python/samples/02-agents/providers/anthropic/anthropic_claude_basic.py

@@ -20,6 +20,10 @@ from typing import Annotated
 
 from agent_framework import tool
 from agent_framework.anthropic import ClaudeAgent
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 @tool

python/samples/02-agents/providers/anthropic/anthropic_claude_with_mcp.py

@@ -21,6 +21,10 @@ from typing import Any
 
 from agent_framework.anthropic import ClaudeAgent
 from claude_agent_sdk import PermissionResultAllow, PermissionResultDeny
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 
 async def prompt_permission(

python/samples/02-agents/providers/anthropic/anthropic_foundry.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework.anthropic import AnthropicClient
 from anthropic import AsyncAnthropicFoundry
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Anthropic Foundry Chat Agent Example

python/samples/02-agents/providers/anthropic/anthropic_skills.py

@@ -6,6 +6,10 @@ from pathlib import Path
 
 from agent_framework import Content
 from agent_framework.anthropic import AnthropicChatOptions, AnthropicClient
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 logger = logging.getLogger(__name__)
 """

python/samples/02-agents/providers/azure_ai/azure_ai_basic.py

@@ -7,8 +7,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Basic Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_provider_methods.py

@@ -10,8 +10,12 @@ from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.ai.projects.models import AgentReference, PromptAgentDefinition
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Project Agent Provider Methods Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_use_latest_version.py

@@ -7,8 +7,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Latest Version Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_agent_as_tool.py

@@ -6,6 +6,10 @@ from collections.abc import Awaitable, Callable
 from agent_framework import FunctionInvocationContext
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent-as-Tool Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_agent_to_agent.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Agent-to-Agent (A2A) Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_application_endpoint.py

@@ -7,6 +7,10 @@ from agent_framework import Agent
 from agent_framework.azure import AzureAIClient
 from azure.ai.projects.aio import AIProjectClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Application Endpoint Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_azure_ai_search.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Azure AI Search Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_bing_custom_search.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Bing Custom Search Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_bing_grounding.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Bing Grounding Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_browser_automation.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Browser Automation Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_code_interpreter.py

@@ -5,9 +5,13 @@ import asyncio
 from agent_framework import ChatResponse
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from openai.types.responses.response import Response as OpenAIResponse
 from openai.types.responses.response_code_interpreter_tool_call import ResponseCodeInterpreterToolCall
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Code Interpreter Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_code_interpreter_file_download.py

@@ -12,6 +12,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI V2 Code Interpreter File Download Sample

python/samples/02-agents/providers/azure_ai/azure_ai_with_code_interpreter_file_generation.py

@@ -7,6 +7,10 @@ from agent_framework import (
 )
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI V2 Code Interpreter File Generation Sample

python/samples/02-agents/providers/azure_ai/azure_ai_with_content_filtering.py

@@ -5,6 +5,10 @@ import asyncio
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.models import RaiConfig
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Content Filtering (RAI Policy) Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_existing_agent.py

@@ -7,6 +7,10 @@ from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.ai.projects.models import PromptAgentDefinition
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Existing Agent Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_existing_conversation.py

@@ -8,8 +8,12 @@ from agent_framework import tool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Existing Conversation Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_explicit_settings.py

@@ -8,8 +8,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent with Explicit Settings Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_file_search.py

@@ -8,6 +8,10 @@ from pathlib import Path
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 The following sample demonstrates how to create a simple, Azure AI agent that

python/samples/02-agents/providers/azure_ai/azure_ai_with_hosted_mcp.py

@@ -6,6 +6,10 @@ from typing import Any
 from agent_framework import AgentResponse, AgentSession, Message, SupportsAgentRun
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Hosted MCP Example
@@ -35,7 +39,9 @@ async def handle_approvals_without_session(query: str, agent: "SupportsAgentRun"
     return result
 
 
-async def handle_approvals_with_session(query: str, agent: "SupportsAgentRun", session: "AgentSession") -> AgentResponse:
+async def handle_approvals_with_session(
+    query: str, agent: "SupportsAgentRun", session: "AgentSession"
+) -> AgentResponse:
     """Here we let the session deal with the previous responses, and we just rerun with the approval."""
 
     result = await agent.run(query, session=session)

python/samples/02-agents/providers/azure_ai/azure_ai_with_image_generation.py

@@ -7,6 +7,10 @@ from urllib import request as urllib_request
 
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Image Generation Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_local_mcp.py

@@ -5,6 +5,10 @@ import asyncio
 from agent_framework import MCPStreamableHTTPTool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Local MCP Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_memory_search.py

@@ -7,6 +7,10 @@ from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.ai.projects.models import MemoryStoreDefaultDefinition, MemoryStoreDefaultOptions
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Memory Search Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_microsoft_fabric.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Microsoft Fabric Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_openapi.py

@@ -5,6 +5,10 @@ from pathlib import Path
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with OpenAPI Tool Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_reasoning.py

@@ -5,6 +5,10 @@ import asyncio
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.models import Reasoning
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Reasoning Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_response_format.py

@@ -4,8 +4,12 @@ import asyncio
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import BaseModel, ConfigDict
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Response Format Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_runtime_json_schema.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent Response Format Example with Runtime JSON Schema

python/samples/02-agents/providers/azure_ai/azure_ai_with_session.py

@@ -7,8 +7,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent with Session Management Example
 

python/samples/02-agents/providers/azure_ai/azure_ai_with_sharepoint.py

@@ -4,6 +4,10 @@ import os
 
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with SharePoint Example

python/samples/02-agents/providers/azure_ai/azure_ai_with_web_search.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework.azure import AzureAIClient, AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent With Web Search

python/samples/02-agents/providers/azure_ai_agent/azure_ai_basic.py

@@ -7,8 +7,12 @@ from typing import Annotated
 from agent_framework import tool
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Basic Example
 

python/samples/02-agents/providers/azure_ai_agent/azure_ai_provider_methods.py

@@ -9,8 +9,12 @@ from agent_framework import tool
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 """
 Azure AI Agent Provider Methods Example
 

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_azure_ai_search.py

@@ -9,6 +9,10 @@ from azure.ai.agents.aio import AgentsClient
 from azure.ai.projects.aio import AIProjectClient
 from azure.ai.projects.models import ConnectionType
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Azure AI Search Example

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_bing_custom_search.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework.azure import AzureAIAgentClient, AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 The following sample demonstrates how to create an Azure AI agent that

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_bing_grounding.py

@@ -4,6 +4,10 @@ import asyncio
 
 from agent_framework.azure import AzureAIAgentClient, AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 The following sample demonstrates how to create an Azure AI agent that

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_bing_grounding_citations.py

@@ -5,6 +5,10 @@ import asyncio
 from agent_framework import Annotation
 from agent_framework.azure import AzureAIAgentClient, AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 This sample demonstrates how to create an Azure AI agent that uses Bing Grounding

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_code_interpreter.py

@@ -8,6 +8,10 @@ from azure.ai.agents.models import (
     RunStepDeltaCodeInterpreterDetailItemObject,
 )
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Code Interpreter Example

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_code_interpreter_file_generation.py

@@ -6,6 +6,10 @@ import os
 from agent_framework.azure import AzureAIAgentClient, AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent Code Interpreter File Generation Example

python/samples/02-agents/providers/azure_ai_agent/azure_ai_with_existing_agent.py

@@ -6,6 +6,10 @@ import os
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.identity.aio import AzureCliCredential
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 """
 Azure AI Agent with Existing Agent Example