مشاركة عبر

دليل استكشاف الأخطاء وإصلاحات Agent 365

مهم

يجب أن تكون جزءا من برنامج معاينة الحدود للحصول على وصول مبكر إلى Microsoft Agent 365. Frontier تربطك مباشرة بأحدث ابتكارات الذكاء الاصطناعي من Microsoft. تخضع المعاينات الحدودية لشروط المعاينة الحالية لاتفاقيات العملاء. نظرا لأن هذه الميزات لا تزال قيد التطوير، فقد تتغير توفرها وقدراتها بمرور الوقت.

استخدم هذا الدليل لتشخيص وحل المشكلات عبر دورة حياة تطوير Agent 365 بأكملها. استخدم هذا المقال كنقطة انطلاق لاستكشاف المشكلة، ثم انتقل إلى أقسام محددة للحصول على حلول مفصلة.

خطوات استكشاف الأخطاء وإصلاحها

كل رابط في هذا الجدول يوفر خطوات استكشاف الأخطاء لمناطق محددة. يتم تجميع المحتوى حسب مرحلة دورة حياة تطوير مجموعة تطوير Agent 365.

مرحلة استكشاف أخطاء المحتوى
وكيل بناء وتشغيل العميل 365 CLI
تسجيل تطبيق العميل المخصص ل Agent 365 CLI
خادم أدوات المحاكاة
قابلية الرصد للعوامل
عوامل الاختبار
وكلاء الاختبار باستخدام أنفاق التطوير
إعداد وكيل 365 إعداد إعدادات Agent 365
إضافة وإدارة الأَدَوَات
مخطط وكيل الإعداد مخطط وكيل الإعداد
Deploy Deploy agent to Azure
نشر وكيل إلى خدمات الويب أمازون (AWS)
نشر وكيل النشر على منصة Google Cloud (GCP)
Publish agent to Microsoft 365 admin center وكيل النشر إلى مركز إدارة مايكروسوفت
إنشاء مثيلات وكيل إنشاء مثيلات وكيل

مرجع أوامر التشخيص

قبل الغوص في مشاكل محددة، استخدم هذه الأوامر للتحقق من الحالة الحالية لإعداد Agent 365 الخاص بك:

تحقق من مستوى القيادة والتكوين

استخدم هذه الأوامر للتحقق من مستوى السطر والإعدادات الخاصة بك.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
a365 config display

# Display generated configuration (after setup)
a365 config display -g

Verify Azure resources

استخدم هذه الأوامر لفحص موارد Azure وحالة التطبيق.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Verify Agent Blueprint

تأكد من وجود مخطط وكيلك وأنه محدد بشكل صحيح.

# Check if blueprint ID is set
a365 config display -g | Select-String "agentBlueprintId"

Verify blueprint في Microsoft Entra

  1. اذهب إلى https://entra.microsoft.com>تسجيل التطبيقات.>جميع الطلبات.
  2. ابحث عن agentBlueprintId.

أفضل الممارسات الوقائية

استخدم هذه التوصيات لمنع المشاكل الشائعة وتبسيط عملية حل المشكلة.

قبل أن تبدأ

قائمة المتطلبات المسبقة:

✅ تم تثبيت حزمة تطوير .NET 8.0
✅ تم تثبيت والتحقق من واجهة Azure CLI
✅ الصلاحيات المطلوبة لإنترا المخصصة
✅ تم إنشاء وتكوين تطبيق عميل مخصص
✅ تفعيل المستأجر لمايكروسوفت إيجنت 365 فرونتير

أوامر التحقق:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

أثناء التطوير

احفظ تكويناتك:

  • احتفظ بنسخ احتياطية لملفات الإعدادات.
  • وثق اختياراتك في الإعداد.
  • احفظ المعرفات المولدة، مثل معرف البلوبرينت ومعرف الهوية المدارة.

تابع قائمة المعلومات (CLI):

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

اختبر تدريجيا:

  • اختبر بعد كل خطوة رئيسية.
  • تحقق من النجاح قبل الانتقال.
  • استمر في العمل على الإعدادات.

قبل النشر

قائمة التحقق قبل النشر:

✅ يعمل وكيل محليا مع عملاء بلايجراوند.
✅ جميع متغيرات البيئة موثقة.
✅ ملفات التكوين المخصصة للتحكم المصدري.
✅ خوادم MCP مهيأة ومختبرة.
✅ تمكين والتحقق من الملاحظة.

احصل على مساعدة إضافية

لمراجعة الكود النموذجي، الإبلاغ عن المشكلات، أو البحث عن المشكلات القائمة، استخدم هذه المستودعات:

  • Last updated on