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

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

הפעולה מעדכנת את שדות קטגוריית הדוא"ל (AI)ומצב הסיווג ברשומת האימייל.

חשוב

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

דרישות מוקדמות

  • סיווג דואר אלקטרוני זמין ומופעל ב-Dynamics 365 Customer Service.
  • לפחות שתי קטגוריות דוא"ל פעילות מוגדרות.
  • חיוב בתשלום לפי שימוש מופעל עבור הסביבה.
  • ההרשאות הנדרשות של Copilot, סוכן AI ואישורי חוצה גאוגרפיה מופעלים.
  • רשומת האימייל קיימת ב-Dataverse.
  • המשתמש שמפעיל את הפעולה מקבל הרשאות לקרוא ולעדכן את רשומת הדוא"ל ולקרוא את תצורת סיווג הדוא"ל.

פרטי הבקשה

מאפיין‬ ערך:
שם ייחודי msdyn_EmailClassificationCustomAction
איגוד גלובלי או לא קשור
השיטה POST
Web API URL https://<organization-url>/api/data/v9.2/msdyn_EmailClassificationCustomAction
הפעלת Power Automate Microsoft Dataverse - ביצוע פעולה בלתי מוגבלת

בקש פרמטרים

פרמטר סוג חובה תיאור
emailId מחרוזת ‏‏כן‬ GUID של רשומת אימייל קיימת ב-Dataverse. העבר את מזהה השורה כטקסט ללא גשר.
doRuleEvaluation בוליאני ‏‏כן‬ קובע האם תנאי סיווג הדוא"ל המוגדרים מוערכים. השתמש true כדי להחיל את התנאים שהמנהל מוגדר על ידי המנהל. השתמש רק false כאשר זרימת השיחות בודקת אם המייל עומד בתנאים הנדרשים לפני שהוא קורא לפעולה.
isSimulationMode בוליאני לא מאפשר התנהגות סימולציה ספציפית ליישום. שימוש false לסיווג ייצור.
additionalInfo מחרוזת לא מכיל נושא וגוף מקודדים ב-JSON לסימולציה של תוכן בלבד. השאר ערך זה ריק לסיווג הייצור.

לסיווג הייצור, העבר את מזהה שורת האימייל, הגדר doRuleEvaluation ל true, הגדר isSimulationMode ל false, והשאר additionalInfo ריק.

מאפייני תגובה

מאפיין‬ סוג תיאור
emailclassificationResponse מחרוזת תוצאת סיווג מקודדת ב-JSON הכוללת את פרטי הקטגוריה, הסיבה וההיררכיה האופציונלית.
matchedCategoryId מחרוזת GUID של השורה התואמת msdyn_emailclassificationcategory . השתמש בערך זה להסתעפות דטרמיניסטית וחיפושים ב-Dataverse.
status מחרוזת אובייקט מקודד ב-JSON שמכיל קוד והודעה ברמת היישום.

גם status וגם emailclassificationResponse מכילים JSON המאוחסנים כמחרוזות, לא כאובייקטי JSON מקוריים. חלק מהמסלולים של דרישה מוקדמת, מדלגים ומסלולי חריגות יכולים להחזיר מחרוזות ריקות. בדוק שכל ערך אינו ריק לפני שאתה מנתח אותו עם הביטוי Power Automatejson().

קרא לפעולה מ-Power Automate

  1. הוסף טריגר ל-Dataverse, או השתמש בשלב זרימה מוקדם יותר שמספק את מזהה של רשומת אימייל קיימת.
  2. הוסף את Microsoft Dataverse - בצע שלב פעולה בלתי מוגבל.
  3. לשם פעולה, בחר msdyn_EmailClassificationCustomAction.
  4. ממפה emailId למזהה שורה במייל, בדרך כלל activityid.
  5. הגדר doRuleEvaluation ל- true, אלא אם הזרימה מפעילה סינון זכאות שקול.
  6. הגדר isSimulationMode על false, והשאיר additionalInfo ריק.
  7. אשר שזה status לא ריק, ואז פרש את זה כ-JSON.
  8. המשך רק כשהוא 200 ריק וכשאינו status.codematchedCategoryId ריק.
  9. שימוש matchedCategoryId בניתוב מבוסס קטגוריה או אוטומציה אחרת.

כדי לנתח את הסטטוס, השתמשו בביטוי הבא. החלף Perform_an_unbound_action אם לפעולה שלך יש שם שונה.

json(body('Perform_an_unbound_action')?['status'])

כדי לנתח את תוצאת הסיווג, השתמשו בביטוי הבא:

json(body('Perform_an_unbound_action')?['emailclassificationResponse'])

חשוב

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

דוגמה לבקשה

POST https://<organization-url>/api/data/v9.2/msdyn_EmailClassificationCustomAction
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
  "emailId": "<email-guid>",
  "doRuleEvaluation": true,
  "isSimulationMode": false
}

דוגמה לתגובה מוצלחת

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://<organization-url>/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.msdyn_EmailClassificationCustomActionResponse",
  "emailclassificationResponse": "{\"index\":1,\"category\":\"Marketing\",\"reason\":\"The email promotes a product or service.\",\"status\":null}",
  "matchedCategoryId": "<category-guid>",
  "status": "{\"code\":200,\"message\":\"Success\"}"
}

שדות תגובה לסיווג

המנותח emailclassificationResponse יכול להכיל את השדות הבאים.

שדה תיאור הנחיות שימוש
index מיקום מבוסס אפס של הקטגוריה הנבחרת בבקשת הבינה המלאכותית. אל תשתמש בערך הזה כמזהה עמיד.
category שם הקטגוריה שנבחרה. שימוש לתצוגה. ניתן לערוך שמות קטגוריות.
reason הסבר שנוצר על ידי בינה מלאכותית לבחירה. שימוש לתצוגה או לאבחון, לא להסתעפות דטרמיניסטית.
selectedPath מסלול היררכיה אופציונלי כאשר מסווג היררכי מופעל. השתמש רק כאשר הערך קיים.
finalCategory צומת היררכיה סופית אופציונלית שנבחר על ידי השירות. הפעולה משתמשת בערך זה כדי לפתור את קטגוריית Dataverse.
confidence מידע אופציונלי על ביטחון לתוצאות היררכיות. אל תניח שהערך הזה תמיד קיים.
evidence ראיות מודל אופציונליות לתוצאות היררכיות. אל תניח שהערך הזה תמיד קיים.

ערכי סטטוס סיווג

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

לטפל בתוצאות פעולה

צעד פעולה מוצלח ב-Power Automate לא תמיד אומר שהסיווג הצליח. הסיווג מצליח רק כאשר:

  • שלב הפעולה מצליח.
  • status נוכח.
  • הערך המנותח status.code הוא 200.
  • matchedCategoryId לא ריק.

השתמשו בהנחיות הבאות לתוצאות נוספות:

תרחיש אופן פעולה צפוי טיפול בזרימה מומלץ
תנאי זכאות לא תואם. מחרוזות תגובה יכולות להיות ריקות, וסטטוס הסיווג נדלג. לסיים את הזרימה כרגיל או להשתמש במסלול לא מסווג.
אין אישור Copilot או אישור חוצה גאוגרפיה נדרש. מחרוזות תגובה יכולות להיות ריקות, וסטטוס הסיווג נדלג. תתעד בעיה בסביבה או תצורה.
פחות משתי קטגוריות פעילות מוגדרות. הסטטוס הלוגי יכול להיות ריק, וסטטוס הסיווג הוא כשל. הודע למנהל המערכת כדי לתקן את הגדרת הקטגוריה.
שירות הסיווג מחזיר שגיאת HTTP. status מכיל את קוד ה-HTTP וההודעה של השירות. השתמש במדיניות מבוקרת של ניסיון חוזר והסלמה.
אף קטגוריה לא מוחזרת. status.code הוא 500, והמסר הוא No category returned. תתעד את הכשל ותשתמש בגיבוי בטוח.
לא התקבלה תגובת שירות. status.code הוא 500, והמסר הוא No response from API. תתעד את הכשל ותשתמש בגיבוי בטוח.
מזהה הדוא"ל אינו תקין או שהמשתמש המתקשר חסר הרשאת Dataverse נדרשת. שלב הזרימה יכול להיכשל, או שהפלטים הלוגיים יכולים להיות ריקים. השתמש ב-Configure run after כדי ללכוד ולרשום את הכישלון.
  • ‏‏עודכן לאחרונה בתאריך