https://thedotnetblog.com/ar/tags/bicep/Articles, tutorials and insights from the .NET community.Hugoar@thedotnetblog (The .NET Blog)@thedotnetblogTue, 21 Apr 2026 00:00:00 +0000https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/azd-copilot-integration-ai-setup-troubleshooting/Tue, 21 Apr 2026 00:00:00 +0000Emiliano Montesdeocahttps://thedotnetblog.com/ar/posts/emiliano-montesdeoca/azd-copilot-integration-ai-setup-troubleshooting/يتكامل Azure Developer CLI الآن مع GitHub Copilot لإنشاء بنية المشروع التحتية وحل أخطاء النشر — دون مغادرة الطرفية.<blockquote> <p><em>تُرجِمت هذه المقالة تلقائيًا. للاطلاع على النسخة الأصلية بالإنجليزية، <a href="https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/azd-copilot-integration-ai-setup-troubleshooting/">انقر هنا</a>.</em></p> </blockquote> <p>هل تعرف تلك اللحظة التي تريد فيها نشر تطبيق موجود على Azure فتجد نفسك تحدق في ملف <code>azure.yaml</code> فارغ، محاولًا تذكر ما إذا كان Express API الخاص بك يجب أن يستخدم Container Apps أم App Service؟ تلك اللحظة أصبحت الآن أقصر بكثير.</p> <p>يتكامل Azure Developer CLI (<code>azd</code>) الآن مع GitHub Copilot بطريقتين عمليتين: سقالة المشروع بمساعدة الذكاء الاصطناعي خلال <code>azd init</code>، واستكشاف الأخطاء وإصلاحها بذكاء عند فشل عمليات النشر. كلا الميزتين تعملان بالكامل داخل الطرفية.</p> <h2 id="الإعداد-مع-copilot-أثناء-azd-init">الإعداد مع Copilot أثناء azd init</h2> <p>عند تشغيل <code>azd init</code>، يظهر الآن خيار &ldquo;Set up with GitHub Copilot (Preview)&rdquo;. اختره وسيحلل Copilot قاعدة التعليمات البرمجية الخاصة بك لإنشاء <code>azure.yaml</code> وقوالب البنية التحتية ووحدات Bicep — بناءً على الكود الفعلي.</p> <pre tabindex="0"><code>azd init # اختر: &#34;Set up with GitHub Copilot (Preview)&#34; </code></pre><p>المتطلبات:</p> <ul> <li><strong>azd 1.23.11 أو أحدث</strong> — تحقق بـ <code>azd version</code> أو حدّث بـ <code>azd update</code></li> <li><strong>اشتراك نشط في GitHub Copilot</strong> (فردي أو للأعمال أو للمؤسسات)</li> <li><strong>GitHub CLI (<code>gh</code>)</strong> — سيطلب <code>azd</code> تسجيل الدخول إذا لزم الأمر</li> </ul> <p>ما أجده مفيدًا حقًا: يعمل في الاتجاهين. تبني من الصفر؟ يساعدك Copilot على تهيئة خدمات Azure الصحيحة من البداية. لديك تطبيق موجود تريد نشره؟ وجّه Copilot إليه وسيُنشئ التهيئة دون الحاجة إلى إعادة هيكلة أي شيء.</p> <h3 id="ما-الذي-يفعله-فعليا">ما الذي يفعله فعليًا</h3> <p>لنفترض أن لديك Node.js Express API يعتمد على PostgreSQL. بدلًا من اتخاذ قرار يدوي بين Container Apps وApp Service ثم كتابة Bicep من الصفر، يكتشف Copilot تقنياتك ويُنشئ:</p> <ul> <li><code>azure.yaml</code> بالإعدادات الصحيحة لـ <code>language</code> و<code>host</code> و<code>build</code></li> <li>وحدة Bicep لـ Azure Container Apps</li> <li>وحدة Bicep لـ Azure Database for PostgreSQL</li> </ul> <p>ويُجري فحوصات مسبقة قبل تغيير أي شيء — يتحقق من نظافة دليل git، ويطلب موافقتك على أدوات خادم MCP مسبقًا. لا شيء يحدث دون علمك بما سيتغير بالضبط.</p> <h2 id="استكشاف-الأخطاء-وإصلاحها-مع-copilot">استكشاف الأخطاء وإصلاحها مع Copilot</h2> <p>أخطاء النشر لا مفر منها. معاملات مفقودة، مشكلات في الأذونات، توفر SKU — ونادرًا ما تخبرك رسالة الخطأ بالشيء الوحيد الذي تحتاج معرفته فعلًا: <em>كيف تُصلحه</em>.</p> <p>بدون Copilot، الحلقة تبدو هكذا: انسخ الخطأ ← ابحث في المستندات ← اقرأ ثلاث إجابات Stack Overflow غير ذات صلة ← شغّل بعض أوامر <code>az</code> CLI ← أعد المحاولة وتمنَّ. مع Copilot في <code>azd</code>، تنهار هذه الحلقة. عند فشل أي أمر <code>azd</code>، يعرض فورًا أربعة خيارات:</p> <ul> <li><strong>Explain</strong> — شرح بلغة مبسطة لما حدث</li> <li><strong>Guidance</strong> — تعليمات خطوة بخطوة لإصلاح المشكلة</li> <li><strong>Diagnose and Guide</strong> — تحليل كامل + يطبق Copilot الإصلاح (بموافقتك) + إعادة محاولة اختيارية</li> <li><strong>Skip</strong> — التعامل معه بنفسك</li> </ul> <p>النقطة الرئيسية: لدى Copilot بالفعل سياق مشروعك والأمر الفاشل وتفاصيل الخطأ. اقتراحاته خاصة بـ <em>وضعك</em>.</p> <h3 id="ضبط-السلوك-الافتراضي">ضبط السلوك الافتراضي</h3> <p>إذا كنت دائمًا تختار نفس الخيار، تجاوز الموجه التفاعلي:</p> <pre tabindex="0"><code>azd config set copilot.errorHandling.category troubleshoot </code></pre><p>القيم: <code>explain</code> و<code>guidance</code> و<code>troubleshoot</code> و<code>fix</code> و<code>skip</code>. يمكنك أيضًا تمكين الإصلاح التلقائي وإعادة المحاولة:</p> <pre tabindex="0"><code>azd config set copilot.errorHandling.fix allow </code></pre><p>العودة إلى الوضع التفاعلي في أي وقت:</p> <pre tabindex="0"><code>azd config unset copilot.errorHandling.category </code></pre><h2 id="خاتمة">خاتمة</h2> <p>شغّل <code>azd update</code> للحصول على أحدث إصدار وجرّب <code>azd init</code> في مشروعك القادم.</p> <p>اقرأ <a href="https://devblogs.microsoft.com/azure-sdk/azd-copilot-integration/">الإعلان الأصلي هنا</a>.</p>