Merge pull request #339 from MicrosoftDocs/main639034658186999847sync_temp

Repo sync for protected branch

Author: markwallace-microsoft

.openpublishing.redirection.json

@@ -824,6 +824,16 @@
             "source_path": "semantic-kernel/Frameworks/agent/examples/example-agent-collaboration.md",
             "redirect_url": "/semantic-kernel/support/archive/agent-chat-example",
             "redirect_document_id": false
+        },
+        {
+            "source_path": "agent-framework/tutorials/workflows/visualization.md",
+            "redirect_url": "/agent-framework/user-guide/workflows/visualization",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "agent-framework/user-guide/agents/agent-observability.md",
+            "redirect_url": "/agent-framework/user-guide/observability",
+            "redirect_document_id": true
         }
     ]
 }

agent-framework/TOC.yml

@@ -16,6 +16,12 @@ items:
     href: user-guide/model-context-protocol/TOC.yml
   - name: Workflows
     href: user-guide/workflows/TOC.yml
+  - name: Hosting
+    href: user-guide/hosting/TOC.yml
+  - name: DevUI
+    href: user-guide/devui/TOC.yml
+  - name: Observability
+    href: user-guide/observability.md
 - name: Integrations
   items:
   - name: AG-UI

agent-framework/docfx.json

@@ -21,6 +21,23 @@
         ]
       }
     ],
+    "ms.update-cycle": {
+      "agent-framework/api-docs/*.md": "180-days",
+      "agent-framework/api-docs/*.yml": "180-days",
+      "agent-framework/tutorials/**/*.md": "180-days",
+      "agent-framework/tutorials/**/*.yml": "180-days",
+      "agent-framework/migration-guide/**/*.md": "180-days",
+      "agent-framework/migration-guide/**/*.yml": "180-days",
+      "agent-framework/overview/*.md": "180-days",
+      "agent-framework/overview/*.yml": "180-days",
+      "agent-framework/user-guide/**/*.md": "180-days",
+      "agent-framework/user-guide/**/*.yml": "180-days",
+      "agent-framework/integrations/*.md": "180-days",
+      "agent-framework/integrations/*.yml": "180-days",
+      "agent-framework/support/**/*.md": "180-days",
+      "agent-framework/support/**/*.yml": "180-days"
+    },
+  
     "resource": [
       {
         "files": [
@@ -49,7 +66,42 @@
       "feedback_system": "Standard",
       "permissioned-type": "public"
     },
-    "fileMetadata": {},
+    "fileMetadata": {
+      "ms.collection": {
+        "api-docs/**/*.md": "ce-skilling-ai-copilot",
+        "api-docs/**/*.yml": "ce-skilling-ai-copilot",
+        "integrations/**/*.md": "ce-skilling-ai-copilot",
+        "integrations/**/*.yml": "ce-skilling-ai-copilot",
+        "migration-guide/**/*.md": "ce-skilling-ai-copilot",
+        "migration-guide/**/*.yml": "ce-skilling-ai-copilot",
+        "overview/**/*.md": "ce-skilling-ai-copilot",
+        "overview/**/*.yml": "ce-skilling-ai-copilot",
+        "support/**/*.md": "ce-skilling-ai-copilot",
+        "support/**/*.yml": "ce-skilling-ai-copilot",
+        "tutorials/**/*.md": "ce-skilling-ai-copilot",
+        "tutorials/**/*.yml": "ce-skilling-ai-copilot",
+        "user-guide/**/*.md": "ce-skilling-ai-copilot",
+        "user-guide/**/*.yml": "ce-skilling-ai-copilot",
+        "index.yml": "ce-skilling-ai-copilot"        
+      },
+      "ms.update-cycle": {
+        "api-docs/**/*.md": "180-days",
+        "api-docs/**/*.yml": "180-days",
+        "integrations/**/*.md": "180-days",
+        "integrations/**/*.yml": "180-days",
+        "migration-guide/**/*.md": "180-days",
+        "migration-guide/**/*.yml": "180-days",
+        "overview/**/*.md": "180-days",
+        "overview/**/*.yml": "180-days",
+        "support/**/*.md": "180-days",
+        "support/**/*.yml": "180-days",
+        "tutorials/**/*.md": "180-days",
+        "tutorials/**/*.yml": "180-days",
+        "user-guide/**/*.md": "180-days",
+        "user-guide/**/*.yml": "180-days",
+        "index.yml": "180-days"
+      }
+    },
     "template": [],
     "dest": "agent-framework"
   }

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."