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

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

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

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

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

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

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

تحقق من واجهة سطر الأوامر والإعدادات

استخدم هذه الأوامر للتحقق من واجهة سطر الأوامر وتكوينك.

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

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

التحقق من موارد Azure

استخدم هذه الأوامر لفحص موارد 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

التحقق من نموذج وكيل

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

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

التحقق من المخطط في Microsoft Entra

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

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

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

قبل البدء

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

تم تثبيت ✅ .NET 8.0 SDK
✅ Azure CLI مثبتا ومصادقا عليه
✅ الصلاحيات المطلوبة لـ Entra المعيّنة
✅ تم إنشاء وتكوين تطبيق عميل مخصص
✅ تفعيل المستأجر لمايكروسوفت إيجنت 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

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

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

قبل النشر

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

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

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

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

  • Last updated on