[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69A0HWVR5FEYS3F8Y4A6WHR":3,"skill-same:01M69A0HWVR5FEYS3F8Y4A6WHR":54},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":37,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M69A0HWVR5FEYS3F8Y4A6WHR","microsoft-docs",null,"microsoft\u002Fai-agents-for-beginners","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998ZK2275KMJE6Y5SEA2X2",79423,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-CN\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,8,24],"docs","microsoft docs","2026-11-10 10:12:30",false,"---\nname: microsoft-docs\n---\n# Microsoft Docs\n\n针对微软技术生态系统的研究技能。涵盖 learn.microsoft.com 以及存在于其之外的文档（VS Code、GitHub、Aspire、Agent Framework 仓库）。\n\n---\n\n## 默认：Microsoft Learn MCP\n\n对 **learn.microsoft.com** 上的所有内容使用这些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等。这是绝大多数微软文档查询的主要工具。\n\n| 工具 | 用途 |\n|------|---------|\n| `microsoft_docs_search` | 搜索 learn.microsoft.com — 概念、指南、教程、配置 |\n| `microsoft_code_sample_search` | 从 Learn 文档中查找可用的代码片段。传递 `language`（`python`、`csharp` 等）以获得最佳结果 |\n| `microsoft_docs_fetch` | 从特定 URL 获取完整页面内容（当搜索摘要不够时） |\n\n当需要完整教程、所有配置选项或搜索摘要被截断时，搜索后使用 `microsoft_docs_fetch`。\n\n---\n\n## 例外情况：何时使用其他工具\n\n以下类别存在于 **learn.microsoft.com** 之外。请使用指定工具。\n\n### Aspire — 使用 Aspire MCP Server（优选）或 Context7\n\nAspire 文档位于 **aspire.dev**，而非 Learn。最佳工具取决于您的 Aspire CLI 版本：\n\n**CLI 13.2+**（推荐）—— Aspire MCP 服务器内置文档搜索工具：\n\n| MCP 工具 | 说明 |\n|----------|-------------|\n| `list_docs` | 列出 aspire.dev 上所有可用文档 |\n| `search_docs` | 对 aspire.dev 内容进行加权词汇搜索 |\n| `get_doc` | 通过 slug 检索特定文档 |\n\n这些工具随 Aspire CLI 13.2 一起发布（[PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)）。更新命令：`aspire update --self --channel daily`。\n\n**CLI 13.1** — MCP 服务器提供集成查询（`list_integrations`、`get_integration_docs`），但\u003Cstrong>不支持\u003C\u002Fstrong>文档搜索。请回退使用 Context7：\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | 主要用法 — 指南、集成、CLI 参考、部署 |\n| `\u002Fmicrosoft\u002Faspire` | 运行时源 — API 内部实现细节 |\n| `\u002Fcommunitytoolkit\u002Faspire` | 社区集成 — Go、Java、Node.js、Ollama |\n\n### VS Code — 使用 Context7\n\nVS Code 文档位于 **code.visualstudio.com**，而非 Learn。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | 用户文档 — 设置、功能、调试、远程开发 |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | 扩展 API — webviews、TreeViews、命令、贡献点 |\n\n### GitHub — 使用 Context7\n\nGitHub 文档位于 **docs.github.com** 和 **cli.github.com**。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions、API、仓库、安全、管理、Copilot |\n| `\u002Fwebsites\u002Fcli_github` | GitHub CLI（`gh`）的命令和参数 |\n\n### Agent Framework — 使用 Learn MCP + Context7\n\nAgent Framework 教程位于 learn.microsoft.com（使用 `microsoft_docs_search`），但\u003Cstrong>GitHub 仓库\u003C\u002Fstrong>有时包含比公开文档更前沿的 API 级细节——特别是 DevUI REST API 参考、CLI 选项和 .NET 集成。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | 教程 — DevUI 指南、跟踪、工作流编排 |\n| `\u002Fmicrosoft\u002Fagent-framework` | API 细节 — DevUI REST 端点、CLI 标志、认证、.NET `AddDevUI`\u002F`MapDevUI` |\n\n**DevUI 提示：** 先查询 Learn 网站源获取操作指南，再查询仓库源获得 API 级细节（端点模式、代理配置、认证令牌）。\n\n---\n\n## Context7 设置\n\n任何 Context7 查询之前，先解析库 ID（一会话一次）：\n\n1. 使用技术名称调用 `mcp_context7_resolve-library-id`\n2. 使用返回的库 ID 和具体查询调用 `mcp_context7_query-docs`\n\n---\n\n## 编写高效查询\n\n要具体 —— 包括版本、意图和语言：\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\n包含上下文：\n- 适用时写明 \u003Cstrong>版本\u003C\u002Fstrong>（`.NET 8`、`Aspire 13`、`VS Code 1.96`）\n- \u003Cstrong>任务意图\u003C\u002Fstrong>（`quickstart`、`tutorial`、`overview`、`limits`、`API reference`）\n- 针对多语言文档的 \u003Cstrong>语言\u003C\u002Fstrong>（`Python`、`TypeScript`、`C#`）\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**免责声明**：\n本文件由 AI 翻译服务 [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator) 翻译完成。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。原始语言版文件应视为权威来源。对于重要信息，建议使用专业人工翻译。我们对因使用本翻译而产生的任何误解或误释不承担责任。\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->","# Microsoft Docs\n\n针对微软技术生态系统的研究技能。涵盖 learn.microsoft.com 以及存在于其之外的文档（VS Code、GitHub、Aspire、Agent Framework 仓库）。\n\n---\n\n## 默认：Microsoft Learn MCP\n\n对 **learn.microsoft.com** 上的所有内容使用这些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等。这是绝大多数微软文档查询的主要工具。\n\n| 工具 | 用途 |\n|------|---------|\n| `microsoft_docs_search` | 搜索 learn.microsoft.com — 概念、指南、教程、配置 |\n| `microsoft_code_sample_search` | 从 Learn 文档中查找可用的代码片段。传递 `language`（`python`、`csharp` 等）以获得最佳结果 |\n| `microsoft_docs_fetch` | 从特定 URL 获取完整页面内容（当搜索摘要不够时） |\n\n当需要完整教程、所有配置选项或搜索摘要被截断时，搜索后使用 `microsoft_docs_fetch`。\n\n---\n\n## 例外情况：何时使用其他工具\n\n以下类别存在于 **learn.microsoft.com** 之外。请使用指定工具。\n\n### Aspire — 使用 Aspire MCP Server（优选）或 Context7\n\nAspire 文档位于 **aspire.dev**，而非 Learn。最佳工具取决于您的 Aspire CLI 版本：\n\n**CLI 13.2+**（推荐）—— Aspire MCP 服务器内置文档搜索工具：\n\n| MCP 工具 | 说明 |\n|----------|-------------|\n| `list_docs` | 列出 aspire.dev 上所有可用文档 |\n| `search_docs` | 对 aspire.dev 内容进行加权词汇搜索 |\n| `get_doc` | 通过 slug 检索特定文档 |\n\n这些工具随 Aspire CLI 13.2 一起发布（[PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)）。更新命令：`aspire update --self --channel daily`。\n\n**CLI 13.1** — MCP 服务器提供集成查询（`list_integrations`、`get_integration_docs`），但\u003Cstrong>不支持\u003C\u002Fstrong>文档搜索。请回退使用 Context7：\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | 主要用法 — 指南、集成、CLI 参考、部署 |\n| `\u002Fmicrosoft\u002Faspire` | 运行时源 — API 内部实现细节 |\n| `\u002Fcommunitytoolkit\u002Faspire` | 社区集成 — Go、Java、Node.js、Ollama |\n\n### VS Code — 使用 Context7\n\nVS Code 文档位于 **code.visualstudio.com**，而非 Learn。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | 用户文档 — 设置、功能、调试、远程开发 |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | 扩展 API — webviews、TreeViews、命令、贡献点 |\n\n### GitHub — 使用 Context7\n\nGitHub 文档位于 **docs.github.com** 和 **cli.github.com**。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions、API、仓库、安全、管理、Copilot |\n| `\u002Fwebsites\u002Fcli_github` | GitHub CLI（`gh`）的命令和参数 |\n\n### Agent Framework — 使用 Learn MCP + Context7\n\nAgent Framework 教程位于 learn.microsoft.com（使用 `microsoft_docs_search`），但\u003Cstrong>GitHub 仓库\u003C\u002Fstrong>有时包含比公开文档更前沿的 API 级细节——特别是 DevUI REST API 参考、CLI 选项和 .NET 集成。\n\n| 库 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | 教程 — DevUI 指南、跟踪、工作流编排 |\n| `\u002Fmicrosoft\u002Fagent-framework` | API 细节 — DevUI REST 端点、CLI 标志、认证、.NET `AddDevUI`\u002F`MapDevUI` |\n\n**DevUI 提示：** 先查询 Learn 网站源获取操作指南，再查询仓库源获得 API 级细节（端点模式、代理配置、认证令牌）。\n\n---\n\n## Context7 设置\n\n任何 Context7 查询之前，先解析库 ID（一会话一次）：\n\n1. 使用技术名称调用 `mcp_context7_resolve-library-id`\n2. 使用返回的库 ID 和具体查询调用 `mcp_context7_query-docs`\n\n---\n\n## 编写高效查询\n\n要具体 —— 包括版本、意图和语言：\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\n包含上下文：\n- 适用时写明 \u003Cstrong>版本\u003C\u002Fstrong>（`.NET 8`、`Aspire 13`、`VS Code 1.96`）\n- \u003Cstrong>任务意图\u003C\u002Fstrong>（`quickstart`、`tutorial`、`overview`、`limits`、`API reference`）\n- 针对多语言文档的 \u003Cstrong>语言\u003C\u002Fstrong>（`Python`、`TypeScript`、`C#`）\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**免责声明**：\n本文件由 AI 翻译服务 [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator) 翻译完成。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。原始语言版文件应视为权威来源。对于重要信息，建议使用专业人工翻译。我们对因使用本翻译而产生的任何误解或误释不承担责任。\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->",{"name":5},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Fzh-CN\u002F.agents\u002Fskills\u002Fmicrosoft-docs",26019,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners","https:\u002F\u002Faka.ms\u002Fai-agents-beginners","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-07 12:51:12",{"source":7,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":46,"command":47},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":49,"command":50},"pnpm","pnpm dlx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-CN\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",true,[],[55,71,77,85,93,100],{"skillNo":56,"name":57,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":68,"publishedAt":25},"01M69A206TRZ8KK0CW0HYJF5V5","testing-course-samples","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[60,63],{"categoryNo":61,"categoryName":62,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":64,"categoryName":65,"taxonomyType":66,"taxonomyTypeDesc":67},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[69,70],"testing","testing course samples",{"skillNo":72,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":76,"publishedAt":25},"01M69A1XRB2SFHYRMEH0K08EKZ","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[75],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[23,8,24],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":25},"01M69A1VPZFJQ1HNGTZQ5P3WSC","local-ai-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Flocal-ai-agents\u002FSKILL.md",[],[83,84],"ai agents","local ai agents",{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":25},"01M69A1S947N7MM6V9JF85S2E7","jupyter-notebook","當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[92],"jupyter notebook",{"skillNo":94,"name":95,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":25},"01M69A1Q8EXPWKZSQK69V6WF22","deploying-scalable-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[99],"deploying scalable agents",{"skillNo":101,"name":102,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":25},"01M69A1MHZTH3RH9N8VYSYG74X","azure-openai-to-responses","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fazure-openai-to-responses\u002FSKILL.md",[],[106],"azure openai to responses"]