fix quick start for python (#786)

* fix quick start for python

* improved language

* fix typo

* fixed other pip installs

* updated author and ms.topic

* fix reference

* different link

Author: eavanvalkenburg

agent-framework/integrations/ag-ui/getting-started.md

@@ -387,13 +387,13 @@ The AG-UI server hosts your AI agent and exposes it via HTTP endpoints using Fas
 Install the necessary packages for the server:
 
 ```bash
-pip install agent-framework-ag-ui
+pip install agent-framework-ag-ui --pre
 ```
 
 Or using uv:
 
 ```bash
-uv pip install agent-framework-ag-ui
+uv pip install agent-framework-ag-ui --prerelease=allow
 ```
 
 This will automatically install `agent-framework-core`, `fastapi`, and `uvicorn` as dependencies.
@@ -425,7 +425,7 @@ if not deployment_name:
 chat_client = AzureOpenAIChatClient(
     credential=AzureCliCredential(),
     endpoint=endpoint,
-    deployment_name=deployment_name,    
+    deployment_name=deployment_name,
 )
 
 # Create the AI agent
@@ -488,7 +488,7 @@ The AG-UI package is already installed, which includes the `AGUIChatClient`:
 
 ```bash
 # Already installed with agent-framework-ag-ui
-pip install agent-framework-ag-ui
+pip install agent-framework-ag-ui --pre
 ```
 
 ### Client Code
@@ -513,7 +513,7 @@ async def main():
 
     # Create AG-UI chat client
     chat_client = AGUIChatClient(server_url=server_url)
-    
+
     # Create agent with the chat client
     agent = ChatAgent(
         name="ClientAgent",

agent-framework/integrations/ag-ui/index.md

@@ -48,7 +48,7 @@ The Agent Framework AG-UI integration supports all 7 AG-UI protocol features:
 
 ## Build agent UIs with CopilotKit
 
-[CopilotKit](https://copilotkit.ai/) provides rich UI components for building agent user interfaces based on the standard AG-UI protocol. CopilotKit supports streaming chat interfaces, frontend & backend tool calling, human-in-the-loop interactions, generative UI, shared state, and much more. You can see a examples of the various agent UI scenarios that CopilotKit supports in the [AG-UI Dojo](https://dojo.ag-ui.com/microsoft-agent-framework-dotnet) sample application. 
+[CopilotKit](https://copilotkit.ai/) provides rich UI components for building agent user interfaces based on the standard AG-UI protocol. CopilotKit supports streaming chat interfaces, frontend & backend tool calling, human-in-the-loop interactions, generative UI, shared state, and much more. You can see a examples of the various agent UI scenarios that CopilotKit supports in the [AG-UI Dojo](https://dojo.ag-ui.com/microsoft-agent-framework-dotnet) sample application.
 
 CopilotKit helps you focus on your agent’s capabilities while delivering a polished user experience without reinventing the wheel.
 To learn more about getting started with Microsoft Agent Framework and CopilotKit, see the [Microsoft Agent Framework integration for CopilotKit](https://docs.copilotkit.ai/microsoft-agent-framework) documentation.
@@ -233,7 +233,7 @@ Understanding how Agent Framework concepts map to AG-UI helps you build effectiv
 Install the AG-UI integration package:
 
 ```bash
-pip install agent-framework-ag-ui
+pip install agent-framework-ag-ui --pre
 ```
 
 This installs both the core agent framework and AG-UI integration components.

agent-framework/integrations/ag-ui/state-management.md

@@ -488,7 +488,7 @@ agent = ChatAgent(
     chat_client=AzureOpenAIChatClient(
         credential=AzureCliCredential(),
         endpoint=endpoint,
-        deployment_name=deployment_name,    
+        deployment_name=deployment_name,
     ),
     tools=[update_recipe],
 )
@@ -614,7 +614,7 @@ async def main():
 
     # Create AG-UI chat client
     chat_client = AGUIChatClient(server_url=server_url)
-    
+
     # Wrap with ChatAgent for convenient API
     agent = ChatAgent(
         name="ClientAgent",
@@ -624,7 +624,7 @@ async def main():
 
     # Get a thread for conversation continuity
     thread = agent.get_new_thread()
-    
+
     # Track state locally
     state: dict[str, Any] = {}
 
@@ -647,7 +647,7 @@ async def main():
                 # Handle text content
                 if update.text:
                     print(update.text, end="", flush=True)
-                
+
                 # Handle state updates
                 for content in update.contents:
                     # STATE_SNAPSHOT events come as DataContent with application/json
@@ -656,7 +656,7 @@ async def main():
                         state_data = json.loads(content.data.decode() if isinstance(content.data, bytes) else content.data)
                         state = state_data
                         print("\n[State Snapshot Received]")
-                    
+
                     # STATE_DELTA events are handled similarly
                     # Apply JSON Patch deltas to maintain state
                     if hasattr(content, 'delta') and content.delta:
@@ -672,7 +672,7 @@ async def main():
 
 
 if __name__ == "__main__":
-    # Install dependencies: pip install agent-framework-ag-ui jsonpatch
+    # Install dependencies: pip install agent-framework-ag-ui jsonpatch --pre
     asyncio.run(main())
 ```
 
@@ -913,7 +913,7 @@ Always write the complete state, not just deltas:
 def update_recipe(recipe: Recipe) -> str:
     """
     You MUST write the complete recipe with ALL fields.
-    When modifying a recipe, include ALL existing ingredients and 
+    When modifying a recipe, include ALL existing ingredients and
     instructions plus your changes. NEVER delete existing data.
     """
     return "Recipe updated."

agent-framework/migration-guide/from-semantic-kernel/index.md

@@ -321,7 +321,7 @@ from semantic_kernel.agents import ChatCompletionAgent
 ### Agent Framework
 
 Agent Framework package is installed as `agent-framework` and imported as `agent_framework`.
-Agent Framework is built up differently, it has a core package `agent-framework-core` that contains the core functionality, and then there are multiple packages that rely on that core package, such as `agent-framework-azure-ai`, `agent-framework-mem0`, `agent-framework-copilotstudio`, etc. When you run `pip install agent-framework` it will install the core package and *all* packages, so that you can get started with all the features quickly. When you are ready to reduce the number of packages because you know what you need, you can install only the packages you need, so for instance if you only plan to use Azure AI Foundry and Mem0 you can install only those two packages: `pip install agent-framework-azure-ai agent-framework-mem0`, `agent-framework-core` is a dependency to those two, so will automatically be installed.
+Agent Framework is built up differently, it has a core package `agent-framework-core` that contains the core functionality, and then there are multiple packages that rely on that core package, such as `agent-framework-azure-ai`, `agent-framework-mem0`, `agent-framework-copilotstudio`, etc. When you run `pip install agent-framework --pre` it will install the core package and *all* packages, so that you can get started with all the features quickly. When you are ready to reduce the number of packages because you know what you need, you can install only the packages you need, so for instance if you only plan to use Azure AI Foundry and Mem0 you can install only those two packages: `pip install agent-framework-azure-ai agent-framework-mem0 --pre`, `agent-framework-core` is a dependency to those two, so will automatically be installed.
 
 Even though the packages are split up, the imports are all from `agent_framework`, or it's modules. So for instance to import the client for Azure AI Foundry you would do:
 

agent-framework/overview/agent-framework-overview.md

@@ -1,9 +1,9 @@
 ---
 title: Introduction to Microsoft Agent Framework
 description: Learn about Microsoft Agent Framework
-author: ekzhu
+author: markwallace-microsoft
 ms.topic: reference
-ms.author: ekzhu
+ms.author: markwallace
 ms.date: 10/01/2025
 ms.service: agent-framework
 ---
@@ -57,7 +57,7 @@ and the same is expected for Agent Framework. Microsoft Agent Framework welcomes
 Python:
 
 ```bash
-pip install agent-framework
+pip install agent-framework --pre
 ```
 
 .NET:

agent-framework/support/index.md

@@ -2,7 +2,7 @@
 title: Support for Agent Framework
 description: Support for Agent Framework
 author: TaoChenOSU
-ms.topic: conceptual
+ms.topic: article
 ms.author: taochen
 ms.date: 10/30/2025
 ms.service: agent-framework
@@ -13,7 +13,7 @@ ms.service: agent-framework
 
 | Your preference | What's available |
 |---|---|
-| Read the docs | [This learning site](/agent-framework/overview) is the home of the latest information for developers |
+| Read the docs | [This learning site](/agent-framework/) is the home of the latest information for developers |
 | Visit the repo | Our open-source [GitHub repository](https://github.com/microsoft/agent-framework) is available for perusal and suggestions |
 | Connect with the Agent Framework Team | Visit our [GitHub Discussions](https://github.com/microsoft/agent-framework/discussions) to get supported quickly with our [CoC](https://github.com/microsoft/agent-framework/blob/main/CODE_OF_CONDUCT.md) actively enforced |
-|  Office Hours | We will be hosting regular office hours; the calendar invites and cadence are located here: [Community.MD](https://github.com/microsoft/agent-framework/blob/main/COMMUNITY.md) |
+|  Office Hours | We will be hosting regular office hours; the calendar invites and cadence are located here: [Community.MD](https://github.com/microsoft/agent-framework/blob/main/COMMUNITY.md) |

agent-framework/tutorials/agents/enable-observability.md

@@ -143,7 +143,7 @@ For prerequisites, see the [Create and run a simple agent](./run-agent.md) step
 To use Agent Framework with Azure OpenAI, you need to install the following packages. Agent Framework automatically includes all necessary OpenTelemetry dependencies:
 
 ```bash
-pip install agent-framework
+pip install agent-framework --pre
 ```
 
 The following OpenTelemetry packages are included by default:

agent-framework/tutorials/agents/run-agent.md

@@ -186,7 +186,7 @@ Before you begin, ensure you have the following prerequisites:
 To use Microsoft Agent Framework with Azure OpenAI, you need to install the following Python packages:
 
 ```bash
-pip install agent-framework
+pip install agent-framework --pre
 ```
 
 ## Create the agent

agent-framework/tutorials/plugins/use-purview-with-agent-framework-sdk.md

@@ -3,7 +3,7 @@ title: Use Microsoft Purview SDK with Agent Framework
 description: Learn how to integrate Microsoft Purview SDK for data security and governance in your Agent Framework project
 zone_pivot_groups: programming-languages
 author: reezaali149
-ms.topic: conceptual
+ms.topic: article
 ms.author: v-reezaali
 ms.date: 10/28/2025
 ms.service: purview
@@ -27,7 +27,7 @@ Before you begin, ensure you have:
 - Microsoft 365 subscription with an E5 license and pay-as-you-go billing setup.
   - For testing, you can use a Microsoft 365 Developer Program tenant. For more information, see [Join the Microsoft 365 Developer Program](https://developer.microsoft.com/en-us/microsoft-365/dev-program).
 - Agent Framework SDK: To install the Agent Framework SDK:
-  - Python: Run `pip install agent-framework`.
+  - Python: Run `pip install agent-framework --pre`.
   - .NET: Install from NuGet.
 
 ## How to integrate Microsoft Purview into your agent
@@ -40,34 +40,34 @@ The following code sample demonstrates how to add the Microsoft Purview policy m
 
 ```csharp
 
-using Azure.AI.OpenAI; 
-using Azure.Core; 
-using Azure.Identity; 
-using Microsoft.Agents.AI; 
-using Microsoft.Agents.AI.Purview; 
-using Microsoft.Extensions.AI; 
-using OpenAI; 
+using Azure.AI.OpenAI;
+using Azure.Core;
+using Azure.Identity;
+using Microsoft.Agents.AI;
+using Microsoft.Agents.AI.Purview;
+using Microsoft.Extensions.AI;
+using OpenAI;
 
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set."); 
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME") ?? "gpt-4o-mini"; 
-string purviewClientAppId = Environment.GetEnvironmentVariable("PURVIEW_CLIENT_APP_ID") ?? throw new InvalidOperationException("PURVIEW_CLIENT_APP_ID is not set."); 
+string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
+string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME") ?? "gpt-4o-mini";
+string purviewClientAppId = Environment.GetEnvironmentVariable("PURVIEW_CLIENT_APP_ID") ?? throw new InvalidOperationException("PURVIEW_CLIENT_APP_ID is not set.");
 
-TokenCredential browserCredential = new InteractiveBrowserCredential( 
-    new InteractiveBrowserCredentialOptions 
-    { 
-        ClientId = purviewClientAppId 
-    }); 
+TokenCredential browserCredential = new InteractiveBrowserCredential(
+    new InteractiveBrowserCredentialOptions
+    {
+        ClientId = purviewClientAppId
+    });
 
 AIAgent agent = new AzureOpenAIClient(
-    new Uri(endpoint), 
-    new AzureCliCredential()) 
-    .GetChatClient(deploymentName) 
-    .CreateAIAgent("You are a secure assistant.") 
-    .AsBuilder() 
-    .WithPurview(browserCredential, new PurviewSettings("My Secure Agent")) 
-    .Build(); 
-
-AgentRunResponse response = await agent.RunAsync("Summarize zero trust in one sentence.").ConfigureAwait(false); 
+    new Uri(endpoint),
+    new AzureCliCredential())
+    .GetChatClient(deploymentName)
+    .CreateAIAgent("You are a secure assistant.")
+    .AsBuilder()
+    .WithPurview(browserCredential, new PurviewSettings("My Secure Agent"))
+    .Build();
+
+AgentRunResponse response = await agent.RunAsync("Summarize zero trust in one sentence.").ConfigureAwait(false);
 Console.WriteLine(response);
 
 ```
@@ -76,34 +76,34 @@ Console.WriteLine(response);
 ::: zone pivot="programming-language-python"
 
 ```python
-import asyncio 
-import os 
-from agent_framework import ChatAgent, ChatMessage, Role 
+import asyncio
+import os
+from agent_framework import ChatAgent, ChatMessage, Role
 from agent_framework.azure import AzureOpenAIChatClient
-from agent_framework.microsoft import PurviewPolicyMiddleware, PurviewSettings 
-from azure.identity import AzureCliCredential, InteractiveBrowserCredential 
-
-# Set default environment variables if not already set 
-os.environ.setdefault("AZURE_OPENAI_ENDPOINT", "<azureOpenAIEndpoint>") 
-os.environ.setdefault("AZURE_OPENAI_CHAT_DEPLOYMENT_NAME", "<azureOpenAIChatDeploymentName>") 
-
-async def main(): 
-    chat_client = AzureOpenAIChatClient(credential=AzureCliCredential()) 
-    purview_middleware = PurviewPolicyMiddleware( 
-        credential=InteractiveBrowserCredential( 
-            client_id="<clientId>", 
-        ), 
+from agent_framework.microsoft import PurviewPolicyMiddleware, PurviewSettings
+from azure.identity import AzureCliCredential, InteractiveBrowserCredential
+
+# Set default environment variables if not already set
+os.environ.setdefault("AZURE_OPENAI_ENDPOINT", "<azureOpenAIEndpoint>")
+os.environ.setdefault("AZURE_OPENAI_CHAT_DEPLOYMENT_NAME", "<azureOpenAIChatDeploymentName>")
+
+async def main():
+    chat_client = AzureOpenAIChatClient(credential=AzureCliCredential())
+    purview_middleware = PurviewPolicyMiddleware(
+        credential=InteractiveBrowserCredential(
+            client_id="<clientId>",
+        ),
         settings=PurviewSettings(app_name="My Secure Agent")
-    ) 
-    agent = ChatAgent( 
-        chat_client=chat_client, 
-        instructions="You are a secure assistant.", 
-        middleware=[purview_middleware] 
-    ) 
-    response = await agent.run(ChatMessage(role=Role.USER, text="Summarize zero trust in one sentence.")) 
-    print(response) 
-
-  if __name__ == "__main__": 
+    )
+    agent = ChatAgent(
+        chat_client=chat_client,
+        instructions="You are a secure assistant.",
+        middleware=[purview_middleware]
+    )
+    response = await agent.run(ChatMessage(role=Role.USER, text="Summarize zero trust in one sentence."))
+    print(response)
+
+  if __name__ == "__main__":
     asyncio.run(main())
 ```
 

agent-framework/tutorials/quick-start.md

@@ -144,9 +144,19 @@ Before you begin, ensure you have the following:
 - [Python 3.10 or later](https://www.python.org/downloads/)
 - An [Azure AI](/azure/ai-foundry/) project with a deployed model (for example, `gpt-4o-mini`)
 - [Azure CLI](/cli/azure/install-azure-cli) installed and authenticated (`az login`)
+- Install the Agent Framework Package:
+
+```bash
+pip install -U agent-framework --pre
+```
 
 > [!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 project. For more information, see the [Azure CLI documentation](/cli/azure/authenticate-azure-cli-interactively).
+> Installing `agent-framework` will install `agent-framework-core` and all other official packages. If you want to install only the Azure AI package, you can run: `pip install agent-framework-azure-ai --pre`
+> All of the official packages, including `agent-framework-azure-ai` have a dependency on `agent-framework-core`, so in most cases, you wouldn't have to specify that.
+> The full list of official packages can be found in the [Agent Framework GitHub repository](https://github.com/microsoft/agent-framework/blob/main/python/pyproject.toml#L80).
+
+> [!NOTE]
+> This sample uses Azure CLI credentials for authentication. Make sure you're logged in with `az login` and have access to the Azure AI project. For more information, see the [Azure CLI documentation](/cli/azure/authenticate-azure-cli-interactively).
 
 ## Running a Basic Agent Sample
 
@@ -156,20 +166,17 @@ Make sure to set the following environment variables:
 - `AZURE_AI_PROJECT_ENDPOINT`: Your Azure AI project endpoint
 - `AZURE_AI_MODEL_DEPLOYMENT_NAME`: The name of your model deployment
 
-
 ### Sample Code
 
 ```python
 import asyncio
-from agent_framework import ChatAgent
-from agent_framework.azure import AzureAIAgentClient
+from agent_framework.azure import AzureAIClient
 from azure.identity.aio import AzureCliCredential
 
 async def main():
     async with (
         AzureCliCredential() as credential,
-        ChatAgent(
-            chat_client=AzureAIAgentClient(async_credential=credential),
+        AzureAIClient(async_credential=credential).create_agent(
             instructions="You are good at telling jokes."
         ) as agent,
     ):
@@ -182,7 +189,7 @@ if __name__ == "__main__":
 
 ## More Examples
 
-For more detailed examples and advanced scenarios, see the [Azure AI Agent Examples](https://github.com/microsoft/agent-framework/blob/main/python/samples/getting_started/agents/azure_ai/README.md).
+For more detailed examples and advanced scenarios, see the [Azure AI Examples](https://github.com/microsoft/agent-framework/blob/main/python/samples/getting_started/agents/azure_ai/README.md).
 
 
 ::: zone-end