הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
רלוונטי ל: Dynamics 365 Customer Service
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת זו כאשר ברצונך לשנות שדה בתיק תמיכה, כמו עדיפות, כותרת, תיאור או פרטים נוספים.
מה הוא עושה
העוזר מעדכן שדה אחד או יותר ברשומת התיק. אתה יכול לשנות את רמת העדיפות בשפה פשוטה, לשנות את הלקוח או רשומה קשורה אחרת בשם, או לעדכן כל שדה תיק אחר על ידי ציון מה אתה רוצה לשנות. העוזר מאשר אילו שדות עודכנו לאחר החלת השינוי.
נסה הנחיות כמו
- הגדר את העדיפות של CAS-01010-A0A0A0 לגבוה.
- שנה את כותרת התיק הזה לבעיית התחברות.
- עדכן את התיאור של המקרה הזה.
- הגדר עדיפות על נמוך.
- סמנו את התיק הזה כממתין לפרטים.
- החלף את הלקוח בתיק CAS-01010-A0A0A0 ל-Contoso Ltd.
מה שתראו בצ'אט
העוזר מאשר את העדכון באמצעות תגובת טקסט שמפרטת את השדות שהושתנו. לא מוצג רכיב אינטראקטיבי לפעולה זו.
אם אתה מציין לקוח או רשומה קשורה אחרת ויותר מרשומה אחת תואמות, העוזר מפרט את ההתאמות ושואל לאיזו מהן אתה מתכוון. אם שום דבר לא תואם, זה אומר לך במקום לדווח על שינוי שלא קרה.
עצות שימושיות
- אתה יכול להתייחס למזוודה לפי מספר התיק (למשל, CAS-01010-A0A0A0) או לתת לעוזר להשתמש בתיק שכבר עובד איתו.
- לשינויים בעדיפות, השתמשו ב"גבוה", "רגיל" או "נמוך".
- אפשר לעדכן מספר שדות בבקשה אחת.
- בעת שינוי הלקוח, ציין את שם החשבון או איש הקשר (לדוגמה, "Contoso Ltd"). אם השם לא ברור, העוזר מבקש ממך לבחור.
- אם ברצונך לסגור תיק, השתמש ב"סגור את התיק הזה" במקום זאת—זו פעולה נפרדת עם רשומת פתרון.
עצה
פתח את התיק קודם עם "הראה לי את ה-case CAS-01010-A0A0A0" כדי לבדוק את השדות הנוכחיים לפני העדכון.
מה קורה הלאה?
לאחר העדכון, תוכל להמשיך עם רעיונות כמו:
- תראה לי את המזוודה הזו.
- סיכם את המקרה הזה.
- מה מצב ה-SLA בתיק הזה?
- העבר את התיק הזה לאלכס.
האם זה משנה את הנתונים?
כן, זה משנה את הנתונים.
רשומת המקרה מתעדכנת ב-Dynamics 365. השינוי נכנס לתוקף מיד.
דרישות מוקדמות
כלי זה דורש את הדברים הבאים:
- תפקיד נציג שירות לקוחות.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | מקרה עדכון |
| שם הכלי הפנימי | update_case |
| מטרה | מעדכן שדה אחד או יותר בתיק תמיכה |
התנהגות כלי
מעדכן שדה אחד או יותר בתיק תמיכה. תומך בקיצורי דרך מוקלדים לשדות נפוצים כמו עדיפות, fields מפה לעמודות סקלריות של Dataverse כמו כותרת, תיאור וסיבת סטטוס, ומפת lookups לשדות יחסים כמו לקוח, בעלים, איש קשר ונושא. שמות שניתנו לשדות יחסים נפתרים לרשומה לפני שהעדכון מיושם, כך ששם שלא תואם כלום—או תואם למספר רשומות—מדווח במקום להיכתב.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
false |
כלי זה משנה נתונים. |
destructiveHint |
false |
העדכון אינו הרסני (השדות מוחלפים, לא נמחקים). |
idempotentHint |
true |
קריאה עם אותם קלטים מניבה את אותה תוצאה. |
openWorldHint |
לא הוגדר | משתמש בברירת מחדל (שואלת את Dataverse). |
מושגי קלט
מזהה מקרה
| קלט | תיאור | נדרש |
|---|---|---|
incidentId, caseNumber |
incidentId (GUID) או caseNumber (למשל, CAS-01010-A0A0A0). נדרש לפחות אחד. כאשר caseNumber זה מסופק, השרת פותר את זה ל-GUID. |
כן |
קיצור דרך עדיפות
| קלט | תיאור | נדרש |
|---|---|---|
priority, , high, normallow |
priority (אנום: high, normal, low). פרמטר נוחות לעדכון השדה הנפוץ ביותר. |
לא |
שדות שרירותיים
| קלט | תיאור | נדרש |
|---|---|---|
fields |
fields (רשומה של השם הלוגי לזוגות ערכים ב-Dataverse). עמודות סקלריות בלבד—כותרת, תיאור, סיבת סטטוס, סוג מקרה ועמודות מותאמות אישית. משמש על ידי ווידג'ט הטופס לעריכה פנימית, או לכל שדה סקלר שאינו מכוסה בקיצורי הדרך המוקלדים. חיפוש שנשלח כאן מנותב אוטומטית לנתיב הקשר. |
לא |
שדות יחסים
| קלט | תיאור | נדרש |
|---|---|---|
lookups |
lookups (רשומה של חיפוש שם-לוגי לשם רשומה או GUID). משמש לשדות יחסים כגון customerid, , וsubjectid—לדוגמה {"customerid": "Contoso Ltd"}primarycontactid. השרת פותר את השם לרשומה ומקשר אותה. זו הדרך הנתמכת לשנות חיפוש. |
לא |
תגובה והתנהגות ממשק משתמש
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
אישור טקסט
הכלי מחזיר אישור טקסט של השדות המעודכנים. לא מופיע רכיב אינטראקטיבי.
הערות ניתוב
שימוש update_case :
- כל שינוי שדה ברשומת מקרה (עדיפות, כותרת, תיאור, סיבת מצב, שדות מותאמים אישית).
- עריכות אינליין מווידג'ט צורת המקרה.
אל תשתמש update_case ב:
-
סגירה/פתרון מקרה — נתב ל-
close_case(באמצעות פעולה Dataverse CloseIncident). -
הקצאת תיק מחדש — נתיב ל-
reassign_case(מטפל בהערות העברת בעלות והעברה). -
עדכון ישות שאינה מקרה — נתיב ל-
update_entity_record.
כלים קשורים
| כלי | קשר |
|---|---|
get_case |
פותח את טופס התיק לבדיקה לפני העריכה |
close_case |
פותר וסוגר תיק (משתמש ב-CloseIncident, לא בעדכון שטח) |
reassign_case |
מקצה מקרה למשתמש, צוות או תור אחר |
list_cases |
רשימה של מקרים שכדאי למצוא את זה שצריך לעדכן |
summarize_case |
פותח את התיק עם סיכום בינה מלאכותית למיון לפני העריכה |
סיווג מוטציות נתונים
כתיבה / מוטציה.
מעדכן שדה אחד או יותר ברשומת המקרה ב-Dataverse. הפעולה היא אידמפוטנטית — קריאה עם אותם קלטים מניבה את אותה תוצאה.