[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6999XDV1ECNKEE6Z3CKVPR6":3,"skill-same:01M6999XDV1ECNKEE6Z3CKVPR6":64},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":37,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M6999XDV1ECNKEE6Z3CKVPR6","microsoft-docs",null,"microsoft\u002Fai-agents-for-beginners","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998ZK2275KMJE6Y5SEA2X2",79567,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Far\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,8,24],"docs","microsoft docs","2026-11-10 10:12:30",false,"---\nname: microsoft-docs\n---\n# مستندات مايكروسوفت\n\nمهارة البحث لنظام تكنولوجيا مايكروسوفت. تغطي learn.microsoft.com والمستندات التي تقع خارجها (VS Code، GitHub، Aspire، مستودعات Agent Framework).\n\n---\n\n## الافتراضي: Microsoft Learn MCP\n\nاستخدم هذه الأدوات لـ **كل شيء على learn.microsoft.com** — أزور، .NET، M365، Power Platform، Agent Framework، Semantic Kernel، ويندوز، وأكثر. هذه هي الأداة الأساسية لمعظم استعلامات مستندات مايكروسوفت.\n\n| الأداة | الغرض |\n|------|---------|\n| `microsoft_docs_search` | البحث في learn.microsoft.com — المفاهيم، الأدلة، البرامج التعليمية، التكوين |\n| `microsoft_code_sample_search` | إيجاد مقتطفات كود تعمل من مستندات Learn. مرر `language` (`python`، `csharp`، إلخ) لأفضل النتائج |\n| `microsoft_docs_fetch` | الحصول على محتوى الصفحة كاملة من عنوان URL محدد (عندما لا تكفي مقتطفات البحث) |\n\nاستخدم `microsoft_docs_fetch` بعد البحث عندما تحتاج إلى برامج تعليمية كاملة، كل خيارات التكوين، أو عندما تُقتطع مقتطفات البحث.\n\n---\n\n## استثناءات: متى تستخدم أدوات أخرى\n\nالفئات التالية تقع **خارج** learn.microsoft.com. استخدم الأداة المحددة بدلاً من ذلك.\n\n### Aspire — استخدم Aspire MCP Server (المفضل) أو Context7\n\nمستندات Aspire تقع على **aspire.dev**، ليست في Learn. أفضل أداة تعتمد على إصدار Aspire CLI الخاص بك:\n\n**CLI 13.2+** (مستحسن) — يتضمن خادم Aspire MCP أدوات بحث مستندات مضمنة:\n\n| أداة MCP | الوصف |\n|----------|-------------|\n| `list_docs` | يعرض كل المستندات المتاحة من aspire.dev |\n| `search_docs` | بحث لغوي موزون عبر محتوى aspire.dev |\n| `get_doc` | يستعيد مستند معين بواسطة slug |\n\nهذه الأدوات تُشحن مع Aspire CLI 13.2 ([PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)). للتحديث: `aspire update --self --channel daily`.\n\n**CLI 13.1** — يوفر خادم MCP بحث تكامل (`list_integrations`، `get_integration_docs`) لكن **لا** يوفر بحث مستندات. استخدم Context7 بدلاً من ذلك:\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | أساسي — أدلة، تكاملات، مرجع CLI، النشر |\n| `\u002Fmicrosoft\u002Faspire` | مصادر وقت التشغيل — تفاصيل API، تفاصيل التنفيذ |\n| `\u002Fcommunitytoolkit\u002Faspire` | تكاملات المجتمع — Go، Java، Node.js، Ollama |\n\n### VS Code — استخدم Context7\n\nمستندات VS Code تقع على **code.visualstudio.com**، ليست في Learn.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | مستندات المستخدم — الإعدادات، الميزات، التصحيح، التطوير عن بُعد |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | Extension API — webviews، TreeViews، الأوامر، نقاط المساهمة |\n\n### GitHub — استخدم Context7\n\nمستندات GitHub تقع على **docs.github.com** و **cli.github.com**.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions، API، المستودعات، الأمان، الإدارة، Copilot |\n| `\u002Fwebsites\u002Fcli_github` | أوامر وعلامات GitHub CLI (`gh`) |\n\n### Agent Framework — استخدم Learn MCP + Context7\n\nبرامج Agent Framework التعليمية على learn.microsoft.com (استخدم `microsoft_docs_search`)، لكن **مستودع GitHub** يحتوي على تفاصيل على مستوى API غالبًا ما تتفوق على المستندات المنشورة — خصوصًا مرجع DevUI REST API، خيارات CLI، وتكامل .NET.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | البرامج التعليمية — أدلة DevUI، التتبع، تنظيم سير العمل |\n| `\u002Fmicrosoft\u002Fagent-framework` | تفاصيل API — نقاط نهاية DevUI REST، علامات CLI، المصادقة، .NET `AddDevUI`\u002F`MapDevUI` |\n\n**نصيحة DevUI:** استعلم أولًا من مصدر موقع Learn لأدلة كيفية العمل، ثم من مصدر المستودع لتفاصيل مستوى API (مخططات النقاط النهائية، تكوين البروكسي، رموز المصادقة).\n\n---\n\n## إعداد Context7\n\nلأي استعلام Context7، حل معرف المكتبة أولاً (مرة واحدة لكل جلسة):\n\n1. استدعِ `mcp_context7_resolve-library-id` مع اسم التكنولوجيا\n2. استدعِ `mcp_context7_query-docs` مع معرف المكتبة المُعاد والاستعلام المحدد\n\n---\n\n## كتابة استعلامات فعالة\n\nكن محددًا — ضمن النسخة، الهدف، واللغة:\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\nأضف السياق:\n- **الإصدار** عندما يكون ذا صلة (`.NET 8`، `Aspire 13`، `VS Code 1.96`)\n- **هدف المهمة** (`quickstart`، `tutorial`، `overview`، `limits`، `API reference`)\n- **اللغة** لوثائق متعددة اللغات (`Python`، `TypeScript`، `C#`)\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**تنويه**:\nتمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->","# مستندات مايكروسوفت\n\nمهارة البحث لنظام تكنولوجيا مايكروسوفت. تغطي learn.microsoft.com والمستندات التي تقع خارجها (VS Code، GitHub، Aspire، مستودعات Agent Framework).\n\n---\n\n## الافتراضي: Microsoft Learn MCP\n\nاستخدم هذه الأدوات لـ **كل شيء على learn.microsoft.com** — أزور، .NET، M365، Power Platform، Agent Framework، Semantic Kernel، ويندوز، وأكثر. هذه هي الأداة الأساسية لمعظم استعلامات مستندات مايكروسوفت.\n\n| الأداة | الغرض |\n|------|---------|\n| `microsoft_docs_search` | البحث في learn.microsoft.com — المفاهيم، الأدلة، البرامج التعليمية، التكوين |\n| `microsoft_code_sample_search` | إيجاد مقتطفات كود تعمل من مستندات Learn. مرر `language` (`python`، `csharp`، إلخ) لأفضل النتائج |\n| `microsoft_docs_fetch` | الحصول على محتوى الصفحة كاملة من عنوان URL محدد (عندما لا تكفي مقتطفات البحث) |\n\nاستخدم `microsoft_docs_fetch` بعد البحث عندما تحتاج إلى برامج تعليمية كاملة، كل خيارات التكوين، أو عندما تُقتطع مقتطفات البحث.\n\n---\n\n## استثناءات: متى تستخدم أدوات أخرى\n\nالفئات التالية تقع **خارج** learn.microsoft.com. استخدم الأداة المحددة بدلاً من ذلك.\n\n### Aspire — استخدم Aspire MCP Server (المفضل) أو Context7\n\nمستندات Aspire تقع على **aspire.dev**، ليست في Learn. أفضل أداة تعتمد على إصدار Aspire CLI الخاص بك:\n\n**CLI 13.2+** (مستحسن) — يتضمن خادم Aspire MCP أدوات بحث مستندات مضمنة:\n\n| أداة MCP | الوصف |\n|----------|-------------|\n| `list_docs` | يعرض كل المستندات المتاحة من aspire.dev |\n| `search_docs` | بحث لغوي موزون عبر محتوى aspire.dev |\n| `get_doc` | يستعيد مستند معين بواسطة slug |\n\nهذه الأدوات تُشحن مع Aspire CLI 13.2 ([PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)). للتحديث: `aspire update --self --channel daily`.\n\n**CLI 13.1** — يوفر خادم MCP بحث تكامل (`list_integrations`، `get_integration_docs`) لكن **لا** يوفر بحث مستندات. استخدم Context7 بدلاً من ذلك:\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | أساسي — أدلة، تكاملات، مرجع CLI، النشر |\n| `\u002Fmicrosoft\u002Faspire` | مصادر وقت التشغيل — تفاصيل API، تفاصيل التنفيذ |\n| `\u002Fcommunitytoolkit\u002Faspire` | تكاملات المجتمع — Go، Java، Node.js، Ollama |\n\n### VS Code — استخدم Context7\n\nمستندات VS Code تقع على **code.visualstudio.com**، ليست في Learn.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | مستندات المستخدم — الإعدادات، الميزات، التصحيح، التطوير عن بُعد |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | Extension API — webviews، TreeViews، الأوامر، نقاط المساهمة |\n\n### GitHub — استخدم Context7\n\nمستندات GitHub تقع على **docs.github.com** و **cli.github.com**.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions، API، المستودعات، الأمان، الإدارة، Copilot |\n| `\u002Fwebsites\u002Fcli_github` | أوامر وعلامات GitHub CLI (`gh`) |\n\n### Agent Framework — استخدم Learn MCP + Context7\n\nبرامج Agent Framework التعليمية على learn.microsoft.com (استخدم `microsoft_docs_search`)، لكن **مستودع GitHub** يحتوي على تفاصيل على مستوى API غالبًا ما تتفوق على المستندات المنشورة — خصوصًا مرجع DevUI REST API، خيارات CLI، وتكامل .NET.\n\n| معرف المكتبة | يُستخدم لـ |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | البرامج التعليمية — أدلة DevUI، التتبع، تنظيم سير العمل |\n| `\u002Fmicrosoft\u002Fagent-framework` | تفاصيل API — نقاط نهاية DevUI REST، علامات CLI، المصادقة، .NET `AddDevUI`\u002F`MapDevUI` |\n\n**نصيحة DevUI:** استعلم أولًا من مصدر موقع Learn لأدلة كيفية العمل، ثم من مصدر المستودع لتفاصيل مستوى API (مخططات النقاط النهائية، تكوين البروكسي، رموز المصادقة).\n\n---\n\n## إعداد Context7\n\nلأي استعلام Context7، حل معرف المكتبة أولاً (مرة واحدة لكل جلسة):\n\n1. استدعِ `mcp_context7_resolve-library-id` مع اسم التكنولوجيا\n2. استدعِ `mcp_context7_query-docs` مع معرف المكتبة المُعاد والاستعلام المحدد\n\n---\n\n## كتابة استعلامات فعالة\n\nكن محددًا — ضمن النسخة، الهدف، واللغة:\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\nأضف السياق:\n- **الإصدار** عندما يكون ذا صلة (`.NET 8`، `Aspire 13`، `VS Code 1.96`)\n- **هدف المهمة** (`quickstart`، `tutorial`، `overview`، `limits`، `API reference`)\n- **اللغة** لوثائق متعددة اللغات (`Python`، `TypeScript`، `C#`)\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**تنويه**:\nتمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->",{"name":5},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Far\u002F.agents\u002Fskills\u002Fmicrosoft-docs",26057,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners","https:\u002F\u002Faka.ms\u002Fai-agents-beginners","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-07 12:51:12",{"source":7,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":46,"command":47},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":49,"command":50},"pnpm","pnpm dlx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Far\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",true,[54,60],{"path":55,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":59},"checklist.md","REFERENCE","参考文档",815,"https:\u002F\u002Fgithub.com\u002Fsherryswift1019-gif\u002FAI-DZHT\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fbmad-qa-cost-performance-tracking\u002Fchecklist.md",{"path":61,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":62,"sourceHtmlUrl":63},"workflow.md",4116,"https:\u002F\u002Fgithub.com\u002Fsherryswift1019-gif\u002FAI-DZHT\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fbmad-qa-cost-performance-tracking\u002Fworkflow.md",[65,81,87,95,103,110],{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":78,"publishedAt":25},"01M69A206TRZ8KK0CW0HYJF5V5","testing-course-samples","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[70,73],{"categoryNo":71,"categoryName":72,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":74,"categoryName":75,"taxonomyType":76,"taxonomyTypeDesc":77},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[79,80],"testing","testing course samples",{"skillNo":82,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":86,"publishedAt":25},"01M69A1XRB2SFHYRMEH0K08EKZ","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[85],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[23,8,24],{"skillNo":88,"name":89,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":25},"01M69A1VPZFJQ1HNGTZQ5P3WSC","local-ai-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Flocal-ai-agents\u002FSKILL.md",[],[93,94],"ai agents","local ai agents",{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":25},"01M69A1S947N7MM6V9JF85S2E7","jupyter-notebook","當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[102],"jupyter notebook",{"skillNo":104,"name":105,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":25},"01M69A1Q8EXPWKZSQK69V6WF22","deploying-scalable-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[109],"deploying scalable agents",{"skillNo":111,"name":112,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":25},"01M69A1MHZTH3RH9N8VYSYG74X","azure-openai-to-responses","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fazure-openai-to-responses\u002FSKILL.md",[],[116],"azure openai to responses"]