פלט JSON

הערה

מאמר זה מתאר תכונות שמשמשות בסוכנים או בזרימות סוכנים שמופעלות באמצעות המסגרת הרגילה.

כברירת מחדל, הבקשה יוצרת טקסט כתגובה. טקסט יכול להיות נוח במקרים רבים; עם זאת, אם התגובה כוללת מספר רכיבים שיש לזהות בנפרד, אפשרות הטקסט יכולה להיות מוגבלת.

יתרונות השימוש בפלט JSON

פלט JSON מאפשר לך ליצור מבנה JSON עבור תגובת הבקשה במקום טקסט. JSON מקל עליך לעבד תגובות עם רכיבים מרובים בסוכנים, זרימות ענן או אפליקציות.

להלן דוגמה למקרי שימוש העשויים להיות אפשריים עם פלט JSON:

• הצג תוכן מובנים כגון לוח זמנים של פרוייקט או פרטי מוצר.
• חלץ נתונים מטקסט כגון חשבוניות, הזמנת רכש, טפסי מסירה ועוד רבים נוספים.
• זהה תכונות אובייקט ממקורות טקסט כגון הודעות דואר אלקטרוני או נתונים Dataverse.
• קבל קטגוריות או סנטימנטים מרובים מטקסט.

יצירת בקשה עם פלט JSON

סעיף זה מתאר כיצד לבחור JSON כפלט ולערוך את תבנית JSON.

בחר JSON כפלט

כדי לשנות את אופן העיבוד של תגובת הבקשה, בחר JSON כפלט בפינה השמאלית העליונה.

עריכת תבנית JSON

כדי להציג או לערוך את תבנית JSON, בחר את סמל ההגדרות מימין לפלט : JSON.

כברירת מחדל, התבנית מזוהה באופן אוטומטי. פורמט זה פירושו שבכל פעם שתבדוק את הפנייה שלך, הפורמט הקשור לפנייה יתעדכן עם הפורמט שזוהה בעת הבדיקה. תבנית זו נוחה כאשר אתה מתחל מחדש בהוראות הבקשה שלך וברצונך לדעת כיצד תבנית התגובה מתפתחת.

אם תעדכן את הדוגמה של JSON, התבנית תהפוך למותאם אישית ולעולם לא תעדכן אותה אם תבדוק שוב את הבקשה. תבנית זו נוחה כאשר אינך מעוניין בהנחיה להשפיע על התבנית, או אם עליך לפעול לפי תבנית ספציפית.

באפשרותך לחזור למצב זיהוי אוטומטי על-ידי בחירת סמל חזור לזיהוי אוטומטי.

כדי לבדוק ולשמור את הבקשה שלך, בצע את הפעולות הבאות:

1. כדי לאשר את הדוגמה שהשתנו לאחרונה, בחר החל.
2. כדי לבדוק כיצד תעובד תגובת הבקשה שלך עם התבנית החדשה, בחר בדוק.
3. לאחר שתסיים לבצע את השינויים, בחר שמור מותאם אישית. אם תדלג על שלב זה, השינויים שלך יאבדו.

בעת שמירת הבקשה, אתה נועל את התבנית האחרונה שזוהתה אוטומטית או את התבנית המותאמת אישית המוגדרת. משמעות הדבר היא כי בעת שימוש בבקשה שלך בסוכן, בזרימת ענן או באפליקציה, נעשה שימוש בתבנית השמורה - היא אינה משתנה.

בכל עת, באפשרותך לבדוק את סכימת JSON שנוצרת מתוך דוגמאות JSON על-ידי בחירת </>. אין באפשרותך לשנות סכימה זו כעת.

השתמש בפקודה עם פלט JSON ב-Power Automate

סעיף זה מנחה אותך ליצור את זרימת הענן הבאה:

1. צור בקשה לעיבוד חשבוניות באמצעות תמונה או מסמך כקלט .

   קבל מידע נוסף בהוספת טקסט, תמונה או מסמך להנחיה.

   

2. עדכן את תבנית JSON על-ידי מתן הדוגמה הבאה של JSON:

   

3. צור זרימת ענן עם מפעיל כאשר מגיעה הודעת דואר אלקטרוני חדשה. כדי לעבד הודעות דואר אלקטרוני ספציפיות, הקפד להגדיר מסננים.

   קבל מידע נוסף בנושא תחילת העבודה עם גורמים מפעילים.

4. הוסף את הפעולה הפעל בקשה ובחר את הבקשה שיצרת בשלב הראשון.

5. בקלט החשבונית , הוסף את הקובץ המצורף לדואר אלקטרוני מהפעולה של הגורם המפעיל.

   

6. הוסף את הפעולה שלח הודעת דואר אלקטרוני.

7. ערוך את גוף הדואר האלקטרוני כדי לכלול את הרכיבים שחולצו על-ידי הבקשה עם פלט JSON.

   

שאלות ותשובות

לא היתה אפשרות ליצור JSON

ייתכן שתיתקל בשגיאה הבאה בעת בדיקת בקשה: לא היתה אפשרות ליצור JSON. ערוך את הוראת ההנחיה ונסה שוב.

שגיאה זו עשויה להיות מכיוון שהמודל תקיף את פלט JSON עם מידע מטה-נתונים שמונע אימות מוצלח של תבנית JSON הנדרשת. כדי לפתור את הבעיה, נסה להוסיף את ההוראה הבאה לבקשה שלך: אל תכלול סימון JSON בתשובה שלך.

לא מוחזר JSON במצב זיהוי אוטומטי

ייתכן שלא מוחזר JSON לאחר בחירת הנחיה לבדיקה כאשר מצב זיהוי אוטומטי מופעל. ייתכן שהסיבה לכך היא שהוראות הבקשה סותרות את הוראת המערכת של החזרת JSON. ניתן לפתור זאת על-ידי שינוי הוראת הבקשה ובדיקה חוזרת.

תבנית JSON אינה מתעדכנת בזמן ריצה של בקשה

תבנית JSON העדכנית ביותר שזוהתה במצב זיהוי אוטומטי או בתבנית JSON העדכנית ביותר שהוגדרה במצב מותאם אישית נרשמה בזמן השמירה של הבקשה. תבנית JSON מוקלטת זו מוחלת בזמן ריצה של בקשה, ומבטיחה את העקביות של תבנית התגובה גם כאשר קלט דינאמי לבקשה משתנה.

מגבלות

• לא ניתן לשנות סכימת JSON.
• איננו תומכים בהגד הגדרת תבנית JSON ללא מפתחות שדה.
  דוגמה: ["abc", "def"] אינה נתמכת אך נתמכת [{"Field1": "abc"}, {"Field1": "def"}] .

מידע קשור

וידאו: בונה בקשות: פלטי JSON בבונה בקשות