הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
כלי זה זמין כברירת מחדל בשרתים הבאים של MCP: Dynamics 365 Customer Service.
הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת הזו כשאתה רוצה למצוא אנשי קשר, בדוק אותם בצ'אט, ופעל מבלי לעזוב את השיחה.
מה הוא עושה
העוזר מציג רשימת אנשי קשר שמתאימים למסננים שלך. ניתן לסנן לפי:
- האם הקשר מוקצה לך.
- סטטוס יצירת קשר (פעיל או לא פעיל).
- חברת אם.
- שם איש קשר.
התוצאות מופיעות ברשימת אנשי קשר אינטראקטיבית בתוך הצ'אט.
נסה הנחיות כמו
- תראה את אנשי הקשר שלי.
- רשום את אנשי הקשר הפעילים שלי.
- הצג אנשי קשר ב-Contoso.
- רשום אנשי קשר לא פעילים.
- הצג אנשי קשר שהוקצו לי.
- מצא את ג'ורדן רייס.
- רשום את כל אנשי הקשר.
- הצג אנשי קשר ב-Fabrikam.
מה שתראו בצ'אט
העוזר מציג רשימת אנשי קשר אינטראקטיבית כרכיב אפליקציה בצ'אט. הרשימה מציגה אנשי קשר תואמים עם פרטים מרכזיים כמו שם, אימייל, טלפון, חברה ותפקיד.
עצות שימושיות
- תגיד "אנשי הקשר שלי" או "הוקצה לי" כדי לראות רק את אנשי הקשר שבבעלותך.
- השתמש במילות סטטוס כמו פעיל או לא פעיל כדי לסנן תוצאות.
- השתמש בשם חברה כדי למצוא אנשי קשר בארגון מסוים, למשל "הצג אנשי קשר ב-Contoso."
- שלב פילטרים על ידי אמירה כמו "הצג את אנשי הקשר הפעילים שלי ב-Fabrikam."
- אם אתה רוצה סיכום טקסטואלי של איש קשר, תגיד במקום זאת "סיכום יצירת קשר עם ג'ורדן רייס".
עצה
לאחר הופעת רשימת אנשי הקשר, תוכל לשאול שאלות המשך לגבי כל איש קשר שמופיע. לדוגמה, "פתח את הקשר הראשון" או "לסכם את ג'ורדן רייס."
מה קורה הלאה?
לאחר שהרשימה מופיעה, תוכל להמשיך עם הנחיות כמו:
- פתח את המגע הראשון.
- סיכם את הקשר הזה.
- הראה את החשבון של איש הקשר הזה.
- עדכן את כתובת האימייל של איש הקשר הזה.
האם זה משנה את הנתונים?
לא, רישום אנשי קשר לא משנה נתונים.
רשימת אנשי הקשר היא לקריאה בלבד. פעולות המשך מהרשימה, כמו עדכון שדה, יכולות לשנות נתונים. העוזר מבקש אישור לפני שהוא מבצע שינויים.
מה אפשר לעשות מהרכיב של אפליקציה בצ'אט
מרשימת אנשי הקשר בצ'אט, אתה יכול:
- סרוק ובדוק מגעים תואמים ברשת שניתן למיין.
- בחר איש קשר כדי לראות פרטים נוספים.
- פתח את טופס יצירת הקשר המלא ב-Dynamics 365.
- עדכן שדות נתמכים בתוך הקו כאשר זמינים.
- המשך לעבוד עם איש הקשר בצ'אט באמצעות הנחיות המשך.
דרישות מוקדמות
כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. אין צורך בתצורה נוספת.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | רשימת אנשי קשר |
| שם הכלי הפנימי | list_contacts |
| מטרה | רשימה של אנשי קשר עם לקוחות שסננו לפי סטטוס, חברת אם, בעלים או חיפוש שם ומציגה אותם בחוויית אפליקציה אינטראקטיבית בסגנון רשת בצ'אט |
התנהגות כלי
רשימה של אנשי קשר עם לקוחות שסננו לפי סטטוס, חברת אם, חיפוש בעלים או שמות ומציגה אותם בחוויית אפליקציה אינטראקטיבית בסגנון רשת בצ'אט. הפרמטר search מבצע התאמת "contains-match" מול שם איש הקשר.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
true |
הכלי הזה לא משנה נתונים. |
destructiveHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
idempotentHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
openWorldHint |
לא הוגדר | משתמש בברירת מחדל (שואלת את Dataverse). |
מושגי קלט
חיפוש
| קלט | תיאור | נדרש |
|---|---|---|
| — | מחרוזת טקסט חופשי. מבצע התאמת מכילה מול שם איש הקשר. | לא |
חברה
| קלט | תיאור | נדרש |
|---|---|---|
| — | סינון לפי שם חברת האם (מכיל התאמה). השתמש כאשר המשתמש מגדיר חברה או ארגון. | לא |
סטטוס
| קלט | תיאור | נדרש |
|---|---|---|
active, inactive |
active או inactive. מסננים לפי קוד מצב איש הקשר. |
לא |
היקף הבעלות
| קלט | תיאור | נדרש |
|---|---|---|
assignedToMe |
assignedToMe (בוליאני). כאשר זה נכון, מעריך את התוצאות לאנשי קשר שבבעלות המשתמש הנוכחי. |
לא |
מגבלת תוצאות
| קלט | תיאור | נדרש |
|---|---|---|
top |
top (מספר שלם). מספר מקסימלי של מגעים לחזור. ברירת מחדל היא 10, מקסימום 200. |
לא |
מסננים נוספים
| קלט | תיאור | נדרש |
|---|---|---|
additionalFilter |
additionalFilter (מפת מפתח-ערך). תנאי מסנן OData שרירותיים התמזגו עם AND. |
לא |
תגובה והתנהגות ממשק משתמש
כלי זה מציג רשת קשרים אינטראקטיבית של אפליקציה בצ'אט.
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
רשת אינטראקטיבית (תצוגת רשימה)
הרשת מציגה שם איש קשר, אימייל, טלפון, חברה ותפקיד. המשתמשים יכולים לבחור שורה כדי להעמיק בפרטי יצירת הקשר או לנקוט בפעולות המשך דרך הצ'אט.
הערות ניתוב
שימוש list_contacts :
- אנשי הקשר שלי, אנשי הקשר שהוקצו לי, אנשי הקשר הפעילים שלי.
- סינון מבוסס סטטוס (פעיל, לא פעיל).
- סינון מבוסס חברה.
- חיפוש שם פרטי קשר.
אל תשתמש list_contacts כשההודעה אומרת במפורש:
-
איש קשר ספציפי לפי שם לתצוגת פרטים—נתיב ל-
get_contact. -
"סיכום" איש קשר (אדם)—נתיב ל-
summarize_contact. -
חיפוש טקסט חופשי בין סוגי ישויות מרובים—נתב ל-
search_entities. -
חפש קישור שדה — נתיב ל-
search_lookup_records.
כלים קשורים
| כלי | קשר |
|---|---|
get_contact |
פותח את טופס יצירת הקשר המלא עבור איש קשר נבחר |
summarize_contact |
יוצר סיכום קשרים מונע בינה מלאכותית |
list_accounts |
רשימת חשבונות; לעיתים קרובות משמש לצד גלישת אנשי קשר |
search_entities |
חיפוש טקסט חופשי בכל סוג ישות |
search_lookup_records |
מחפש רשומות לקישור שדה חיפוש |
list_entity_records |
רשת ישות גנרית לסוגי ישויות ללא כלי רשימות ייעודי |
סיווג מוטציות נתונים
נקודת כניסה לקריאה בלבד עם פוטנציאל מוטציה במורד הזרם.
הרישום עצמו לא משנה נתונים. פעולות מעקב מהרשת (עדכון, עריכת שדות) יכולות להפעיל פעולות כתיבה דרך כלים נפרדים.