Microsoft Microsoft Docs
ทักษะการค้นคว้าสำหรับระบบนิเวศเทคโนโลยีของ Microsoft ครอบคลุม learn.microsoft.com และเอกสารที่อยู่นอกเว็บไซต์นั้น (VS Code, GitHub, Aspire, ที่เก็บ Agent Framework).
Default: 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 หลังการค้นหาเมื่อคุณต้องการบทแนะนำครบถ้วน ตัวเลือกการกำหนดค่าทั้งหมด หรือตอนที่ข้อความย่อจากการค้นหาถูกตัดทอนไป
Exceptions: When to Use Other Tools
หมวดหมู่ต่อไปนี้อยู่ นอก learn.microsoft.com ให้ใช้เครื่องมือที่ระบุแทน
.NET Aspire — Use Aspire MCP Server (preferred) or 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 — Use Context7
เอกสาร VS Code อยู่บน code.visualstudio.com ไม่ใช่ Learn
| Library ID | Use for |
|---|---|
/websites/code_visualstudio |
เอกสารผู้ใช้ — การตั้งค่า, คุณสมบัติ, การดีบัก, การพัฒนาแบบระยะไกล |
/websites/code_visualstudio_api |
Extension API — webviews, TreeViews, คำสั่ง, จุดการขยาย |
GitHub — Use 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 — Use Learn MCP + Context7
บทแนะนำ Agent Framework อยู่บน learn.microsoft.com (ใช้ microsoft_docs_search) แต่ที่เก็บ GitHub repo มีรายละเอียดระดับ API ที่มักล้ำหน้ากว่าเอกสารที่เผยแพร่อยู่ — โดยเฉพาะ DevUI REST API reference, ตัวเลือก 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 tip: ค้นหาแหล่งที่มาบนเว็บไซต์ Learn สำหรับคำแนะนำแบบ how-to แล้วดูแหล่งที่มาจาก repo สำหรับรายละเอียดระดับ API (schemas ของ endpoint, การกำหนดค่า proxy, โทเค็นการยืนยันตัวตน)
Context7 Setup
สำหรับการค้นหา Context7 ใดๆ ให้ระบุ library ID ก่อน (ครั้งเดียวต่อเซสชัน):
- Call
mcp_context7_resolve-library-idwith the technology name - Call
mcp_context7_query-docswith the returned library ID and a specific query
Writing Effective Queries
การระบุให้ชัดเจน — รวมเวอร์ชัน เจตนา และภาษา:
# ❌ 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. แม้ว่าเราจะพยายามให้การแปลมีความถูกต้อง โปรดทราบว่าการแปลโดยอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่แม่นยำ เอกสารต้นฉบับในภาษาเดิมควรถือเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่มีความสำคัญ ขอแนะนำให้ใช้การแปลโดยนักแปลมนุษย์มืออาชีพ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดใด ๆ ที่เกิดจากการใช้การแปลฉบับนี้
Source: microsoft/ai-agents-for-beginners → translations/th/.agents/skills/microsoft-docs/SKILL.md