gabrielmoreira Microsoft Docs
مائیکروسوفٹ ٹیکنالوجی ایکوسسٹم کے لیے تحقیقاتی مہارت۔ 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_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+ (recommended) — The Aspire MCP server includes built-in docs search tools:
| MCP ٹول | تفصیل |
|---|---|
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 پر واپس جائیں:
| لائبریری ID | استعمال کے لیے |
|---|---|
/microsoft/aspire.dev |
پرائمری — رہنما، انٹیگریشنز، CLI حوالہ، ڈیپلائمنٹ |
/dotnet/aspire |
رن ٹائم ماخذ — API اندرونی اجزا، نفاذ کی تفصیلات |
/communitytoolkit/aspire |
کمیونٹی انٹیگریشنز — Go، Java، Node.js، Ollama |
VS Code — Use Context7
VS Code کی دستاویزات code.visualstudio.com پر ہیں، Learn پر نہیں۔
| لائبریری ID | استعمال کے لیے |
|---|---|
/websites/code_visualstudio |
یوزر دستاویزات — سیٹنگز، خصوصیات، ڈیبگنگ، ریموٹ ڈیولپمنٹ |
/websites/code_visualstudio_api |
ایکسٹینشن API — webviews، TreeViews، کمانڈز، کنٹریبیوشن پوائنٹس |
GitHub — Use Context7
GitHub کی دستاویزات docs.github.com اور cli.github.com پر ہیں۔
| لائبریری ID | استعمال کے لیے |
|---|---|
/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 حوالہ، CLI اختیارات، اور .NET انٹیگریشن۔
| لائبریری ID | استعمال کے لیے |
|---|---|
/websites/learn_microsoft_en-us_agent-framework |
ٹیوٹوریلز — DevUI رہنما، ٹریسنگ، ورک فلو آرکسٹراشن |
/microsoft/agent-framework |
API تفصیل — DevUI REST اینڈ پوائنٹس، CLI فلیگز، auth، .NET AddDevUI/MapDevUI |
DevUI tip: How-to گائیڈز کے لیے Learn ویب سائٹ سورس کو کوئری کریں، پھر API سطح کی مخصوصیات (endpoint اسکیمیں، proxy ترتیب، auth ٹوکنز) کے لیے repo سورس دیکھیں۔
Context7 Setup
کسی بھی Context7 سوال کے لیے، پہلے لائبریری ID کو حل کریں (سیشن میں ایک بار):
- ٹیکنالوجی کے نام کے ساتھ
mcp_context7_resolve-library-idکال کریں - واپسی کردہ لائبریری ID اور مخصوص سوال کے ساتھ
mcp_context7_query-docsکال کریں
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"
سیاق و سباق شامل کریں:
- ورژن جب متعلقہ ہو (
.NET 8,Aspire 13,VS Code 1.96) - کام کا مقصد (
quickstart,tutorial,overview,limits,API reference) - زبان کثیر لسانی ڈاکس کے لیے (
Python,TypeScript,C#)
استثنیٰ: یہ دستاویز AI ترجمہ سروس Co-op Translator کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لئے کوشاں ہیں، براہِ کرم نوٹ کریں کہ خودکار تراجم میں غلطیاں یا عدمِ درستگی ہو سکتی ہے۔ اصل دستاویز کو اس کی مادری زبان میں معتبر ماخذ سمجھا جانا چاہیے۔ اہم معلومات کے لیے پیشہ ورانہ انسانی ترجمہ کی سفارش کی جاتی ہے۔ ہم اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تعبیر کے لیے ذمہ دار نہیں ہیں۔