Python: Documentation updates (#538)

* Added README for each sample sub-folder

* More documentation updates

user-documentation-python/getting-started/README.md

@@ -1,7 +1,48 @@
 # Microsoft Agent Framework Getting Started
 
-This guide will help you get up and running quickly with a basic agent using the Agent Framework and Azure OpenAI.
+This guide will help you get up and running quickly with a basic agent using the Agent Framework and Azure AI Foundry.
 
-## Coming Soon
+## Prerequisites
 
+Before you begin, ensure you have the following:
 
+- [Python 3.9 or later](https://www.python.org/downloads/)
+- An [Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/) project with a deployed model (e.g., `gpt-4o-mini`)
+- [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) installed and authenticated (`az login`)
+
+**Note**: This demo uses Azure CLI credentials for authentication. Make sure you're logged in with `az login` and have access to the Azure AI Foundry project. For more information, see the [Azure CLI documentation](https://learn.microsoft.com/cli/azure/authenticate-azure-cli-interactively).
+
+## Running a Basic Agent Sample
+
+This sample demonstrates how to create and use a simple AI agent with Azure AI Foundry as the backend. It will create a basic agent using `ChatClientAgent` with `FoundryChatClient` and custom instructions.
+
+Make sure to set the following environment variables:
+- `FOUNDRY_PROJECT_ENDPOINT`: Your Azure AI Foundry project endpoint
+- `FOUNDRY_MODEL_DEPLOYMENT_NAME`: The name of your model deployment
+
+### Sample Code
+
+```python
+import asyncio
+from agent_framework import ChatClientAgent
+from agent_framework.foundry import FoundryChatClient
+from azure.identity.aio import AzureCliCredential
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        ChatClientAgent(
+            chat_client=FoundryChatClient(async_credential=credential),
+            instructions="You are good at telling jokes."
+        ) as agent,
+    ):
+        result = await agent.run("Tell me a joke about a pirate.")
+        print(result.text)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## More Examples
+
+For more detailed examples and advanced scenarios, see the [Foundry Agent Examples](../../python/samples/getting_started/agents/foundry/README.md).