قائمة التحقق من صحة SDK للوكيل 365

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

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

أقسام القدرات مستقلة، لذا تخطى أي قدرة لم تتبناها. أقسام السلوك، التكوين، والنشر تنطبق على كل تكامل.

اعمل على هذه القائمة إذا كنت:

  • قمت بتعيين وكيل وأرغب في تأكيد التكامل قبل النشر.
  • أضفت قدرة إلى وكيل قمت بدمجها بالفعل.
  • ورثت وكيلا من فريق آخر وأحتاج إلى تحديد ما هو مكون.

تحقق من السلوك الحالي

حزمة تطوير البرمجيات توسع وكيلك، لذا لا ينبغي أن يغير التكامل طريقة عمل الوكيل بالفعل.

  • يبدأ الوكيل بدون أخطاء جديدة.
  • يستجيب الوكيل لطلب عادي كما كان يفعل قبل التكامل.
  • استدعاءات النماذج، والتنسيق، وتنفيذ الأدوات تتصرف كما كانت من قبل.

ملحوظة

إذا تغير سلوك النواة، تحقق قبل النشر. الكود المولد، تعارضات التبعيات، التكوين، وتوافق SDK كلها أسباب محتملة. انظر قسم استكشاف المشكلات.

تحقق من الهوية

  • مخطط هوية الوكيل مسجل في Microsoft Entra.
  • هوية وكيل موجودة، تم إنشاؤها من ذلك المخطط. تنشئ المهارة make-a365-agent ذلك على مسار العميل القياسي، وعلى make-ai-teammate مسار زميل الذكاء الاصطناعي؛ انظر البدء السريع: ربط وكيل موجود بالوكيل 365.
  • يتم تعيين راع واحد على الأقل.
  • إذا كان الوكيل يحتاج إلى حساب مستخدم، فهذا الحساب موجود ويرتبط بهوية الوكيل.
  • إذا كان لدى الوكيل حساب مستخدم، يتم تعيين التراخيص المطلوبة وتوفير موارد تابعة مثل صندوق بريد.
  • تمنح صلاحيات API ونطاقات Microsoft Graph بشكل صحيح.
  • يقوم الوكيل بالتحقق ويتصرف وفقا للهوية المتوقعة.

مهم

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

ملحوظة

بعد تعيين الترخيص، عادة ما يكتمل توفير الموارد لحساب المستخدم خلال 10 إلى 15 دقيقة، لكنه قد يستغرق حتى 24 ساعة.

تحقق من قابلية الملاحظة

  • على الأقل مستخدم واحد في المستأجر لديه ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين. بدون هذا الرخصة، يتم حذف القياس عن بعد رغم أن الإدخال يعود إلى HTTP 200.
  • يتم تثبيت وتكوين حزم الملاحظة.
  • ينتج طلب الاختبار امتدادات لاستدعاء الوكيل، وتنفيذ الأدوات، والاستدلال.
  • السلسلة لها امتداد صالح invoke_agent في جوهرها. بدون واحدة، تبقى المقاطع قابلة للاستعلام في Defender Advanced Hunting لكنها لا تصل إلى الأسطح الثلاثة.
  • يظهر التليمترية في Microsoft Defender وMicrosoft Purview ومركز مسؤولي Microsoft 365.
  • خصائص المدى تتطابق مع العمليات التي تتوقعها.

تحقق من الأدوات

أكمل هذا القسم إذا استدعى الوكيل خوادم بروتوكول السياق النموذجي (MCP).

  • يتوفر رخصة Microsoft 365 Copilot في المستأجر. برنامج Work IQ MCP حاليا في مرحلة المعاينة ويتطلب واحدا.
  • يكتشف الوكيل خوادم MCP التي يجب أن يكون لديه وصول إليها.
  • استدعاء أداة الاختبار ينجح من البداية إلى النهاية.
  • يكتشف وقت تشغيل الوكيل فشل أداة، ويعيد خطأ مسيطر عليه، ويبقى متاحا.

تحقق من الإشعارات

أكمل هذا القسم إذا تلقى الوكيل إشعارات.

  • يتلقى الوكيل إشعارات من المصادر المهيأة، مثل Teams أو Outlook أو تعليقات Word أو البريد الإلكتروني.
  • يستجيب الوكيل لإشعار اختبار كما هو مصمم.

مهم

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

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

  • خزن بيانات الاعتماد والأسرار بأمان ولا تلزمها بالتحكم في المصدر.
  • إعدادات التطوير والاختبار والإنتاجية منفصلة.
  • تأكد من أن التكامل يعمل في مضيفك المستهدف.

تأكيد جاهزية الانتشار

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

حل الفحوصات الفاشلة

قم بتشغيل خطوة الإعداد المناسبة مرة أخرى، أو اطلب من مساعد البرمجة إكمال القدرة المحددة.

للاطلاع على الأعراض الشائعة وحلولها، راجع قسم استكشاف المشكلة. للاطلاع على الأعراض الخاصة بإعداد المهارات، راجع جدول استكشاف الأخطاء في Quickstart: Connect a Agent Existing to Agent 365.

للحصول على إجابات على أسئلة ذات صلة، راجع Agent 365 SDK الأسئلة المتكررة.