thedixitjain Microsoft Docs
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 | 용도 |
|---|---|
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 | 설명 |
|---|---|
list_docs |
aspire.dev의 사용 가능한 모든 문서를 나열합니다 |
search_docs |
aspire.dev 콘텐츠에 대한 가중치 기반 어휘 검색 |
get_doc |
슬러그로 특정 문서를 검색합니다 |
이 기능들은 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 | 사용 용도 |
|---|---|
/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 — webviews, TreeViews, 명령, 기여 포인트 |
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 팁: how-to 가이드는 Learn 웹사이트 소스에서 조회하고, API 수준의 세부사항(엔드포인트 스키마, 프록시 구성, 인증 토큰)은 리포지토리 소스에서 조회하세요.
Context7 설정
Context7 쿼리에서는 세션당 한 번 라이브러리 ID를 먼저 확인하세요:
- 기술 이름으로
mcp_context7_resolve-library-id를 호출합니다 - 반환된 라이브러리 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#)
면책 조항: 이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있으나 자동 번역에는 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원문(원어로 된 문서)을 권위 있는 출처로 간주하시기 바랍니다. 중요한 정보의 경우에는 전문적인 인간 번역을 권장합니다. 본 번역의 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.
Source: microsoft/ai-agents-for-beginners → translations/ko/.agents/skills/microsoft-docs/SKILL.md