thedixitjain Microsoft Docs
مهارة بحث لنظام تقنيات Microsoft. تغطي learn.microsoft.com والتوثيق الذي يعيش خارجه (VS Code، GitHub، Aspire، مستودعات Agent Framework).
الافتراضي: Microsoft Learn MCP
Use these tools for كل شيء على 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. استخدم الأداة المحددة بدلاً من ذلك.
.NET Aspire — استخدم Aspire MCP Server (مُفضّل) أو 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 — استخدم Context7
توثيق VS Code موجود على code.visualstudio.com، وليس على Learn.
| Library ID | Use for |
|---|---|
/websites/code_visualstudio |
توثيق المستخدم — الإعدادات، الميزات، التصحيح، التطوير عن بُعد |
/websites/code_visualstudio_api |
Extension API — webviews، TreeViews، الأوامر، نقاط المساهمة |
GitHub — استخدم 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 — استخدم Learn MCP + Context7
دروس 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
بالنسبة لأي استعلام Context7، قم بحل معرّف المكتبة أولاً (مرة واحدة لكل جلسة):
- استدعي
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"
ضمّن السياق:
- الإصدار عندما يكون ذا صلة (
.NET 8,Aspire 13,VS Code 1.96) - هدف المهمة (
quickstart,tutorial,overview,limits,API reference) - اللغة للوثائق متعددة اللغات (
Python,TypeScript,C#)
إخلاء مسؤولية: تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co‑op Translator (https://github.com/Azure/co-op-translator). بينما نسعى إلى الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار الوثيقة الأصلية باللغة الأصلية هي المصدر المعتمد. للمعلومات الحساسة أو الحرجة، يوصى بالاستعانة بترجمة بشرية محترفة. نحن لا نتحمل أي مسؤولية عن سوء الفهم أو التفسيرات الخاطئة الناتجة عن استخدام هذه الترجمة.
Source: microsoft/ai-agents-for-beginners → translations/ar/.agents/skills/microsoft-docs/SKILL.md