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

يمكن كتابة المواضيع وتحريرها في محرر التعليمات البرمجية، والذي يدعم استخدام YAML. يرمز اسم YAML إلى "YAML ليست لغة ترميز". يُستخدم YAML عادةً لكتابة ملفات التكوين، ويُعتبر أسهل في القراءة من XML وJSON. تستخدم ملفات YAML إما ملحق ملف .yaml أو .yml. يمكنك تنسيق ملفات YAML مع التباعد والمسافة البادئة لتمثيل بنيات البيانات، مثل السلاسل والأرقام والقيم المنطقية والقوائم والقواميس.

للوصول إلى محرر التعليمات البرمجية من موضوع، حدد (...) المزيد على شريط الأدوات ثم حدد فتح محرر التعليمات البرمجية.

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

Important

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

متى تستخدم محرر التعليمات البرمجية

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

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

فهم YAML في محرر التعليمات البرمجية

تعرض الصورة التالية مثالا لكتلة نموذجية من YAML.

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

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

اختبار YAML في محرر التعليمات البرمجية

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

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

2. انتقل إلى صفحة الإعدادات لوكيلك، وحدد الذكاء الاصطناعي التوليدي، وحدد توليدي.

3. انتقل إلى صفحة Topics ، وحدد System، وحدد موضوع Conversational boosting .

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. اختبر العامل في لوحة الاختبار عن طريق طرح سؤال متعلق بالشطرنج، مثل"كيف يتحرك الفارس؟"

المعلومات ذات الصلة

• YAML Ain't Markup Language (YAML™) الإصدار 1.2.2
• مدقق YAML - مدقق بناء جملة YAML
• محول YAML إلى JSON