استخدم محرر الكود‬ لكتابة وتحرير YAML في المواضيع

يمكن كتابة وتحرير المواضيع في محرر الكود‬، الذي يدعم استخدام YAML. YAML تعني "بلغة YAML Ain't Markup Language (YAML)‎." يستخدم YAML عادة لكتابة ملفات التكوين وهو أسهل في القراءة من XML أو JSON. تستخدم ملفات YAML إما امتداد ملف .yaml أو .yml. تقوم بتنسيق ملفات YAML باستخدام التباعد والمسافات البادئة لتمثيل هياكل البيانات مثل السلاسل النصية، والأرقام، والقيم منطقية، والقوائم، والقواميس.

للوصول إلى محرر الكود‬ من موضوع معين، اختر (...) المزيد في شريط الأدوات ثم اختر ‏‫فتح محرر الكود‬.

شاهد هذا الفيديو للحصول على نظرة عامة على كيفية استخدام YAML في محرر الكود‬:

مهم

يمكن لأي منشئ استخدام ‏‫محرر الكود‬ لاستكشاف تكوين موضوع. قد يختار المطورون والمستخدمون المتقدمون التصميم والتحرير داخل محرر الكود‬. ومع ذلك، كن حذراً عند إجراء التعديلات في ‏محرر الكود‬. يمكن أن تؤدي الأخطاء في علامات الترقيم أو البنية إلى رسائل خطأ معقدة أو تعطيل المحادثة الحالية. فرق الدعم الفني لدينا لا تستطيع المساعدة في معالجة أخطاء ‏‫محرر الكود‬. إذا كنت جديدا في مراجعة YAML، فقم بعمل نسخة من الموضوع قبل إجراء أي تغييرات.

التوقيت المناسب لاستخدام محرر الكود

Copilot Studio لا يتطلب منك كتابة YAML من الصفر. بدلا من ذلك، يتم توليد YAML تلقائيا عند إنشاء كائنات على لوحة الموضوع. يمكنك بعد ذلك مراجعة التكوين في محرر الكود‬ لفهم الإعدادات بشكل أفضل، أو اختيار إجراء تغييرات على YAML. إليك أمثلة على حالات استخدام محرر الكود‬:

  • يعرض محرر الكود‬ التكوين الكامل للموضوع دون الحاجة للتفاعل مع عناصر الحوار الفردية في الموضوع. إنه مكان شامل لعرض جميع الإعدادات في الموضوع.
  • قد يختار المنشئون نسخ بعض العقد من موضوع ما ولصقها في مواضيع أخرى، بدلاً من استخدام أيقونة نسخ وأيقونة لصق. قد يكون أسهل من اختيار عدة عقد في تكوين واحد.
  • قد يختار المطورون تحديث معرف تدفق Power Automate في YAML، بدلا من الانتظار حتى تتم المزامنة مع قائمة الدعوة والإجراء.
  • قد يختار المنشئون استنساخ وتعديل عقد الأسئلة أو عقد الرسائل عندما تكون متشابهة. ومع ذلك، في مثل هذه الحالات، من الضروري التأكد من أن جميع المعرفات والمتغيرات تظل فريدة. تعديل المعرفات المستنسخة بحيث تصبح معرفات فريدة.
  • قد يختار المنشئون إجراء تعديلات بسيطة في محرر الكود، مثل إضافة مصطلح إلى عبارات الموضوع، لأنه يمكن أن يكون أسرع في الكتابة أو النسخ واللصق للنص في كود YAML.

فهم YAML في محرر الكود

تُظهر الصورة التَالية مثَالاً عَلى كتلة نموذجية لـ YAML.

لقطة شاشة لكتلة من كود YAML النموذجي في محرر الكود.

إليك كيف ينطبق هذا الكود على الموضوع المقابل كما يظهر على اللوحة.

  • السطر 1: نوع الموضوع.
  • الأسطر 2-3: تشير إلى بداية موضوع ‏‫تعزيز المحادثة‬.
  • السطر 7: يشير إلى عقدة الإجابات التوليدية.
  • السطر 9: المتغير ذو الصلة.
  • الأسطر 11-12: تفاصيل حول التعليمات الخاصة وتعليمات الطلب.
  • الأسطر 20-26: روابط مصادر معرفية.
  • الأسطر 28-32: مجموعة الشروط. كل شرط له معرف فريد، إلى جانب تفاصيل معادلة الشرط وعمليات إعادة التوجيه الخاصة به.

اختبر YAML في محرر الكود

إذا كنت ترغب في اختبار هذا الكود، فأكمل الخطوات التالية في Copilot Studio:

  1. إنشَاء مِندوب.

  2. انتقل إلى صفحة الإعدادات لعاملك وحدد ٱلذَّكَاءُ ٱلِاصْطِنَاعِيُّ التوليدي، وحدد توليدي.

  3. انتقل إلى صفحة المواضيع واختر النظام ثم اختر موضوع تعزيز المحادثة.

  4. فتح محرر الكود.

  5. استبدل الكود الموجود بكود YAML النموذجي التالي.

     kind: AdaptiveDialog
 beginDialog:
  kind: OnUnknownIntent
  id: main
  priority: -1
  actions:
    - kind: SearchAndSummarizeContent
      id: search-content
      userInput: =System.Activity.Text
      variable: Topic.Answer
      moderationLevel: Medium
      additionalInstructions: Include emojis to make responses more fun.
      publicDataSource:
        sites:
          - "www.chessusa.com/"
          - "www.chess.com/"
          - "www.lichess.org/"

      sharePointSearchDataSource: {}

    - kind: ConditionGroup
      id: has-answer-conditions
      conditions:
        - id: has-answer
          condition: =!IsBlank(Topic.Answer)
          actions:
            - kind: EndDialog
              id: end-topic
              clearTopicQueue: true

  6. حدد حفظ ثم أغلق محرر الكود.

  7. اختبر العامل في لوحة الاختبار بطرح سؤال متعلق بالشطرنج، مثل: "كيف يتحرك الفارس؟"

  • Last updated on