Merge pull request #664 from MicrosoftDocs/main

9/25 Publish

Author: huypub

.gitignore

@@ -8,3 +8,8 @@ _repo.*/
 .openpublishing.buildcore.ps1
 .DS_Store
 /.vs
+
+# AI
+
+.claude/
+WARP.md

agent-framework/TOC.yml

@@ -1,4 +1,22 @@
-- name: Index
-  href: index.md
+items:
+- name: Agent Framework
+  href: overview/agent-framework-overview.md
+- name: Quickstart Guide
+  href: tutorials/quick-start.md
+  expanded: true
 - name: Tutorials
   href: tutorials/TOC.yml
+- name: User Guide
+  items:
+  - name: Overview
+    href: user-guide/overview.md
+  - name: Agents
+    href: user-guide/agents/TOC.yml
+  - name: Model Context Protocol
+    href: user-guide/model-context-protocol/TOC.yml
+  - name: Workflows
+    href: user-guide/workflows/TOC.yml
+- name: Migration Guide
+  href: migration-guide/index.md
+- name: API Reference Guide
+  items:

agent-framework/breadcrumb/agent-framework/toc.yml

@@ -1,3 +1,6 @@
-- name: '<please enter product name here>'
-  tocHref: /
-  topicHref: /
+- name: Microsoft Agent Framework
+  tocHref: /agent-framework/
+  topicHref: /agent-framework/index
+    
+
+

agent-framework/docfx.json

@@ -10,6 +10,7 @@
           "**/obj/**",
           "**/includes/**",
           "_themes/**",
+          "_themes.pdf/**",
           "**/docfx.json",
           "_repo.en-us/**",
           "README.md",
@@ -23,13 +24,16 @@
     "resource": [
       {
         "files": [
+          "**/*.svg",
           "**/*.png",
-          "**/*.jpg"
+          "**/*.jpg",
+          "**/*.gif"
         ],
         "exclude": [
           "**/obj/**",
           "**/includes/**",
           "_themes/**",
+          "_themes.pdf/**",
           "**/docfx.json",
           "_repo.en-us/**"
         ]
@@ -38,11 +42,15 @@
     "overwrite": [],
     "externalReference": [],
     "globalMetadata": {
-      "breadcrumb_path": "~/breadcrumb/agent-framework/toc.yml",
+      "zone_pivot_group_filename:": "zone_pivot_group.json",
+      "uhfHeaderId": "MSDocsHeader-AgentFramework",
+      "layout": "Conceptual",
+      "breadcrumb_path": "/breadcrumb/agent-framework/toc.yml",
       "feedback_system": "Standard",
       "permissioned-type": "public"
     },
     "fileMetadata": {},
-    "template": []
+    "template": [],
+    "dest": "agent-framework"
   }
-}
+}

agent-framework/index.md

@@ -0,0 +1,36 @@
+### YamlMime:Hub
+title: Agent Framework documentation
+summary: Learn to build robust, future-proof Agentic AI solutions that evolve with technological advancements.
+brand: semantic-kernel
+metadata:
+  title: Agent Framework documentation
+  description: Agent Framework documentation.
+  ms.topic: hub-page
+  ms.date: 09/05/2025
+  ms.service: azure
+  searchScope: []
+  titleSuffix: ""
+  ms.author: ssalgado
+  author: ssalgadodev
+  ms.manager: nitinme
+  hide_bc: true
+
+productDirectory:
+    items:
+    - title: Getting Started
+      imageSrc: /agent-framework/media/getting-started.svg
+      links:
+        - url: /agent-framework/overview/agent-framework-overview
+          text: Introduction to Agent Framework
+    - title: Quick Start
+      imageSrc: /agent-framework/media/quick-start.svg
+      links:
+        - url: /agent-framework/get-started/quick-start-guide
+          text: Learn how to use Agent Framework
+        - url: /agent-framework/get-started/detailed-samples
+          text: Check out samples for Agent Framework
+    - title: Migration Guide
+      imageSrc: /agent-framework/media/migration-guide.svg
+      links:
+        - url: /agent-framework/migration-guide/index
+          text: Migrate from Semantic Kernel to Agent Framework

agent-framework/index.yml

@@ -0,0 +1,11 @@
+---
+title: Microsoft Agent Framework Migration Guide
+description: Learn how to migrate from the Semantic Kernel Agent Framework to Microsoft Agent Framework
+author: markwallace
+ms.topic: reference
+ms.author: markwallace
+ms.date: 09/24/2025
+ms.service: semantic-kernel
+---
+
+# Migration Guide