Agent Framework Azure AI Py
microsoft/skills
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai).
查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP，對於存在於 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。
Install Microsoft Docs
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .claude/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .claude/skills/microsoft-docs && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .claude/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .agents/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .agents/skills/microsoft-docs && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .agents/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .cursor/skills/microsoft-docs && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .cursor/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/microsoft/ai-agents-for-beginners.git --path translations/zh-MO/.agents/skills/microsoft-docs--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .gemini/skills/microsoft-docs && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .gemini/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .github/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .github/skills/microsoft-docs && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .github/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/translations/zh-MO/.agents/skills/microsoft-docs .opencode/skills/microsoft-docs && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-MO/.agents/skills/microsoft-docs into .opencode/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
microsoft-docs- GitHub stars
- 77k
- Token cost
- ~1k tokens
- SKILL.md length
- 320 words
- Files
- 1
- Skills in repo
- 123
- Repo updated
- First seen
- Licence
- MIT
At a glance
查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP，對於存在於 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。
- Works in 2 steps: 使用技術名稱呼叫 mcp_context7_resolve-library-id → 使用回傳的 library ID 及特定查詢呼叫…
- Tasks that involve Building AI agents
- SKILL.md covers 預設：Microsoft Learn MCP, 例外情況：何時使用其他工具, Context7 設定 and 撰寫有效查詢
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Microsoft Docs is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization. 查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP，對於存在於 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in AI & LLM Engineering, covering Building AI agents and MCP servers. It works with Model Context Protocol, Visual Studio Code, Microsoft Azure and GitHub. The repository describes itself as: 18 Lessons to Get Started Building AI Agents. The licence is MIT.
When your agent uses it
- Tasks that involve Building AI agents
- Tasks that involve MCP servers
Example prompts
- “/microsoft-docs”
Requirements
- Python 3
- Node.js
Workflow steps
2 steps, taken from the first numbered list in SKILL.md.
- 使用技術名稱呼叫 mcp_context7_resolve-library-id
- 使用回傳的 library ID 及特定查詢呼叫 mcp_context7_query-docs
What it can do on your machine
Read from SKILL.md and the folder at commit 25b7985. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.comdavidpine.dev
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Microsoft Docs loads about 1k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 320 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from microsoft/ai-agents-for-beginners at commit 25b7985, republished under its MIT licence (© microsoft). 320 words, ~1,029 tokens.
Download SKILL.mdSave it as
.claude/skills/microsoft-docs/SKILL.md (or your agent's skills folder).- name
- microsoft-docs
- description
- 查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP，對於存在於 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。
Microsoft 文件
Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).
預設：Microsoft Learn MCP
Use these tools for everything on learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries.
| 工具 | 用途 |
|---|---|
microsoft_docs_search | 搜尋 learn.microsoft.com — 概念、指南、教學、設定 |
microsoft_code_sample_search | 從 Learn 文件中尋找可執行的程式碼片段。傳入 language（python、csharp 等）以獲得最佳結果 |
microsoft_docs_fetch | 從指定 URL 取得完整頁面內容（當搜尋節錄不足時） |
Use microsoft_docs_fetch after search when you need complete tutorials, all config options, or when search excerpts are truncated.
例外情況：何時使用其他工具
The following categories live outside learn.microsoft.com. Use the specified tool instead.
.NET Aspire — 使用 Aspire MCP Server（建議）或 Context7
Aspire 文件位於 aspire.dev，而非 Learn。最佳工具取決於你的 Aspire CLI 版本：
CLI 13.2+（建議）— Aspire MCP 伺服器包含內建的文件搜尋工具：
| MCP 工具 | 描述 |
|---|---|
list_docs | 列出來自 aspire.dev 的所有可用文件 |
search_docs | 在 aspire.dev 內容中進行加權詞彙搜尋 |
get_doc | 以 slug 取得特定文件 |
These ship in Aspire CLI 13.2 (PR #14028). To update: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — The MCP server provides integration lookup (list_integrations, get_integration_docs) but not docs search. Fall back to Context7:
| Library ID | 使用於 |
|---|---|
/microsoft/aspire.dev | 主要 — 指南、整合、CLI 參考、部署 |
/dotnet/aspire | 執行時來源 — API 內部、實作細節 |
/communitytoolkit/aspire | 社群整合 — Go、Java、Node.js、Ollama |
VS Code — 使用 Context7
VS Code 文件位於 code.visualstudio.com，而非 Learn。
| Library ID | 使用於 |
|---|---|
/websites/code_visualstudio | 使用者文件 — 設定、功能、偵錯、遠端開發 |
/websites/code_visualstudio_api | 擴充功能 API — web 檢視、樹狀檢視、指令、貢獻點 |
GitHub — 使用 Context7
GitHub 文件位於 docs.github.com 與 cli.github.com。
| Library ID | 使用於 |
|---|---|
/websites/github_en | Actions、API、儲存庫、資安、管理、Copilot |
/websites/cli_github | GitHub CLI (gh) 的指令與旗標 |
Agent Framework — 使用 Learn MCP + Context7
Agent Framework 的教學位於 learn.microsoft.com（使用 microsoft_docs_search），但 GitHub 倉庫 擁有常常比已發佈文件更新的 API 細節 — 尤其是 DevUI REST API 參考、CLI 選項，以及 .NET 整合。
| Library ID | 使用於 |
|---|---|
/websites/learn_microsoft_en-us_agent-framework | 教學 — DevUI 指南、追蹤、工作流程編排 |
/microsoft/agent-framework | API 細節 — DevUI REST 端點、CLI 旗標、驗證、.NET AddDevUI/MapDevUI |
DevUI 提示： 先查詢 Learn 網站的來源以取得操作指南，然後再查閱倉庫來源以獲取 API 級別的具體內容（端點模式、代理設定、驗證令牌）。
Context7 設定
For any Context7 query, resolve the library ID first (one-time per session):
- 使用技術名稱呼叫
mcp_context7_resolve-library-id - 使用回傳的 library ID 及特定查詢呼叫
mcp_context7_query-docs
撰寫有效查詢
Be specific — include version, intent, and language:
# ❌ Too broad
"Azure Functions"
"agent framework"
# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"Include context:
- 版本（視情況）（
.NET 8、Aspire 13、VS Code 1.96） - 任務目的（
quickstart、tutorial、overview、limits、API reference） - 語言（針對多語系文件）（
Python、TypeScript、C#）
<!-- CO-OP TRANSLATOR DISCLAIMER START -->免責聲明： 本文件已使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而造成的任何誤解或誤譯承擔責任。
<!-- CO-OP TRANSLATOR DISCLAIMER END -->© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in translations/zh-MO/.agents/skills/microsoft-docs of microsoft/ai-agents-for-beginners.
Open the folder on GitHubat commit 25b7985
Compare with similar skills
Microsoft Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Microsoft Docs this skillmicrosoft/ai-agents-for-beginners | 77k | — | ~1k | Automated safety check: Pass | MIT | |
| Agent Framework Azure AI Pymicrosoft/skills | 3.1k | 1 repos | ~3.1k | Automated safety check: Pass | MIT | |
| Microsoft Skill CreatorMicrosoftDocs/mcp | 1.9k | 3 repos | ~2.1k | Automated safety check: Pass | CC-BY-4.0 | |
| Agent Frameworkjihadkhawaja/Egroo | 178 | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Copilot SDKgithub/awesome-copilot | 40k | 5 repos | ~6.3k | Automated safety check: Pass | MIT | |
| Microsoft DocsMicrosoftDocs/mcp | 1.9k | 1 repos | ~723 | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
- Official
- Official
Microsoft Skill Creator
MicrosoftDocs/mcp
Create agent skills for Microsoft technologies using official documentation.
Agent Framework
jihadkhawaja/Egroo
Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).
- Official
Copilot SDK
github/awesome-copilot
Build agentic applications with GitHub Copilot SDK. An agent skill from github/awesome-copilot.
- Official
Microsoft Docs
MicrosoftDocs/mcp
Understand Microsoft technologies by querying official documentation.
Setup Context A8c
woocommerce/woocommerce-ios
Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)
More from microsoft/ai-agents-for-beginners
All 123 skills in this repo- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
A skill your agent uses when the user asks to create, scaffold, or edit Jupyter notebooks (.ipynb) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script…
- Official
Azure Openai To Responses
microsoft/ai-agents-for-beginners
Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.
- Official
Azure Openai To Responses
microsoft/ai-agents-for-beginners
Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
Kasuta, kui kasutaja palub luua, üles ehitada või redigeerida Jupyteri märkmikke (.ipynb) katsetuste, uurimiste või juhendite jaoks; eelista kaasasolevaid malle ja käivita abiskript newnotebook.py…
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
Käytetään, kun käyttäjä pyytää luomaan, alustamaan tai muokkaamaan Jupyter-muistikirjoja (.ipynb) kokeita, tutkimuksia tai opetusohjelmia varten; käytä mieluummin mukana olevia mallipohjia ja…
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
À utiliser lorsque l'utilisateur demande de créer, structurer ou modifier des notebooks Jupyter (.ipynb) pour des expériences, explorations ou tutoriels ; privilégiez les modèles fournis et exécutez…
Related
Categories
Questions about Microsoft Docs
What does Microsoft Docs do?
查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP，對於存在於 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。. Microsoft Docs is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization.
When should I use Microsoft Docs?
Microsoft Docs fits situations like: tasks that involve Building AI agents; tasks that involve MCP servers.
How do I install Microsoft Docs in Claude Code?
Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-code`. Or copy the skill folder (translations/zh-MO/.agents/skills/microsoft-docs in microsoft/ai-agents-for-beginners) into .claude/skills/microsoft-docs in your project. Claude Code loads it when a task matches its description.
How do I install Microsoft Docs in Codex?
Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a codex`. Or copy the skill folder (translations/zh-MO/.agents/skills/microsoft-docs in microsoft/ai-agents-for-beginners) into .agents/skills/microsoft-docs in your project. Codex loads it when a task matches its description.
Can I use Microsoft Docs in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/microsoft-docs, .gemini/skills/microsoft-docs, .github/skills/microsoft-docs and .opencode/skills/microsoft-docs in your project.
What does Microsoft Docs need to run?
SKILL.md names no scripts, command-line tools or credentials: Microsoft Docs is instructions for the agent only. Our summary lists: Python 3; Node.js.
Does Microsoft Docs access the network?
SKILL.md names 2 domains. As links in the text: github.com and davidpine.dev. This is read from the text; nothing was executed.
Is Microsoft Docs safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Microsoft Docs use?
Microsoft Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Microsoft Docs use?
About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Microsoft Docs?
Skills that share tags, products or a category with Microsoft Docs: Agent Framework Azure AI Py (microsoft/skills, 3.1k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Agent Framework (jihadkhawaja/Egroo, 178 stars) and Copilot SDK (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Microsoft Docs?
microsoft (a GitHub organization, an official publisher) maintains it in microsoft/ai-agents-for-beginners, which has 76,612 GitHub stars. The repository holds 123 skills in this directory. The repository was last updated on September 19, 2026.
Source: microsoft/ai-agents-for-beginners on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.