הבנת תעתיקי השיחה שהורדו Power Apps

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

חשוב

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

מאמר זה עוסק בהורדת תעתיקי שיחות Power Apps להשתמש בהם כדי ליצור דוחות ב- Power BI. כדי להוריד תעתיקים ישירות ב- Copilot Studio, ראה הורדת תעתיקים לשיחה ב- Copilot Studio.

כברירת מחדל, Power Apps מוריד תעתיקי שיחה מ- 30 הימים האחרונים. באפשרותך לשנות את תקופת השמירה.

הערה

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

תעתיקי שיחה אינם נכתבים עבור:

• Microsoft Dataverse עבור סביבת Teams
• סביבת Dataverse למפתחים
• סוכנים של Microsoft 365 Copilot

דרישה מוקדמת

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

הצגה וייצוא של תעתיקי שיחה מהפורטל של Power Apps

1. היכנס אל Power Apps.

2. בחלונית הצדדית, בחר טבלאות ולאחר מכן בחר הכל.

   

3. הזן "שיחה" בתיבת החיפוש.

4. בחר את הטבלה ConversationTranscript .

   נפתח דף עבור הטבלה ConversationTranscript .

5. בשורת התפריטים העליונה, בחר ייצוא>נתוני ייצוא.

   הידור הנתונים לייצוא נמשך כמה דקות.

   

6. המתן כמה דקות עד Power Apps להכין את הנתונים לייצוא ולאחר מכן בחר הורד נתונים מיוצאים.

   הקובץ נשמר כארכיון ZIP במיקום ההורדה המוגדר כברירת מחדל של הדפדפן שלך.

הבנת תעתיקי שיחות

תעתיק השיחה קיים כטבלה Dataverse שבאפשרותך להוריד כקובץ CSV (ערכים מופרדים באמצעות פסיקים). הלוגיקה הקובעת מתי וכיצד המערכת מתעדת מידע לתעתיקים של שיחות:

• המערכת תחסוך שיחה ברשומת תעתיק לאחר 30 דקות של חוסר פעילות. אם השיחה מחדשת את פעולתה לאחר זמן חוסר הפעילות, Name המערכת תחסוך את הפעילויות החדשות ברשומה חדשה עם אותו ערך אך עם ערך ConversationStartTime חדש.
• עבור סוכנים שפורסמו בערוץ הטלפוניה, שיחות פגות תוקף שלוש דקות לאחר אירוע סיום שיחה.
• לכל רשומה יש מגבלה של 1 MB עבור התעתיק (Content עמודה). כאשר תעתיק גדול ממגבלה זו, המערכת מפצלת את התעתיק לרשומות מרובות, NameConversationStartTime וכל זאת כוללות ערכים זהים, אך עם ערכים Metadata.BatchId שונים.
• כדי למזג תעתיקים, קח את כל הרשומות עם אותם Name ערכים ConversationStartTime וערכים ולאחר מכן מיין רשומות אלה לפי BatchId.

הטבלה הבאה מתארת את השדות החשובים ביותר בתעתיקי השיחה שלך.

שדה	תיאור	דוגמה
Content	התעתיק כולו בתבנית JSON	ראה שדה תוכן
ConversationStartTime	הזמן שבו השיחה התחילה (לא הזמן שבו רשומת התעתיק נכתבה במאגר הנתונים)	2021-04-19T20:39:09Z
ConversationTranscript	המזהה הייחודי של השורה בטבלה Dataverse	28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata	JSON הכולל את מזהה הסוכן, מזהה דייר, שם סוכן ומזהה אצווה	{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name	שם השורה המותאמת אישית שנוצרה ולאחר ConversationId מכן BotId	8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript	מזהה הסוכן	aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on	התאריך והשעה של יצירת רשומת התעתיק	2021-04-20T02:40:13Z

שדה תוכן

השדה Content הוא יומן רישום גולמי של כל הפעילויות שהיו למשתמשים עם הסוכן. סוגי הפעילויות הנפוצים כוללים הודעה ואירוע:

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

לקבלת מידע נוסף אודות סוגי פעילות, ראה Bot Framework Activity schema.

הטבלה הבאה מתארת כמה משדות המפתח ב- JSON של התוכן:

מפתח	תיאור
ID	ה- GUID הייחודי של אובייקט הפעילות
valueType	סוג הערך המאוחסן בפעילות; הכתבת המידע שהפעילות מספקת (סוגי ערכי פעילות נפוצים)
timestamp	חותמת הזמן של הזמן שבו נוצרה הפעילות, בתבנית Epoch (מספר השניות מאז חצות UTC ב- 1 בינואר 1970)
type	סוג הפעילות; לדוגמה, message, event, או trace
replyToId	מזהה הפעילות שהפעילות הנוכחית מגיבה לה
from	מכיל שדות ו id - role: id - המזהה של המפעיל role - מחזיק 0 או 1 0 - הפעילות מגיעה מהסוכן 1 - הפעילות מגיעה מהמשתמש המקיימים אינטראקציה עם הסוכן הערות: ניתן id להשתמש באפשרות זו לחישוב מספר המשתמשים הפעילים המקיימים אינטראקציה עם הסוכן אם בד הציור מעביר מזהה ייחודי של המשתמש. אם בד הציור אינו מעביר מזהה, מועבר מזהה ייחודי לכל שיחה. עבור אבטחה ופרטיות, המערכת קוד Hash של המזהה לפני כתיבת המזהה לתעתיק.
channelId	מזהה הערוץ ממנו מגיעה הפעילות; לדוגמה, directline, msteams, או facebook
textFormat	תבנית הטקסט; לדוגמה, plain או markdown
attachments	נתונים עשירים דינאמיים המשויכים לפעילות; לדוגמה, AdaptiveCards, HeroCards, או Carousel data
text	הטקסט עבור message פעילויות
value	שדות ספציפיים לפעילות בהתבסס על סוג הערך; שדה זה הוא המקום שבו רוב המידע השימושי קיים
channeldata	מכיל נתוני ערוץ: עבור הודעות: DialogTraceDetail DialogErrorDetail VariableDetail (מכיל את הערך שהוקצה למשתנה) CurrentMessageDetail עבור אירועים: cci_trace_id traceHistory enableDiagnostics clientTimestamp clientActivityId
name	שם פעילות האירוע; לדוגמה SetPVAContext

סוגי ערכי פעילות נפוצים

סוג ערך פעילות	תיאור
ConversationInfo	אם השיחה היא מחלונית Copilot Studio (isDesignMode) ומהי אזור השיחה
CSATSurveyRequest	למשתמש מוצג סקר שביעות רצון של לקוחות (CSAT)
CSATSurveyResponse	המשתמש מגיב לסקר CSAT
DialogRedirect	המשתמש מנותב מחדש לנושא אחר
ImpliedSuccess	המשתמש הגיע לצומת שאלה בנושא, שבו אחד מהתנאים מצביע על מערכת CSAT בנושא הצלחה מאושרת (בוטים קלאסיים בלבד) או מפעיל את הנושא של מערכת סיום השיחה
IntentRecognition	המשתמש הפעיל נושא
PRRSurveyRequest	המשתמש נשאל אם הנושא ענה על השאלה שלו מנושא סוף השיחה
PRRSurveyResponse	תגובת המשתמש לשאלה אם הנושא ענה על השאלה שלו מסיום השיחה
SessionInfo	סוג (unengaged או engaged), תוצאה (Escalated, Resolved, Abandon), שעת ההתחלה ושעת הסיום של ההפעלה (startTimeUtc, endTimeUtc), ומספר הפניות של ההפעלה
VariableAssignment	ערך מוקצה למשתנה

תעתיקים משופרים

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

הפעל תעתיקים משופרים

1. פתח את הסוכן שלך.

2. עבור אל הגדרות>מתקדמות.

3. בחר שפר תעתיקים ולאחר מכן הפעל את כלול פרטים ברמת הצומת בתעתיקים.

נתונים ברמת הצומת

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

מפתח	תיאור
nodeID	מזהה הצומת
nodeType	סוג הצומת, לדוגמה, SendActivity או SearchAndSummarizeContent
startTime	חותמת הזמן כאשר הצומת הופעל
endTime	המועד בו הצומת סיים לבצע
topicDisplayName	הנושא מפעיל את הצומת

ניתוח מותאם אישית

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

פתרון Conversation KPI ב- Copilot Studio Kit מנתח באופן אוטומטי תעתיקים מאכלס נתונים מצטברים בטבלאות Dataverse.

שינוי תקופת השמירה המהווה ברירת מחדל

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

הערה

אם תשנה את תקופת השמירה Dataverse המהווה ברירת מחדל, רק ניתוחים מותאמים אישית יושפעו. תקופת השמירה עבור דף הניתוח ב- Copilot Studio אינה מושפעת.

ביטול פעולה קיימת למחיקה גורפת

1. ב- Power Apps, בחר Settings>הגדרות מתקדמות.

   פורטל Dynamics 365 נפתח בכרטיסיה חדשה.

   

2. בחר בסמל ההסמן לצד הגדרות. תחת System, בחר ניהול נתונים.

   

3. בחר מחיקת רשומה בצובר.

4. ברשימה תצוגה , בחר משימות מערכת חוזרות של מחיקה בצובר.

   

5. בחר את המשימה מחיקת רשומות תעתיקי שיחה ישנות מגיל חודש אחד.

   

6. ברשימה פעולות נוספות , בחר ביטול.

   

יצירת משימת מחיקה בצובר חדשה

1. בחר חדש כדי להפעיל את אשף המחיקה בצובר. באשף, בחר הבא.

2. הגדר את קריטריוני החיפוש הבאים:

   • ברשימה חפש, בחר ConversationTranscripts.
   • בחר ConversationStartTime, בחר שגילם עולה על X חודשים והזן "12".
     ההגדרה הזו שומרת את התעתיקים למשך 12 חודשים. בחר השוואה וערך שונים אם תרצה.
   • בחר SchemaType, שמור כשווה והזן "powervirtualagents".

   

3. בחר הבא.

4. הזן שם עבור המשימה, בחר הפעל משימה זו אחרי כל והזן 1. בחר לוח זמנים אחר אם אינך מעוניין שהמשימה תרוץ מדי יום.

   

5. בחר הבא ולאחר מכן בחר שלח.

מדוע איני יכול לראות את תעתיקי השיחה שלי בטבלת הדו Power Apps ConversationTranscript?

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

חשוב

תעתיקים אינם מאוחסנים עבור סוכנים הפרוסים בסביבות מפתחים.

עצות להפיק את המרב מתעתיקי השיחה שלך

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

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