עדכון רשומת הישות

חל על: Dynamics 365 Customer Service ו-Dynamics 365 Sales

הערה

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

השתמש ביכולת הזו כשאתה רוצה לשנות ערך שדה בכל רשומת Dataverse ישירות מהצ'אט.

מה הוא עושה

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

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

נסה הנחיות כמו

• עדכן את מספר הטלפון בחשבון Contoso.
• שנה את תואר התפקיד של ג'ורדן למהנדס בכיר.
• קבע את ההכנסות המשוערות מההזדמנות הזו ל-50000.
• עדכן את כתובת האימייל של איש הקשר הזה.
• שנה את הסטטוס של הליד הזה ל-Qualified (מוסמך).
• הגדר את שדה התיאור ברשומה הזו.

מה שתראו בצ'אט

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

עצות שימושיות

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

עצה

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

מה קורה הלאה?

לאחר שהעדכון יוחל, תוכל להמשיך עם הנחיות כמו:

• תראה את התקליט הזה שוב.
• עדכן שדה נוסף.
• רשימת רשומות עבור סוג ישות זה.
• פתח את הרשומה הזו ב-Dynamics 365.

האם זה משנה את הנתונים?

כן, זה מעדכן את נתוני רשומת Dataverse.

העוזר מיישם את השינויים בשדות ישירות על רשומת Dataverse. העוזר מבקש אישור לפני שהוא מבצע שינויים.

מה אפשר לעשות מהרכיב של אפליקציה בצ'אט

מטופס הרשומה המעודכן בצ'אט, אתם יכולים:

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

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

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

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	עדכון רשומת הישות
שם הכלי הפנימי	update_entity_record
מטרה	מעדכן שדה אחד או יותר בכל רשומת ישות של Dataverse לפי GUID

התנהגות כלי

מעדכן שדה אחד או יותר בכל רשומת ישות Dataverse לפי GUID. השתמש כאשר כלי עדכון ייעודיים לתחום (כגון update_case) אינם מכסים את השדה או הישות המבוקשת, או כאשר לישות אין כלי עדכון ייעודי. עובד עבור חשבונות, אנשי קשר, הזדמנויות, לידים, טבלאות מותאמות אישית וכל ישות אחרת של Dataverse.

ביאורים

ביאור	ערך:	משמעות
readOnlyHint	false	כלי זה משנה נתונים.
destructiveHint	false	כלי זה מעדכן נתונים ללא התנהגות מחיקה קשה.
idempotentHint	true	שיחות חוזרות עם אותו קלט משאירות את אותו אפקט סופי.
openWorldHint	לא הוגדר	משתמש בברירת מחדל (שואלת את Dataverse).

מושגי קלט

סוג ישות

קלט	תיאור	נדרש
entityLogicalName	entityLogicalName (מיתר נדרש). השם הלוגי של ישות Dataverse (לדוגמה, account, contact, opportunity).	‏‏כן‬

מזהה רשומה

קלט	תיאור	נדרש
recordId	recordId (מיתר נדרש). ה-GUID של הרשומה לעדכון.	‏‏כן‬

עדכוני שטח

קלט	תיאור	נדרש
fields	fields (מפת ערך מפתח, נדרש). מפה של שמות לוגיים של שדות לערכים חדשים. דוגמה: { "telephone1": "555-0100", "jobtitle": "Senior Engineer" }.	‏‏כן‬

תגובה והתנהגות ממשק משתמש

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

כלי MCP זה נתמך על ידי אפליקציית MCP.

סוג תגובה

צורה אינטראקטיבית (תצוגת פרטים)

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

הערות ניתוב

שימוש update_entity_record :

• עדכון שדות בכל סוג ישות ללא כלי עדכון ייעודי.
• עדכון שדות שאינם מכוסים על ידי כלי עדכון ייעודיים לתחום.

אל תשתמש update_entity_record ב:

• עדכון שדות מקרה—עדיף update_case בשדות ספציפיים למקרה.
• מחיקת רשומה — נתיב ל- delete_entity_record.

כלים קשורים

כלי	קשר
get_entity_record	צפה ברשומה לפני או אחרי עדכון
get_account	צפה ברשומת חשבון לפני או אחרי עדכון
get_contact	צפה ברשומת יצירת קשר לפני או אחרי עדכון
delete_entity_record	מוחק רשומה במקום לעדכן אותה
update_case	כלי ייעודי לעדכון מקרה עם לוגיקה ספציפית למקרה

סיווג מוטציות נתונים

פעולת כתיבה (לא הרסנית, אידמפוטנטית).

כלי זה משנה נתונים. העדכונים מוחלים ישירות על רשומת Dataverse. הפעולה היא אידמפוטנטית; קריאות חוזרות עם אותו קלט מניבות את אותה תוצאה.