إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مهم
يجب أن تكون جزءا من برنامج معاينة الحدود للحصول على وصول مبكر إلى Microsoft Agent 365. Frontier تربطك مباشرة بأحدث ابتكارات الذكاء الاصطناعي من Microsoft. تخضع المعاينات الحدودية لشروط المعاينة الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.
تتضمن دورة تطوير Agent 365 عدة خطوات: تثبيت سطر المسؤولية، تكوين المتطلبات المسبقة، إنشاء مخطط للوكيل، نشر الكود، والنشر في مركز إدارة Microsoft 365. كل خطوة لها متطلباتها الخاصة، وفحوصات التحقق، ونقاط اتخاذ القرار.
يقوم إعداد الذكاء الاصطناعي بأتمتة سير العمل بالكامل باستخدام وكيل ترميز ذكاء اصطناعي (مثل GitHub Copilot في VS Code) لتنفيذ خطوات دورة الحياة نيابة عنك. بدلا من التنقل بين صفحات توثيق متعددة وتشغيل الأوامر يدويا، توفر لوكيل الذكاء الاصطناعي ملف تعليمات واحد ويوجهك خلال العملية بشكل تفاعلي.
Benefits
يقدم الإعداد الموجه بالذكاء الاصطناعي عدة مزايا مقارنة بسير العمل اليدوي:
- نقطة دخول واحدة — ملف تعليمات واحد يحل محل الحاجة للتنقل بين صفحات توثيق متعددة. يتبع وكيل الذكاء الاصطناعي الخطوات بالترتيب ويتعامل مع الانتقالات تلقائيا.
-
التحقق التلقائي من المتطلبات — يقوم وكيل الذكاء الاصطناعي بالتحقق من تثبيت والتحقق من صحة واجهة الأزر، وأن تسجيل تطبيق العميل المخصص لديه الأذونات الصحيحة بموافقة المسؤول، وأن أدوات البناء الخاصة باللغة متاحة - كل ذلك قبل تشغيل أي
a365أوامر CLI. - الإعدادات الافتراضية الذكية والكشف التلقائي — يقوم وكيل الذكاء الاصطناعي باستعلام اشتراكك في Azure عن مجموعات الموارد الحالية، وخطط خدمات التطبيقات، ومعلومات المستخدم، ثم يستخدم تلك القيم كاقتراحات عند جمع مدخلات التكوين.
- اتفاقيات التسمية المشتقة — توفر اسما أساسيا واحدا لوكيلك، ويقوم وكيل الذكاء الاصطناعي باستمتاق جميع أسماء الموارد ذات الصلة (الهوية، المخطط، اسم المستخدم، تطبيق الويب) باستخدام أنماط متسقة.
- التعامل مع الأخطاء داخل الخط — عندما يفشل الأمر، يقوم وكيل الذكاء الاصطناعي بتحليل الخطأ، ويقترح إصلاحا، ويعيد المحاولة - بدلا من أن يطلب منك البحث في وثائق استكشاف المشكلة.
-
التكوين غير التفاعلي — يقوم وكيل الذكاء الاصطناعي بإنشاء
a365.config.jsonالملف مباشرة واستورده، مما يتجنب مشاكل معالجات CLI التفاعلية في البيئات الآلية.
المتطلبات
قبل البدء، تأكد من أن لديك المتطلبات الأساسية التالية:
الأَدَوَات المطلوبة
- كود فيجوال ستوديو مع إضافات GitHub CopilotوGitHub Copilot Chat مثبتة. يتطلب إعداد الذكاء الاصطناعي وجود وكيل ترميز ذكاء اصطناعي مع وصول إلى الطرفية.
- .NET 8.0 أو أحدث — مطلوب لواجهة الوكيل 365. ثبت .NET.
- Azure CLI — مطلوب للمصادقة وإدارة الموارد. تثبيت Azure CLI.
الحسابات والأذونات المطلوبة
- اشتراك Azure مع Contributor access
- مستأجر Microsoft Entra بأحد الأدوار التالية:
- تسجيل تطبيق العميل المخصص - الإعداد الموجه بالذكاء الاصطناعي يتحقق من تسجيل التطبيق، لكن يجب أن يكون التطبيق موجودا بالفعل في المستأجر الخاص بك مع الأذونات المطلوبة وموافقة المسؤول. راجع تسجيل تطبيق العميل المخصص إذا كنت بحاجة لإنشاء واحد.
رمز الوكيل المطلوب
- مشروع وكيل عامل (بايثون، Node.js، أو .NET) تريد نشره. إذا لم يكن لديك واحد، ابدأ بأحد عينات البدء السريع.
احصل على ملف تعليمات الإعداد
يستخدم إعداد الذكاء الاصطناعي ملف تعليمات باسم a365-setup-instructions.md.
مستودع Agent365-devTools يتضمن هذا الملف.
إذا قمت باستنساخ المستودع، فسيكون الملف على:
Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md
إذا لم يكن المستودع مستنسخا، قم بتحميل الملف مباشرة من GitHub.
شغل إعداد الذكاء الاصطناعي
اتبع هذه الخطوات لبدء إعداد الذكاء الاصطناعي الموجه في مشروع وكيلك.
الخطوة 1: افتح مشروع وكيلك في كود VS
افتح دليل مشروع وكيل في كود Visual Studio. يحتوي هذا الدليل على كود الوكيل الخاص بك (على سبيل المثال، الدليل الذي يحتوي على ملف ، *.csproj، أو pyproject.toml ملف).package.json
الخطوة 2: فتح دردشة GitHub Copilot في وضع الوكيل
افتح لوحة دردشة GitHub Copilot وانتقل إلى وضع الوكيل . وضع الوكيل يمنح GitHub Copilot القدرة على تشغيل أوامر الطرفية، وقراءة الملفات، والتفاعل مع مشروعك - وكلها إمكانيات مطلوبة في إعداد الذكاء الاصطناعي.
مهم
يجب عليك استخدام وضع الوكيل (وليس وضع السؤال أو التحرير). يتطلب إعداد الذكاء الاصطناعي القدرة على تنفيذ أوامر الطرفية والتفاعل مع بيئتك.
الخطوة 3: أرفق ملف التعليمات وابدأ
في مدخل دردشة Copilot، أرفق الملف a365-setup-instructions.md وأرسله مع طلب قصير. على سبيل المثال:
Follow the steps in #file:a365-setup-instructions.md
يقرأ وكيل الذكاء الاصطناعي ملف التعليمات ويبدأ الإعداد الموجه. ينشئ قائمة مهام مكونة من خمس خطوات ويعمل عليها بالتسلسل:
- تحقق وتثبيت CLI من Agent 365 - يتحقق من وجود CLI، يثبته أو يحدثه، ويتأكد من أنه يعمل.
- التحقق من المتطلبات المسبقة - تأكيد مصادقة Azure CLI، التحقق من تسجيل التطبيق المخصص وصلاحياتك، والتحقق من تثبيت أدوات البناء لنوع مشروعك.
-
تكوين واجهة التصنيع الخاصة بالوكيل 365 - يسأل عما إذا كنت تريد نشرا مستضافا في Azure أو مستضافا ذاتيا، يجمع قيم التكوين، يشتق أسماء الموارد، وينشئ
a365.config.jsonالملف. -
توفير الموارد - يعمل
a365 setup allلإنشاء بنية Azure التحتية ومخطط الوكيل. - النشر والنشر - مراجعة البيان، نشر الوكيل في مركز إدارة Microsoft 365، نشر الكود على Azure، وتوفير تعليمات ما بعد النشر.
الخطوة 4: الرد على الطلبات
يتوقف عميل الذكاء الاصطناعي عند نقاط محددة لجمع المدخلات منك:
- معرف تطبيق العميل المخصص — معرف التطبيق (العميل) الخاص بك لتسجيل تطبيق العميل المخصص.
- نوع النشر — هل يجب إنشاء تطبيق ويب Azure (مستضاف في Azure) أو استخدام نقطة نهاية موجودة (مستضافة ذاتيا).
- قيم التكوين — مجموعة الموارد، الموقع، اسم الوكيل، بريد المدير، وخطة خدمة التطبيقات (للمستضاف على Azure) أو اسم الوكيل وبريد المدير (للمستضاف ذاتيا).
- تأكيد القيمة المشتق — راجع الأسماء المولدة تلقائيا لهوية الوكيل، المخطط، واصل المستخدم.
-
مراجعة البيان — تأكد من أن معلوماتك
manifest.jsonمحدثة باسم وكيلك ووصفه ومعلومات المطور.
تلميح
يعرض وكيل الذكاء الاصطناعي القيم الحقيقية من اشتراكك في Azure كأمثلة عند طلب مدخلات التكوين. يمكنك قبول الاقتراحات أو تقديم قيمك الخاصة.
الخطوة 5: إكمال مهام ما بعد النشر
بعد انتهاء أوامر CLI، يوفر وكيل الذكاء الاصطناعي تعليمات للخطوات اليدوية التي تتطلب تفاعلا مع المتصفح:
- قم بتكوين الوكيل في بوابة مطوري Teams — حدد نوع الوكيل ومعرف البوت.
- إنشاء مثيل وكيل — اطلب نسخة من Teams وادع المسؤول يوافق عليها.
- اختبر الوكيل — أرسل رسائل إلى وكيلك في Teams للتحقق من أنه يعمل.
للحصول على تعليمات مفصلة حول هذه الخطوات بعد النشر، راجع إنشاء مثيلات الوكيل.
ما الذي يغطيه إعداد الذكاء الاصطناعي
يقوم الإعداد الموجه بالذكاء الاصطناعي بأتمتة المراحل التالية من دورة حياة التطوير:
| مرحلة دورة الحياة | ما يفعله وكيل الذكاء الاصطناعي | المكافئ اليدوي |
|---|---|---|
| تركيب CLI | يقوم بتثبيت أو تحديث واجهة Agent 365 CLI | العميل 365 CLI |
| المتطلبات | التحقق من صحة Azure CLI، وتطبيق العميل المخصص، والأدوان، وأدوات البناء | تسجيل تطبيق العميل المخصص |
| التكوين | ينشئ a365.config.json باستخدام قيم معتمدة |
إعداد وكيل 365 |
| إعداد المخطط | تشغيل a365 setup all لإنشاء البنية التحتية والمخطط |
مخطط وكيل الإعداد |
| التوزيع | تشغيل a365 deploy لبناء ونشر الكود |
Deploy agent to Azure |
| قيد النشر | يركض a365 publish إلى تسجيل وكيل في مركز الإدارة |
وكيل النشر إلى مركز إدارة مايكروسوفت |
ملاحظة
الإعداد الموجه بالذكاء الاصطناعي لا يعوض الحاجة لبناء كود الوكيل أولا . يجب أن يكون لديك مشروع وكيل عامل قبل بدء الإعداد الموجه. بالنسبة للمشاريع الجديدة، ابدأ ببداية سريعة.
استكشاف الأخطاء وإصلاحها
وكيل الذكاء الاصطناعي لا يشغل أوامر الطرفية
إذا كان وكيل الذكاء الاصطناعي يصف الأوامر لكنه لا ينفذها، تأكد من أنك تستخدم وضع الوكيل في دردشة GitHub Copilot. أوضاع Ask and Edit لا تحتوي على وصول إلى الطرفية.
وكيل الذكاء الاصطناعي يتخطى خطوات التحقق
يفرض ملف التعليمات ترتيبا صارما للخطوات. إذا بدا أن وكيل الذكاء الاصطناعي يتخطى خطوة، ذكره باتباع التعليمات من البداية. على سبيل المثال:
Please start from Step 1 in the setup instructions and work through each step in order.
تفشل أوامر CLI مع أخطاء الإذن
إذا a365 فشلت أوامر CLI مع أخطاء التفويض، فإن السبب الأكثر شيوعا هو فقدان أو عدم اكتمال تسجيل تطبيق العميل المخصص. يقوم وكيل الذكاء الاصطناعي بالتحقق من هذا التسجيل في الخطوة 2، ولكن إذا تخطيت هذا التحقق، عد وقم بتشغيله. للحصول على دليل الإعداد الكامل، راجع تسجيل تطبيق العميل المخصص.
قيم التكوين خاطئة
إذا كنت بحاجة لتغيير قيم التكوين بعد إنشاء a365.config.json الملف، يمكنك إما:
- قم بتحرير
a365.config.jsonالملف مباشرة وإعادة تشغيلهa365 config init -c ./a365.config.json - اطلب من وكيل الذكاء الاصطناعي تحديث قيم محددة