חיפוש רשומות ישויות

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

הערה

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

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

מה הוא עושה

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

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

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

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

• חפש ברשומות ה-CRM שלנו את מספר הטלפון 555-0134.
• מצא את רשומת יצירת הקשר עם כתובת jordan@contoso.comהאימייל.
• חפש את Contoso בין אנשי קשר וחשבונות.
• איזה לקוח מחזיק בכתובת billing@fabrikam.comהאימייל?
• מצא רשומות התואמות לבעיה במדפסת.
• חפש רשומות על הפסקות רשת.

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

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

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

• ניתן לחפש מספר סוגי ישויות בו זמנית, לדוגמה "חפש אנשי קשר וחשבונות עבור Contoso." זו הבחירה הטובה ביותר כאשר מספר טלפון או כתובת אימייל יכולים להשתייך לאחד מהם.
• מספרי טלפון מותאמים בצורה גמישה כאשר חיפוש רלוונטיות מופעל בסביבה שלך — אפשר להקליד 5550134 גם אם התקליטים שומרים (555)-0134. בלי חיפוש רלוונטיות, הקלד את המספר כפי שהוא מאוחסן.
• לפרסום חשבונות לפי סטטוס או בעלים, השתמש ב"רשימת חשבונות" במקום. חיפוש טוב יותר כשאתה לא יודע איזה רשומה אתה רוצה.
• כדי לפתוח רשומה שכבר יש לך שם, כתוב במקום זאת "פתח את חשבון Contoso".
• לחיפושים ספציפיים למקרה, נאמר "חיפוש מקרים" לחוויה ממוקדת יותר.
• טקסט החיפוש מוגבל ל-500 תווים.
• העוזר אומר לך אם השתמש בחיפוש רלוונטיות או בהתאמת תת-מחרוזות.

עצה

לאחר שתוצאות החיפוש מופיעות, תוכל לשאול שאלות המשך כמו "פתח את התוצאה הראשונה" או "הצג פרטים עבור Contoso."

מה קורה הלאה?

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

• פתח את התוצאה הראשונה.
• הצג פרטים לאלבום הזה.
• סיכם את הסיפור הזה.
• חפש שוב עם מילות מפתח שונות.

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

לא, חיפוש לא משנה נתונים.

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

‏‫דרישות מוקדמות‬

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

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	חיפוש רשומות ישויות
שם הכלי הפנימי	search_entities
מטרה	מחפש רשומות Dataverse לפי מילת מפתח, מספר טלפון או כתובת אימייל באמצעות שיטת החיפוש הטובה ביותר הזמינה (חיפוש רלוונטיות כאשר מופעל, או גיבוי התאמת תת-מחרוזות OData)

התנהגות כלי

מחפש רשומות Dataverse לפי מילות מפתח, מספר טלפון או כתובת אימייל באמצעות שיטת החיפוש הטובה ביותר הזמינה (חיפוש רלוונטיות כאשר מופעל, או גיבוי OData substring-match). תומך בכל סוג ישות וכמה סוגים בשיחה אחת. עמודות טלפון ודואר אלקטרוני נשמרות בתוצאות עבור כל סוג ישות; כאשר השם הראשי של הרשומה הוא ערך כזה, השם עדיין יכול להיות מדווח כשם הרשומה. תוצאות יצירת קשר וחשבון מועשרות בפרטים מוקפדים שנקבעו דרך חיפוש שני, במאמץ מיטבי — כאשר החיפוש נכשל, תוצאת החיפוש חוזרת לא מועשרת ולא נכשלה. סוגי ישויות אחרים אינם מקבלים סט מאוזן ויכולים לשאת את השדות שנותרו על ידי ה-backend הנבחר. זהו כלי טקסט בלבד ללא ווידג'ט לאפליקציה בצ'אט.

ביאורים

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

מושגי קלט

היקף ישות (יחיד)

קלט	תיאור	נדרש
entityLogicalName	entityLogicalName (מחרוזת, אופציונלי). סוג ישות יחיד לחיפוש. מתעלמים ממנו אם entityLogicalNames נמסר.	לא

היקף ישות (מרובה)

קלט	תיאור	נדרש
entityLogicalNames	entityLogicalNames (מערך מחרוזות, אופציונלי). מספר סוגי ישויות לחיפוש בו-זמנית. יש עדיפות על entityLogicalNameפני .	לא

טקסט חיפוש

קלט	תיאור	נדרש
searchText	searchText (מחרוזת, נדרש, מקסימום 500 תווים). שאילתת חיפוש בשפה טבעית או מילות מפתח.	‏‏כן‬

מגבלת תוצאות

קלט	תיאור	נדרש
top	top (מספר שלם, אופציונלי). תוצאות מקסימליות לכל סוג ישות. ברירת המחדל היא להגדרת גודל הדף של הארגון.	לא

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

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

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

סוג תגובה

רשימת טקסט של רשומות תואמות

התשובה כוללת רשומות תואמות עם שמם הראשי, סוג הישות וציון הרלוונטיות. רמת החיפוש (רלוונטיות או OData מכילה) מסומנת.

הערות ניתוב

שימוש search_entities :

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

אל תשתמש search_entities כשההודעה אומרת במפורש:

• פתח או ערוך רשומה שאתה כבר יכול לקרוא לה — נתב ל get_contact או get_account.
• רשום רשומות לפי קריטריונים כמו סטטוס או בעלים — נתיב ל-או list_accountslist_contacts.
• מקרים של חיפוש — נתיב ל search_cases (אותו מנוע, מוקף לאירוע).
• חפש קישור שדה — נתיב ל- search_lookup_records.
• נרטיב ציר זמן שנוצר על ידי בינה מלאכותית — נתיב ל-או summarize_entity_timelineget_case_highlights.

כלים קשורים

כלי	קשר
search_cases	אותו מנוע חיפוש, מותאם לישויות מקרה
search_lookup_records	מחפש רשומות לקישור שדה חיפוש
list_accounts	רשימת חשבונות ייעודית עם מסננים
list_contacts	רשימת אנשי קשר ייעודית עם מסננים
list_entity_records	רשת ישות גנרית לרשומות גלישה
get_entity_record	פותח פרט רשומה יחיד מתוצאות החיפוש

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

לקריאה בלבד.

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