Agents + Chat Client Samples Doctsring Updates (#1028)

* agents + chat client samples doctsring updates

* fixes

python/samples/getting_started/chat_client/azure_ai_chat_client.py

@@ -8,6 +8,13 @@ from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
 
+"""
+Azure AI Chat Client Direct Usage Example
+
+Demonstrates direct AzureAIChatClient usage for chat interactions with Azure AI models.
+Shows function calling capabilities with custom business logic.
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/azure_assistants_client.py

@@ -8,6 +8,13 @@ from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
 
+"""
+Azure Assistants Client Direct Usage Example
+
+Demonstrates direct AzureAssistantsClient usage for chat interactions with Azure OpenAI assistants.
+Shows function calling capabilities and automatic assistant creation.
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/azure_chat_client.py

@@ -8,6 +8,13 @@ from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
 
+"""
+Azure Chat Client Direct Usage Example
+
+Demonstrates direct AzureChatClient usage for chat interactions with Azure OpenAI models.
+Shows function calling capabilities with custom business logic.
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/azure_responses_client.py

@@ -9,6 +9,13 @@ from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
 from pydantic import BaseModel, Field
 
+"""
+Azure Responses Client Direct Usage Example
+
+Demonstrates direct AzureResponsesClient usage for structured response generation with Azure OpenAI models.
+Shows function calling capabilities with custom business logic.
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/chat_response_cancellation.py

@@ -4,6 +4,13 @@ import asyncio
 
 from agent_framework.openai import OpenAIChatClient
 
+"""
+Chat Response Cancellation Example
+
+Demonstrates proper cancellation of streaming chat responses during execution.
+Shows asyncio task cancellation and resource cleanup techniques.
+"""
+
 
 async def main() -> None:
     """

python/samples/getting_started/chat_client/openai_assistants_client.py

@@ -7,6 +7,14 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantsClient
 from pydantic import Field
 
+"""
+OpenAI Assistants Client Direct Usage Example
+
+Demonstrates direct OpenAIAssistantsClient usage for chat interactions with OpenAI assistants.
+Shows function calling capabilities and automatic assistant creation.
+
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/openai_chat_client.py

@@ -7,6 +7,14 @@ from typing import Annotated
 from agent_framework.openai import OpenAIChatClient
 from pydantic import Field
 
+"""
+OpenAI Chat Client Direct Usage Example
+
+Demonstrates direct OpenAIChatClient usage for chat interactions with OpenAI models.
+Shows function calling capabilities with custom business logic.
+
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],

python/samples/getting_started/chat_client/openai_responses_client.py

@@ -7,6 +7,14 @@ from typing import Annotated
 from agent_framework.openai import OpenAIResponsesClient
 from pydantic import Field
 
+"""
+OpenAI Responses Client Direct Usage Example
+
+Demonstrates direct OpenAIResponsesClient usage for structured response generation with OpenAI models.
+Shows function calling capabilities with custom business logic.
+
+"""
+
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],