[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69A10MRJTN0S5SWQD5DCWDZ":3,"skill-same:01M69A10MRJTN0S5SWQD5DCWDZ":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":29,"linkOnly":30,"markdownContent":31,"markdownBody":32,"frontMatter":33,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":39,"ownerHtmlUrl":40,"ownerBlogUrl":41,"ownerDescription":42,"updatedAt":43,"install":44,"resources":57},"01M69A10MRJTN0S5SWQD5DCWDZ","microsoft-docs",null,"查詢官方微軟文件，以尋找涵蓋 Azure、.NET、代理框架、Aspire、VS Code、GitHub 等的概念、教學和範例程式碼。預設使用 Microsoft Learn MCP，對於那些不在 learn.microsoft.com 上的內容，則使用 Context7 和 Aspire MCP。","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-HK\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,9,25,26,27,28],"docs","microsoft docs","MCP","github","aspire","2026-11-10 10:12:30",false,"---\nname: microsoft-docs\ndescription: 查詢官方微軟文件，以尋找涵蓋 Azure、.NET、代理框架、Aspire、VS Code、GitHub 等的概念、教學和範例程式碼。預設使用\n  Microsoft Learn MCP，對於那些不在 learn.microsoft.com 上的內容，則使用 Context7 和 Aspire MCP。\n---\n# Microsoft Docs\n\nMicrosoft 技術生態系的研究技能。涵蓋 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 等。這是絕大多數 Microsoft 文件查詢的主要工具。\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 伺服器（首選）或 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 — 網頁檢視、樹狀檢視、命令、貢獻點 |\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`），但 **GitHub 倉庫** 擁有比發佈文件更前沿的 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 網站來源以獲得操作指南，再查 GitHub 倉庫來源了解 API 細節（端點結構、代理配置、驗證令牌）。\n\n---\n\n## Context7 設定\n\n對任何 Context7 查詢，首先解析函式庫 ID（每次會話一次）：\n\n1. 呼叫 `mcp_context7_resolve-library-id` 傳入技術名稱\n2. 呼叫 `mcp_context7_query-docs` 傳入回傳函式庫 ID 及特定查詢\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\nMicrosoft 技術生態系的研究技能。涵蓋 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 等。這是絕大多數 Microsoft 文件查詢的主要工具。\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 伺服器（首選）或 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 — 網頁檢視、樹狀檢視、命令、貢獻點 |\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`），但 **GitHub 倉庫** 擁有比發佈文件更前沿的 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 網站來源以獲得操作指南，再查 GitHub 倉庫來源了解 API 細節（端點結構、代理配置、驗證令牌）。\n\n---\n\n## Context7 設定\n\n對任何 Context7 查詢，首先解析函式庫 ID（每次會話一次）：\n\n1. 呼叫 `mcp_context7_resolve-library-id` 傳入技術名稱\n2. 呼叫 `mcp_context7_query-docs` 傳入回傳函式庫 ID 及特定查詢\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,"description":7},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Fzh-HK\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":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":50,"command":51},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":53,"command":54},"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-HK\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",true,[],[59,75,81,89,97,104],{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":72,"publishedAt":29},"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",[64,67],{"categoryNo":65,"categoryName":66,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":68,"categoryName":69,"taxonomyType":70,"taxonomyTypeDesc":71},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[73,74],"testing","testing course samples",{"skillNo":76,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":80,"publishedAt":29},"01M69A1XRB2SFHYRMEH0K08EKZ","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[79],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[24,9,25],{"skillNo":82,"name":83,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":29},"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",[],[87,88],"ai agents","local ai agents",{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":29},"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",[],[96],"jupyter notebook",{"skillNo":98,"name":99,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":29},"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",[],[103],"deploying scalable agents",{"skillNo":105,"name":106,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":29},"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",[],[110],"azure openai to responses"]