ai-agents-for-beginners

اختبارات الدخان للوكلاء

يحتوي هذا المجلد على كتالوجات اختبارات الدخان للوكلاء الذين تبنيهم في الدورة. اختبار الدخان هو فحص رخيص وسريع للتأكد من أن الوكيل المستضاف على Microsoft Foundry والمستخدم قابل للوصول، ويستجيب، ويتبع توقعات المطالبات الأساسية الخاصة به. إنه بوابة أولى — وليس بديلاً عن دورة التقييم الكاملة التي تتعلمها في الدرس 10 و الدرس 16.

تُستخدم الكتالوجات بواسطة اختبار الدخان للذكاء الاصطناعي إجراء GitHub عبر سير العمل .github/workflows/smoke-test.yml.

كيفية التشغيل

  1. نشر وكيل الدرس على Microsoft Foundry كوكيل مستضاف (راجع الدرس 16 لسير عمل النشر). لاحظ اسم الوكيل و نقطة نهاية مشروع Foundry.
  2. أضف الأسرار التالية للمستودع (الإعدادات → الأسرار والمتغيرات → الإجراءات): AZURE_CLIENT_ID، AZURE_TENANT_ID، AZURE_SUBSCRIPTION_ID. يحتاج الهوية الفيدرالية إلى دور Azure AI User بمستوى مشروع Foundry.
  3. من علامة التبويب الإجراءات، شغّل اختبار الدخان للوكلاء المستضافين واختر tests_file للدرس، ثم أدخل agent_name و project_endpoint المطابقين.

الكتالوج → الدرس → اسم الوكيل

الكتالوج الدرس نشر الوكيل كـ
lesson-01-smoke-tests.json 01 – مقدمة لوكلاء الذكاء الاصطناعي TravelAgent
lesson-04-smoke-tests.json 04 – استخدام الأدوات TravelToolAgent
lesson-05-smoke-tests.json 05 – RAG الوكالاتية TravelRAGAgent
lesson-16-smoke-tests.json 16 – نشر الوكلاء القابلين للتوسع ContosoSupportAgent

أي الدروس تحتوي على اختبارات دخان؟

تنطبق اختبارات الدخان على الدروس التي تنشر فيها وكيلًا يمكن التحقق من ردوده النصية مقابل محتوى معروف. الدروس التي تحتوي على مفاهيم فقط، تعمل محليًا فقط، أو تنتج مخرجات إبداعية غير حتمية يتم استثناؤها عمدًا:

نموذج الكتالوج (مرجع سريع)

كل كتالوج هو مستند JSON يحتوي على مصفوفة tests على المستوى الأعلى. كل إدخال يرسل مطالبة واحدة ويتحقق من الرد:

الحقل المعنى
id معرف خطوة فريد يُطبع في السجل.
description هدف قابل للقراءة من قبل الإنسان.
prompt الرسالة المرسلة إلى الوكيل.
assertions.status حالة HTTP المتوقعة (الافتراضية 200).
assertions.contains_any اجتياز الاختبار إذا احتوى الرد على أي من هذه السلاسل النصية الفرعية.
assertions.contains_all اجتياز الاختبار إذا احتوى الرد على كل سلسلة نصية فرعية.
assertions.contains_none اجتياز الاختبار إذا لم يحتوي الرد على أيٍ من هذه السلاسل النصية الفرعية.
save_response_id_as تخزين معرف الرد لاستخدام لاحق في خطوة متعددة الأدوار.
use_previous_response_id إرسال هذه الدورة متسلسلة مع معرف رد محفوظ.

تكون التأكيدات عبارة عن فحوصات سلسلة نصية فرعية غير حساسة لحالة الأحرف. راجع توثيق الإجراء لـ النموذج الكامل، بما في ذلك موارد المحادثة التي يديرها Foundry.


تنويه: تمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.