thedixitjain Microsoft Docs
Kỹ năng nghiên cứu cho hệ sinh thái công nghệ Microsoft. Bao gồm learn.microsoft.com và tài liệu nằm ngoài trang đó (VS Code, GitHub, Aspire, các repo Agent Framework).
Mặc định: Microsoft Learn MCP
Sử dụng những công cụ này cho mọi thứ trên learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, và hơn thế nữa. Đây là công cụ chính cho phần lớn các truy vấn về tài liệu Microsoft.
| Tool | Purpose |
|---|---|
microsoft_docs_search |
Tìm kiếm learn.microsoft.com — khái niệm, hướng dẫn, bài học, cấu hình |
microsoft_code_sample_search |
Tìm các đoạn mã hoạt động từ tài liệu Learn. Truyền language (python, csharp, etc.) để có kết quả tốt nhất |
microsoft_docs_fetch |
Lấy toàn bộ nội dung trang từ một URL cụ thể (khi đoạn trích tìm kiếm không đủ) |
Sử dụng microsoft_docs_fetch sau khi tìm kiếm khi bạn cần hướng dẫn đầy đủ, tất cả các tùy chọn cấu hình, hoặc khi các đoạn trích tìm kiếm bị rút gọn.
Ngoại lệ: Khi nào sử dụng các công cụ khác
Các danh mục sau nằm bên ngoài learn.microsoft.com. Hãy sử dụng công cụ được chỉ định thay thế.
.NET Aspire — Sử dụng Aspire MCP Server (ưu tiên) hoặc Context7
Tài liệu Aspire nằm trên aspire.dev, không phải Learn. Công cụ tốt nhất phụ thuộc vào phiên bản Aspire CLI của bạn:
CLI 13.2+ (khuyến nghị) — Aspire MCP server bao gồm các công cụ tìm kiếm tài liệu tích hợp:
| MCP Tool | Description |
|---|---|
list_docs |
Liệt kê tất cả tài liệu có sẵn từ aspire.dev |
search_docs |
Tìm kiếm từ vựng có trọng số trên nội dung của aspire.dev |
get_doc |
Lấy một tài liệu cụ thể theo slug |
Những công cụ này được phát hành trong Aspire CLI 13.2 (PR #14028). Để cập nhật: aspire update --self --channel daily. Tham khảo: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — MCP server cung cấp tra cứu tích hợp (list_integrations, get_integration_docs) nhưng không có tìm kiếm tài liệu. Quay về dùng Context7:
| Library ID | Use for |
|---|---|
/microsoft/aspire.dev |
Chính — hướng dẫn, tích hợp, tham chiếu CLI, triển khai |
/dotnet/aspire |
Nguồn runtime — nội bộ API, chi tiết triển khai |
/communitytoolkit/aspire |
Tích hợp cộng đồng — Go, Java, Node.js, Ollama |
VS Code — Sử dụng Context7
Tài liệu VS Code nằm trên code.visualstudio.com, không phải Learn.
| Library ID | Use for |
|---|---|
/websites/code_visualstudio |
Tài liệu người dùng — cài đặt, tính năng, gỡ lỗi, phát triển từ xa |
/websites/code_visualstudio_api |
API phần mở rộng — webviews, TreeViews, lệnh, điểm đóng góp |
GitHub — Sử dụng Context7
Tài liệu GitHub nằm trên docs.github.com và cli.github.com.
| Library ID | Use for |
|---|---|
/websites/github_en |
Actions, API, kho lưu trữ, bảo mật, quản trị, Copilot |
/websites/cli_github |
Lệnh và cờ của GitHub CLI (gh) |
Agent Framework — Sử dụng Learn MCP + Context7
Các hướng dẫn Agent Framework có trên learn.microsoft.com (sử dụng microsoft_docs_search), nhưng repo GitHub có chi tiết ở cấp API thường đi trước tài liệu đã xuất bản — đặc biệt là tham chiếu DevUI REST API, tùy chọn CLI, và tích hợp .NET.
| Library ID | Use for |
|---|---|
/websites/learn_microsoft_en-us_agent-framework |
Hướng dẫn — hướng dẫn DevUI, theo dõi, điều phối luồng công việc |
/microsoft/agent-framework |
Chi tiết API — endpoint REST DevUI, cờ CLI, xác thực, .NET AddDevUI/MapDevUI |
DevUI tip: Truy vấn nguồn trang Learn để lấy các hướng dẫn cách làm, sau đó truy vấn nguồn repo để biết các chi tiết ở cấp API (endpoint schemas, proxy config, auth tokens).
Thiết lập Context7
Đối với bất kỳ truy vấn Context7 nào, hãy phân giải library ID trước (một lần cho mỗi phiên):
- Gọi
mcp_context7_resolve-library-idvới tên công nghệ - Gọi
mcp_context7_query-docsvới ID thư viện trả về và một truy vấn cụ thể
Viết truy vấn hiệu quả
Hãy cụ thể — bao gồm phiên bản, mục đích và ngôn ngữ:
# ❌ 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 khi cần thiết (
.NET 8,Aspire 13,VS Code 1.96) - Mục đích tác vụ (
quickstart,tutorial,overview,limits,API reference) - Ngôn ngữ cho tài liệu đa ngôn ngữ (
Python,TypeScript,C#)
Miễn trừ trách nhiệm: Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI Co-op Translator. Mặc dù chúng tôi nỗ lực đảm bảo độ chính xác, xin lưu ý rằng bản dịch tự động có thể chứa lỗi hoặc không chính xác. Văn bản gốc bằng ngôn ngữ ban đầu nên được coi là nguồn có thẩm quyền. Đối với thông tin quan trọng, khuyến nghị sử dụng dịch vụ dịch thuật chuyên nghiệp do người thực hiện. Chúng tôi không chịu trách nhiệm về bất kỳ hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này.
Source: microsoft/ai-agents-for-beginners → translations/vi/.agents/skills/microsoft-docs/SKILL.md