הורדת תמלילים ונתוני אינטראקציה של Copilot

נציגי שירות לקוחות (נציגי שירות או נציגים) משתמשים בתכונות 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
סיכום שיחה "בעיה: בעיה עם שסתום הבישול במכונת הקפה. שלבים לפתרון בעיות: הלקוח דיווח על הבעיה. תוצאה: הבעיה דווחה לסיוע נוסף".

באפשרותך לאחזר את סיכום השיחה באופן הבא:

  1. זהה את מזהה השיחה, שהוא המזהה הראשי של הרשומה בטבלה msdyn_ocliveworkitem . בדוגמה שלנו, ערך זה הוא 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. השתמש בבקשת ה- 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 יוצר תגובה המבוססת על מאמר במאגר הידע. אם ברצונך להוריד את תמליל הצ'אט, בצע את השלבים הבאים:

  1. השתמש בקריאה ל- API באינטרנט כדי לקבל את מזהה האינטראקציה.

  2. סנן את טבלת 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}
  3. העתק את הערך של ה Trasncript.DataId - מ msdyn_interactioncontext- . בדוגמה שלנו, ערך זה הוא a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. בקשת ה- 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
    
  5. פענח את הנתונים המקודדים באמצעות מפענח 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 .

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

  1. קבל את הערך הנדרש של מזהה רשומת msdyn_copilotinteractiondata מהטבלה msdyn_copilotinteraction .

הערה

דלג על השלב הזה אם אתה משתמש בטבלה msdyn_copilotevents . זה msdyn_copilotinteractiondataid כבר זמין בטבלה msdyn_copilotevents .

  1. הפעל את בקשת ה- 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')
    
  2. הצג את המשוב המילולי הזמין בעמודה 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

באפשרותך להוריד את נתוני האינטראקציה באופן הבא.

  1. קבל את הערך הנדרש של מזהה רשומת msdyn_copilotinteractiondata מהטבלה msdyn_copilotinteraction .

הערה

דלג על השלב הזה אם אתה משתמש בטבלה msdyn_copilotevents . זה msdyn_copilotinteractiondataid כבר זמין בטבלה msdyn_copilotevents .

  1. הרץ את בקשת ה-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 
    

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

הערה

שאל שאלה, הצע תגובה ונסח תכונות דוא"ל השתמש במקודד base64 עם ערכת התווים UTF-16LE. סיכום אירוע ושיחה השתמש בערכת התווים UTF-8. מומלץ להשתמש באותה ערכת תווים ששימשה לקידוד נתונים כדי לפענח אותם.

צילום מסך של נתוני האינטראקציה המפוענחים.

שימוש ב-Copilot לצורך פתרון בעיות של לקוחות
הצג דוח ניתוח של Copilot