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。
$ 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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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-TW/.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.
microsoft-docs查詢官方 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. 查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。
Its SKILL.md is about 960 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.
2 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 25b7985. It shows what the files ask for, not the result of running them.
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.
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.
Links to these hosts (documentation or services it may open):
github.comdavidpine.devFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Microsoft Docs loads about 962 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 257 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.
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.
The full file from microsoft/ai-agents-for-beginners at commit 25b7985, republished under its MIT licence (© microsoft). 257 words, ~962 tokens.
.claude/skills/microsoft-docs/SKILL.md (or your agent's skills folder).研究 Microsoft 技術生態系的搜尋技能。涵蓋 learn.microsoft.com 以及存在於其外的文件(VS Code、GitHub、Aspire、Agent Framework 倉庫)。
對於 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 之外。請改用指定的工具。
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 文件位於 code.visualstudio.com,非 Learn。
| Library ID | Use for |
|---|---|
/websites/code_visualstudio | 使用者文件 — 設定、功能、偵錯、遠端開發 |
/websites/code_visualstudio_api | 擴充功能 API — webviews、TreeViews、commands、contribution points |
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.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 查詢,請先解析 library ID(每個工作階段一次性):
mcp_context7_resolve-library-id 並傳入技術名稱mcp_context7_query-docs請具體 — 包含版本、目的與語言:
# ❌ 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(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
Just SKILL.md in translations/zh-TW/.agents/skills/microsoft-docs of microsoft/ai-agents-for-beginners.
Open the folder on GitHubat commit 25b7985
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 | — | ~962 | 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 |
microsoft/skills
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai).
MicrosoftDocs/mcp
Create agent skills for Microsoft technologies using official documentation.
jihadkhawaja/Egroo
Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).
github/awesome-copilot
Build agentic applications with GitHub Copilot SDK. An agent skill from github/awesome-copilot.
MicrosoftDocs/mcp
Understand Microsoft technologies by querying official documentation.
woocommerce/woocommerce-ios
Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)
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…
microsoft/ai-agents-for-beginners
Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.
microsoft/ai-agents-for-beginners
Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.
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…
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…
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…
Categories
查詢官方 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.
Microsoft Docs fits situations like: tasks that involve Building AI agents; tasks that involve MCP servers.
Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-code`. Or copy the skill folder (translations/zh-TW/.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.
Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a codex`. Or copy the skill folder (translations/zh-TW/.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.
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.
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.
SKILL.md names 2 domains. As links in the text: github.com and davidpine.dev. This is read from the text; nothing was executed.
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.
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.
About 962 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.
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.
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.