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

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

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

كل رابط فِي هذا الجدول يوفر خطوات استكشاف الأخطاء لمجالات محددة. يُنظَّم المحتوى حسب مراحلدورة حياة تطوير Agent 365 SDK.

مرحلة محتوى استكشاف الأخطاء وإصلاحها
إنشاء العامل وتشغيله Agent 365 CLI
تسجيل تطبيق عميل مخصص لـ Agent 365 CLI
خادم أدوات المحاكاة (Mock Tooling Server)
إمكانية مراقبة العامل
اختبار العوامل
اختبر العوامل باستخدام Dev Tunnels.
إضافة وإدارة الأَدَوَات
مخطط إعداد العامل إعداد مخطط العامل
نشر نشر العامل إلى Azure
نشر العامل إلى Amazon Web Services (AWS)
نشر عامل النشر على منصة Google Cloud (GCP)
انشر العامل فِي مركز مسؤولي Microsoft 365. انشر العامل في مركز مسؤولي Microsoft
إنشاء مثيلات العامل إنشاء مثيلات العامل

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

قبل التعمق فِي المشاكل المحددة، استخدم هذه الأوامر للتحقق مِنْ الحالة الحالية لإعداد 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>كل التسجيلات>كل التطبيقات.
  2. ابحث عن agentBlueprintId.

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

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

قبل البدء

قائمة التحقق مِنْ المتطلبات الأساسية:

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

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

# 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