إخراج JSON

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

فوائد استخدام إخراج JSON

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

فيما يلي مثال على حالات الاستخدام التي تصبح ممكنة مع إخراج JSON:

• عرض محتوى منظم مثل جدول المشروع أو معلومات المنتج.
• استخراج البيانات من نص مثل الفواتير وأمر الشراء ونماذج التسليم وغيرها الكثير.
• تحديد سمات الكائن من مصادر نصية مثل رسائل البريد الإلكتروني أو بيانات Dataverse.
• احصل على فئات أو توجهات متعددة من نص.

إنشاء مطالبة باستخدام إخراج JSON

يصف هذا القسم كيفية تحديد JSON كإخراج وتحرير تنسيق JSON.

حدد JSON كإخراج

لتغيير كيفية عرض استجابة المطالبة، حدد JSON كإخراج في الزاوية العلوية اليسرى.

تحرير تنسيق JSON

لعرض تنسيق JSON أو تحريره، حدد أيقونة الإعدادات إلى يسار الإخراج: JSON.

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

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

يمكنك العودة إلى وضع الكشف التلقائي عن طريق تحديد الأيقونة Back to auto-detect .

لاختبار الموجه وحفظه، اتبع الخطوات التالية:

1. لتأكيد المثال المعدل حديثا، حدد تطبيق.
2. للتحقق من كيفية عرض استجابة المطالبة بالتنسيق الجديد، حدد اختبار.
3. عند الانتهاء من التعديلات، حدد حفظ مخصص. إذا تخطيت هذه الخطوة، فستفقد التغييرات التي أجريتها.

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

في أي وقت، يمكنك التحقق من مخطط JSON الذي ينشئ من أمثلة JSON عن طريق تحديد </>. لا يمكنك تعديل هذا المخطط حاليا.

استخدام مطالبة مع إخراج JSON في Power Automate

يرشدك هذا القسم إلى إنشاء تدفق السحابة التالي:

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

   تعرف على المزيد في إضافة نص أو صورة أو إدخال مستند إلى مطالبة.

   

2. تحديث تنسيق JSON عن طريق توفير مثال JSON التالي:

   

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

   تعرف على المزيد في بدء استخدام المشغلات.

4. أضف إجراء Run a prompt ، وحدد المطالبة التي أنشأتها في الخطوة الأولى.

5. في إدخال الفاتورة أضف مرفق البريد الإلكتروني من إجراء المشغل.

   

6. أضف إجراء إرسال بريد إلكتروني .

7. قم بتحرير نص البريد الإلكتروني لتضمين العناصر المستخرجة بواسطة المطالبة مع إخراج JSON.

   

الأسئلة المتداولة

تعذر إنشاء JSON

قد تواجه الخطأ التالي أثناء اختبار مطالبة: تعذر إنشاء JSON. قم بتحرير التعليمات الموجهة وحاول مرة أخرى.

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

لا يتم إرجاع JSON في وضع الكشف التلقائي

من الممكن عدم إرجاع JSON بعد تحديد Test prompt مع تنشيط وضع الكشف التلقائي. قد يكون ذلك لأن تعليمات المطالبة تتناقض مع تعليمات النظام الخاصة بإرجاع JSON. يمكن حلها عن طريق تغيير التعليمات الفورية والاختبار مرة أخرى.

لا يتم تحديث صيغة JSON أثناء تشغيل الأوامر

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

القيود

• لا يمكنك تعديل مخطط JSON.
• لا ندعم تعريف تنسيق JSON بدون مفاتيح الحقول.
  مثال: ["abc", "def"] غير مدعوم ولكنه [{"Field1": "abc"}, {"Field1": "def"}] مدعوم.

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

فيديو: منشئ المطالبة: مخرجات JSON في منشئ المطالبة