Merge pull request #304 from MicrosoftDocs/main638949660204958972sync_temp

Repo sync for protected branch

Author: westey-m

.gitignore

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

.openpublishing.publish.config.json

@@ -1,5 +1,17 @@
 {
   "docsets_to_publish": [
+    {
+      "docset_name": "agent-framework",
+      "build_source_folder": "agent-framework",
+      "build_output_subfolder": "agent-framework",
+      "locale": "en-us",
+      "monikers": [],
+      "open_to_public_contributors": false,
+      "type_mapping": {
+        "Conceptual": "Content"
+      },
+      "build_entry_point": "docs"
+    },
     {
       "docset_name": "semantic-kernel",
       "build_source_folder": "semantic-kernel",

SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

agent-framework/TOC.yml

@@ -0,0 +1,22 @@
+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/TOC.yml
+- name: API Reference Guide
+  items:

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

@@ -0,0 +1,6 @@
+- name: Microsoft Agent Framework
+  tocHref: /agent-framework/
+  topicHref: /agent-framework/index
+    
+
+

agent-framework/docfx.json

@@ -0,0 +1,56 @@
+{
+  "build": {
+    "content": [
+      {
+        "files": [
+          "**/*.md",
+          "**/*.yml"
+        ],
+        "exclude": [
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**",
+          "README.md",
+          "LICENSE",
+          "LICENSE-CODE",
+          "ThirdPartyNotices.md",
+          "SECURITY.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "**/*.svg",
+          "**/*.png",
+          "**/*.jpg",
+          "**/*.gif"
+        ],
+        "exclude": [
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**"
+        ]
+      }
+    ],
+    "overwrite": [],
+    "externalReference": [],
+    "globalMetadata": {
+      "zone_pivot_group_filename:": "zone_pivot_group.json",
+      "uhfHeaderId": "MSDocsHeader-AgentFramework",
+      "layout": "Conceptual",
+      "breadcrumb_path": "/agent-framework/breadcrumb/agent-framework/toc.json",
+      "feedback_system": "Standard",
+      "permissioned-type": "public"
+    },
+    "fileMetadata": {},
+    "template": [],
+    "dest": "agent-framework"
+  }
+}

agent-framework/index.yml

@@ -0,0 +1,42 @@
+### 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: agent-framework
+  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/tutorials/quick-start
+          text: Agent Framework Quick Start
+        - url: /agent-framework/tutorials/overview
+          text: Learn how to use Agent Framework
+        - url: https://github.com/microsoft/agent-framework/tree/main/python/samples
+          text: Check out Python samples for Agent Framework
+        - url: https://github.com/microsoft/agent-framework/tree/main/dotnet/samples
+          text: Check out C# samples for Agent Framework
+    - title: Migration Guide
+      imageSrc: /agent-framework/media/migration-guide.svg
+      links:
+        - url: /agent-framework/migration-guide/from-autogen/index
+          text: Migrate from Autogen to Agent Framework
+        - url: /agent-framework/migration-guide/from-semantic-kernel/index
+          text: Migrate from Semantic Kernel to Agent Framework

agent-framework/media/agent.mmd

@@ -0,0 +1,27 @@
+sequenceDiagram
+    participant User
+    participant Agent
+    participant LLM
+    participant Tools/MCP
+
+    User->>Agent: User Message
+    Agent->>Agent: Initialize with Prompt Instruction
+
+    rect rgb(240, 248, 255)
+        Note over Agent,Tools/MCP: Agentic Loop (iterative until task complete)
+
+        Agent->>LLM: Send Request + Prompt + Context
+        LLM->>LLM: Process & Decide Next Action
+
+        alt Tool/MCP Call Required
+            LLM->>Agent: Return Tool/MCP Call Request
+            Agent->>Tools/MCP: Execute Tool/MCP Function
+            Tools/MCP->>Agent: Return Result
+            Agent->>LLM: Send Tool Result + Updated Context
+            Note over Agent,LLM: Loop continues with tool results
+        else Task Complete
+            LLM->>Agent: Return Final Response
+        end
+    end
+
+    Agent->>User: Final Response