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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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-CN/.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
- ~948 tokens
- SKILL.md length
- 249 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 并传入技术名称 → 调用 mcp_context7_query-docs 并使用返回的…
- 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 950 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 Visual Studio Code, Model Context Protocol, 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 并传入技术名称
- 调用 mcp_context7_query-docs 并使用返回的 library ID 以及具体查询
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 948 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 249 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). 249 words, ~948 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 文档
研究 Microsoft 技术生态系统的检索技能。涵盖 learn.microsoft.com 以及存在于其外部的文档（VS Code、GitHub、Aspire、Agent Framework 仓库）。
默认：Microsoft Learn MCP
对 learn.microsoft.com 上的所有内容使用这些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等等。对于绝大多数 Microsoft 文档查询，这是主要工具。
| Tool | Purpose |
|---|---|
microsoft_docs_search | 在 learn.microsoft.com 上搜索 —— 概念、指南、教程、配置 |
microsoft_code_sample_search | 查找来自 Learn 文档的可运行代码片段。传入 language（python、csharp 等）以获得最佳结果 |
microsoft_docs_fetch | 从特定 URL 获取完整页面内容（当搜索摘录不足时） |
当需要完整教程、所有配置选项或搜索摘录被截断时，在搜索之后使用 microsoft_docs_fetch。
例外：何时使用其他工具
以下类别位于 learn.microsoft.com 之外。请改用指定的工具。
.NET Aspire — 使用 Aspire MCP Server（首选）或 Context7
Aspire 文档位于 aspire.dev，而不是 Learn。最佳工具取决于你的 Aspire CLI 版本：
CLI 13.2+（推荐）—— Aspire MCP 服务器包含内置的文档搜索工具：
| MCP Tool | Description |
|---|---|
list_docs | 列出来自 aspire.dev 的所有可用文档 |
search_docs | 跨 aspire.dev 内容的加权词汇搜索 |
get_doc | 按 slug 检索特定文档 |
这些包含于 Aspire CLI 13.2（PR #14028）。要更新：aspire update --self --channel daily。参考： https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 —— MCP 服务器提供集成查找（list_integrations, get_integration_docs），但不提供文档搜索。回退使用 Context7：
| Library ID | Use for |
|---|---|
/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 | Use for |
|---|---|
/websites/code_visualstudio | 用户文档 —— 设置、功能、调试、远程开发 |
/websites/code_visualstudio_api | 扩展 API —— webviews、TreeViews、命令、贡献点 |
GitHub — 使用 Context7
GitHub 文档位于 docs.github.com 和 cli.github.com。
| Library ID | Use for |
|---|---|
/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 | Use for |
|---|---|
/websites/learn_microsoft_en-us_agent-framework | 教程 —— DevUI 指南、追踪、工作流编排 |
/microsoft/agent-framework | API 细节 —— DevUI REST 端点、CLI 标志、身份验证、.NET AddDevUI/MapDevUI |
DevUI 提示： 先查询 Learn 网站源码以获取操作指南，然后查询仓库源码以获取 API 级别的具体信息（端点模式、代理配置、身份验证令牌）。
Context7 设置
对于任何 Context7 查询，首先解析 library ID（每会话一次）：
- 调用
mcp_context7_resolve-library-id并传入技术名称 - 调用
mcp_context7_query-docs并使用返回的 library ID 以及具体查询
编写有效的查询
要具体 —— 包含版本、意图和语言：
# ❌ 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:
- Version when relevant (
.NET 8,Aspire 13,VS Code 1.96) - Task intent (
quickstart,tutorial,overview,limits,API reference) - Language for polyglot docs (
Python,TypeScript,C#)
<!-- CO-OP TRANSLATOR DISCLAIMER START -->免责声明： 本文件已使用 AI 翻译服务 Co‑op Translator（https://github.com/Azure/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-CN/.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 | — | ~948 | 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-CN/.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-CN/.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 948 tokens (SKILL.md is roughly 3.8k 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.