הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
נציגי שירות לקוחות (נציגי שירות או נציגים) משתמשים בתכונות Copilot כגון העתקת סיכומים, שימוש בתשובה מוצעת, משוב וצ'אט. אינטראקציות Copilot מאוחסנות בטבלאות אינטראקציה של Copilot (msdyn_copilotinteraction),נתוני אינטראקציה של Copilot (msdyn_copilotinteractiondata), תעתיק Copilot (msdyn_copilottranscript)ונתוני תעתיק Copilot (msdyn_copilottranscriptdata) ב- Dataverse. באפשרותך להוריד את התעתיקים ונתוני האינטראקציה באמצעות Dataverse Web API או SDK עבור .NET.
החל מאוגוסט 2025, אינטראקציות הטייס המשני מאוחסנות בטבלת msdyn_copilotevents . טבלאות msdyn_copilotinteraction ו-msdyn_copilotinteractiondata מכילות רשומות מלפני אוגוסט.
דרישות מוקדמות
- ודא שתיבת הסימון נתוני חוויית תמיכה נבחרה ב- Copilot עבור שאלות והודעות דואר אלקטרוני, כך שנתוני העסקאות והאינטראקציה יאוחסנו על-ידי המערכת ב- Dataverse.
- ודא שאתה מחובר עם התפקיד מנהל ריבוי ערוצים או מפקח ריבוי ערוצים.
אחזור סיכום שיחה
כאשר נציג שירות משתמש ב- Copilot כדי ליצור סיכום שיחה, הסיכום מאוחסן בטבלה msdyn_conversationinsight ב- Dataverse. רשומה נוצרת בטבלה עם מזהה שיחה ייחודי המאוחסן בשדה msdyn_ConversationId . טקסט התקציר מאוחסן בשדה msdyn_copilotsummary .
לדוגמה, לאחר סיום שיחה עם לקוח, נציג שירות משתמש ב- Copilot כדי ליצור סיכום שיחה. סיכום השיחה מאוחסן בטבלה msdyn_conversationinsight עם הערכים הבאים.
| תכונה | ערך לדוגמא |
|---|---|
| מזהה שיחה | 70b76ab52-120b-49e6-9dce-53f235125a01 |
| סיכום שיחה | "בעיה: בעיה עם שסתום הבישול במכונת הקפה. שלבים לפתרון בעיות: הלקוח דיווח על הבעיה. תוצאה: הבעיה דווחה לסיוע נוסף". |
באפשרותך לאחזר את סיכום השיחה באופן הבא:
זהה את מזהה השיחה, שהוא המזהה הראשי של הרשומה בטבלה
msdyn_ocliveworkitem. בדוגמה שלנו, ערך זה הוא 70b76ab52-120b-49e6-9dce-53f235125a01.השתמש בבקשת ה- Web API הבאה כדי לסנן את רשומת הטבלה
msdyn_conversationinsight.[Organization URI]/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '<conversation-ID>'בדוגמה שלנו, בקשת ה- Web API היא כדלקמן.
https://<yourorg>.crm.dynamics.com/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '70b76ab52-120b-496e-9dce-53f235125a01'התגובה לדוגמה לדוגמא שלנו היא כדלקמן:
{ "status": { "code": 20000, "message": "Successfully fetched summary from insights" }, "summary": "Issue: Trouble with the brew valve on the coffee machine.\nTroubleshooting steps: \n- Customer reported the issue.\nOutcome: Issue reported for further assistance." }
היכן מאוחסנות האינטראקציות של טייס המשנה שלי
כל אינטראקציה של נציג שירות עם Copilot מאוחסנת בטבלת msdyn_copilotinteraction ה-OR msdyn_copilotevents עם מזהה אינטראקציה ייחודי. הטבלה הבאה מפרטת היכן מאוחסנים נתוני האינטראקציה המתאימים עבור כל סוג אינטראקציה.
| תכונה | טבלה |
|---|---|
| שאל שאלה | msdyn_copilottranscriptdata |
| משוב, סיכום מקרה, כתיבת דוא"ל, הצעת תגובה |
msdyn_copilotinteractiondata, msdyn_copilotevents |
הערה
רשומות אינטראקציה של Copilot נשמרות בטבלה msdyn_copilotevents החל מאוגוסט 2025. רשומות לפני אוגוסט מאוחסנות בטבלאות msdyn_copilotinteraction ה-AND msdyn_copilotinteractiondata .
השג את ה-msdyn_copilotinteractionid ואת ה-msdyn_interactiondataid מרשומות אינטראקציה של Copilot.
לפני שתבצע פעולות כגון הורדת תעתיק או הצגת משוב מילולי, עליך לאחזר את הערכים של msdyn_copilotinteractionid ואת ערך מזהה הרשומה msdyn_copilotinteractiondata המתאים מ msdyn_copilotinteraction- . באפשרותך להשתמש בקריאת Web API הבאה כדי להשיג את מזהה האינטראקציה msdyn_copilotinteractionid בשדה ואת interactiondataid בשדה msdyn_interactiondataid_value .
[Organization URI]/api/data/v9.1/msdyn_copilotinteractions
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
קבלו msdyn_copilotinteractionid מ-Copilot Event Records
לפני שאתה מוריד תמלול או צופה במשוב מילה במילה, עליך לשלוף את הערכים של msdyn_copilotinteractionid מהטבלה msdyn_copilotevents . ניתן להשתמש בקריאת API הרשת הבאה כדי לקבל את מזהה האינטראקציה בשדה msdyn_copilotinteractionid .
[Organization URI]/api/data/v9.2/msdyn_copilotevents
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
תכונות מרכזיות
התכונות העיקריות מהרשומה הן כדלקמן.
| תכונה | הגדרה |
|---|---|
| msdyn_copilotinteractionid | מזהה ייחודי עבור מופעי ישות |
| msdyn_scenariorequestid | מקבץ אינטראקציות קשורות מרובות של Copilot. לדוגמה: נציג שואל את Copilot שאלה ולאחר מכן מסמן את התגובה שהתקבלה באגודל למעלה. הן נחשבות לשתי אינטראקציות, אך הן חלק מאותו תרחיש. |
| msdyn_scenariotype | מתייחס לתכונה המשמשת את הנציג. |
| msdyn_interactiontype | מתייחס לאינטראקציה הייצוגית הספציפית עם Copilot. |
| msdyn_interactionforid | מזהה הישות של הרשומה שאליה בוצעה הפניה, שעבורה הנציג קיים אינטראקציה עם Copilot. |
| msdyn_interactionforlogicalname | השם הלוגי של הישות של הרשומה שאליה בוצעה הפניה, שעבורה הנציג קיים אינטראקציה עם Copilot. |
| msdyn_interactioncontext | הקשר נוסף כגון הפניה לתמלילים. |
| msdyn_interactiondataid | מפנה לישות msdyn_copilotinteractiondata המכילה נתוני אינטראקציה |
תגובה לדוגמה
התגובה הבאה מציינת תרחיש שבו נציג שואל את Copilot שאלה ולאחר מכן בוחר בלחצן אגודל למטה כדי לספק משוב. ה msdyn_scenariorequestid- , msdyn_scenariotype זהה עבור שתי האינטראקציות. הערכים msdyn_interactiontype עבור האינטראקציות מוגדרים כ- 100230305 ו- 100230302, המתאימים ל- Generated ו- Thumbs down.
{
"@odata.etag": "W/\"17413914\"",
"msdyn_interactiontype": 100230305,
"msdyn_clienttimestamp": "2025-03-19T08:00:34Z",
"modifiedon": "2025-03-19T08:00:34Z",
"msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
"overriddencreatedon": null,
"msdyn_scenariotype": 100230201,
"importsequencenumber": null,
"_modifiedonbehalfby_value": null,
"msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
"statecode": 0,
"msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
"_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
"versionnumber": 17413914,
"utcconversiontimezonecode": 190,
"_msdyn_interactiondataid_value": null,
"_createdonbehalfby_value": null,
"_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"createdon": "2025-03-19T08:00:34Z",
"msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}",
"msdyn_name": null,
"statuscode": 1,
"msdyn_copilotinteractionid": "c49dc43b-9804-f011-bae2-6045bd014292",
"_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"timezoneruleversionnumber": 0
},
{
"@odata.etag": "W/\"17413983\"",
"msdyn_interactiontype": 100230302,
"msdyn_clienttimestamp": "2025-03-19T08:00:37Z",
"modifiedon": "2025-03-19T08:00:41Z",
"msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
"overriddencreatedon": null,
"msdyn_scenariotype": 100230201,
"importsequencenumber": null,
"_modifiedonbehalfby_value": null,
"msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
"statecode": 0,
"msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
"_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
"versionnumber": 17413983,
"utcconversiontimezonecode": 190,
"_msdyn_interactiondataid_value": null,
"_createdonbehalfby_value": null,
"_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"createdon": "2025-03-19T08:00:41Z",
"msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"IsEmbed\":false,\"IsStandalone\":false}",
"msdyn_name": null,
"statuscode": 1,
"msdyn_copilotinteractionid": "cb9dc43b-9804-f011-bae2-6045bd014292",
"_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"timezoneruleversionnumber": 0
},
הורדת תמלילי צ'אט
כאשר נציג שירות שואל את Copilot שאלה, הצ'אט נשמר כתעתיק המקודד בתבנית המקודדת base64 באמצעות ערכת תווים UTF-16LE בטבלה msdyn_copilottranscriptdata ב- Dataverse. אתה יכול להוריד את התמלילים כדי לסקור את השיחה והתגובות שסופקו על ידי Copilot.
לדוגמה, בזמן עבודה על מקרה, נציג השירות שואל את Copilot "איך אני יכול להזמין נסיעה?". Copilot יוצר תגובה המבוססת על מאמר במאגר הידע. אם ברצונך להוריד את תמליל הצ'אט, בצע את השלבים הבאים:
השתמש בקריאה ל- API באינטרנט כדי לקבל את מזהה האינטראקציה.
סנן את טבלת msdyn_copilotinteraction עם מזהה האינטראקציה הנדרש כדי להגיע לתכונה
Transcript.DataIDמאתmsdyn_interactioncontext. השתמש בבקשת ה- Web API הבאה כדי לסנן את הנתונים לפי מזהה אינטראקציה.[Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>) Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0תכונה ערך לתרחיש שלנו msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867 msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf msdyn_scenariotype שאל שאלה msdyn_interactiontypename נוצר msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (המקרה שממנו החלה האינטראקציה) msdyn_interactioncontext {\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}העתק את הערך של ה
Trasncript.DataId- מmsdyn_interactioncontext- . בדוגמה שלנו, ערך זה הוא a1584aaf-d5bd-357d-54a8-84dbdba547f9.בקשת ה- Web API הבאה מאחזרת את התעתיק המקודד בתבנית base64/UTF-16LE.
[Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Transcript:DataID>)/msdyn_transcriptdata Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0בדוגמה שלנו, בקשת ה- Web API היא כדלקמן.
[Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdataפענח את הנתונים המקודדים באמצעות מפענח base64 עם אפשרות ערכת התווים UTF-16LE כדי לקבל את התמליל. אתה יכול להשתמש בכלי מפענח מקוון כדי לפענח את הנתונים. לדוגמא שלנו, התמליל המפוענח מוצג באופן הבא.
{ "messages": [ { "id": "283c2269-b131-dac2-3aed-847bd99402e7", "requestId": "93893746-e203-e9b6-18b9-887d68d18daf", "message": "How can I book a trip?", "sequence": 0, "user": "user", "timestamp": 1711052758750, "isActivityError": false, "context": {} }, { "id": "eba9e9d5-71e2-9502-0bca-9387246fb094", "requestId": "93893746-e203-e9b6-18b9-887d68d18daf", "message": "To book a trip, follow these steps:\n\n1. Go to the travel portal.\n2. Click on \"Travel\" and then select \"Book a Trip\".\n3. Fill in your name, contact information, and the dates of your trip.\n4. Choose your destination from the drop-down menu. Here's the data you'll be working with:\n\n```json\n{\n \"id\": \"11bb11bb-cc22-dd33-ee44-55ff55ff55ff\",\n \"title\": \"Booking Travel\",\n \"source\": \"internal_kb\"\n}\n```\n\n5. Select a hotel from the drop-down menu and specify the check-in and check-out dates. If you don't want to book a hotel, you can check the \"I do not want to book a hotel\" box.\n6. Choose the type of rental car you want. If you don't want to rent a car, you can check the \"I do not want to rent a car\" box.\n7. Click \"Submit\".\n\nOnce you've submitted your booking request, you will receive a follow-up communication from a representative with a quote. You can also add any notes or additional information by clicking on the case from the My Bookings screen.", "sequence": 1, "user": "bot", "timestamp": 1711052776968, "isActivityError": false, "sources": [ { "id": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff", "title": "Booking Travel", "source": "internal_kb" } ], "context": { "customerIntent": "How to book a trip?" } } ], "context": { "chatId": "21b27e83-299d-a639-3e4a-8dcd6332e184", "sessionId": "session-id-2", "entityId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff", "entityName": "knowledgearticle" } }
אחזור משוב מילולי
כאשר נציג מקיים אינטראקציה עם Copilot, הוא יכול לספק משוב על התגובות ש-Copilot מספק. המשוב מאוחסן בעמודה msdyn_verbatim בטבלה msdyn_copilotinteractiondata ב- Dataverse.
לדוגמה, התגובה של Copilot אינה מדויקת והנציג בוחר בסמל האגודל למטה כדי לספק משוב. הנציג גם מספק משוב מילולי. היישום יוצר רשומה בטבלה msdyn_copilotinteraction עם ההגדרה msdyn_interactiontypename ל- ThumbsDown.
התכונות העיקריות עבור הרשומה הן כדלקמן.
| תכונה | נתונים לדוגמה עבור הדוגמה שלנו |
|---|---|
| msdyn_copilotinteractionid | 817ff9e4-cbe7-ee11-904c-000d3a3bb867 |
| msdyn_scenariorequestid | 93893746-e203-e9b6-18b9-887d68d18daf |
| msdyn_scenariotype | שאל שאלה |
| msdyn_interactiontype | 100230302 |
| msdyn_interactiontypename | ThumbsDown |
| msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
| msdyn_interactiondataid | 807ff9e4-cbe7-ee11-904c-000d3a3bb867 |
| מזהה מחיצה | 20250622-20250628-100230203 |
הערה
PartitionID רלוונטי רק אם אתה משתמש בטבלה msdyn_copilotevents .
ניתן לקבל את המשוב המילולי שסופק על ידי הנציג כדלקמן.
-
קבל את הערך הנדרש של מזהה רשומת msdyn_copilotinteractiondata מהטבלה
msdyn_copilotinteraction.
הערה
דלג על השלב הזה אם אתה משתמש בטבלה msdyn_copilotevents . זה msdyn_copilotinteractiondataid כבר זמין בטבלה msdyn_copilotevents .
הפעל את בקשת ה- Web API הבאה כדי לאחזר את המשוב המילולי
אם אתה משתמש בטבלה
msdyn_copilotevents, השתמש בדברים הבאים:[Organization URI]/api/data/v9.1/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')בדוגמה שלנו, בקשת ה-API של ה-Web היא כדלקמן:
[Organization URI]/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')הצג את המשוב המילולי הזמין בעמודה
msdyn_verbatim. לדוגמא שלנו, המשוב שאוחזר הוא כדלקמן.{ "@odata.etag": "W/\"29538313\"", "_owningbusinessunit_value": "0e9ec0a2-eb6a-ed11-9561-000d3a336228", "statecode": 0, "statuscode": 1, "_createdby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "msdyn_copilotinteractiondataid": "807ff9e4-cbe7-ee11-904c-000d3a3bb867", "_ownerid_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "modifiedon": "2024-03-21T21:42:21Z", "msdyn_verbatim": "Article is outdated", "_owninguser_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "_modifiedby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "versionnumber": 29538313, "createdon": "2024-03-21T21:42:21Z", "msdyn_interactiondata_name": null, "overriddencreatedon": null, "importsequencenumber": null, "_modifiedonbehalfby_value": null, "msdyn_interactiondata": null, "utcconversiontimezonecode": null, "_createdonbehalfby_value": null, "msdyn_name": null, "_owningteam_value": null, "timezoneruleversionnumber": null }
הורדת נתוני אינטראקציה
למעט תמלולי שאלה, בכל שאר האינטראקציות בין נציגים ל-Copilot, הנתונים נשמרים בטבלת msdyn_copilotinteractiondata ה-OR msdyn_copilotevents ב-Dataverse.
לדוגמה, אינטראקציה יכולה להיות נציג המשתמש ב- Copilot כדי ליצור הודעת דואר אלקטרוני או סיכום אירוע. התכונות העיקריות לדוגמא שלנו הן כדלקמן.
| תכונה | ערך לתרחיש שלנו |
|---|---|
| msdyn_copilotinteractionid | 0dd941e5-34e7-ee11-904c-000d3a3bb867 |
| msdyn_scenariorequestid | 42ae7f8e-736f-1cea-035b-6bf970b48e9c |
| msdyn_scenariotype | סיכום המקרה |
| msdyn_interactiontype | 100230305 |
| msdyn_interactiontypename | נוצר |
| msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
| msdyn_interactioncontext | {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}} |
| msdyn_interactiondataid | f9d841e5-34e7-ee11-904c-000d3a3bb867 |
באפשרותך להוריד את נתוני האינטראקציה באופן הבא.
-
קבל את הערך הנדרש של מזהה רשומת msdyn_copilotinteractiondata מהטבלה
msdyn_copilotinteraction.
הערה
דלג על השלב הזה אם אתה משתמש בטבלה msdyn_copilotevents . זה msdyn_copilotinteractiondataid כבר זמין בטבלה msdyn_copilotevents .
הרץ את בקשת ה-Web API הבאה כדי לאסוף את נתוני האינטראקציות בפורמט המקודד של base64:
אם אתה משתמש בטבלת msdyn_copilotevents, השתמש בדברים הבאים:
<org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')/msdyn_interactiondata/$valueבדוגמה שלנו, בקשת ה-API של ה-Web היא כדלקמן:
<org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
- פענח את הנתונים המקודדים base64 כדי לקבל את התמליל. אתה יכול להשתמש בכלי מפענח base64 מקוון כדי לפענח את הנתונים. בדוגמת הדוא"ל שלנו, נתוני האינטראקציה המפוענחים מוצגים באופן הבא.
הערה
שאל שאלה, הצע תגובה ונסח תכונות דוא"ל השתמש במקודד base64 עם ערכת התווים UTF-16LE. סיכום אירוע ושיחה השתמש בערכת התווים UTF-8. מומלץ להשתמש באותה ערכת תווים ששימשה לקידוד נתונים כדי לפענח אותם.
מידע קשור
שימוש ב-Copilot לצורך פתרון בעיות של לקוחות
הצג דוח ניתוח של Copilot