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

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 @@
 
 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 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 @@
 
 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 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 @@
   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 @@
 
 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.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.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.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.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.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.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 @@
 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 @@
 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 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_chat_message_store_session.py → python/samples/02-agents/conversations/custom_history_provider.py

@@ -6,6 +6,10 @@
 
 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_chat_message_store_session.py → python/samples/02-agents/conversations/redis_history_provider.py

@@ -7,6 +7,10 @@
 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 @@
 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.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 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():