הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
רלוונטי ל: Dynamics 365 Customer Service
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת הזו כשאתה רוצה למצוא חשבונות לקוחות, לבדוק אותם בצ'אט, ולפעול מבלי לעזוב את השיחה.
מה הוא עושה
העוזר מציג רשימה של חשבונות שמתאימים למסננים שלך. ניתן לסנן לפי:
- בין אם החשבון מוקצה לך.
- סטטוס חשבון (פעיל או לא פעיל).
- העיר.
- שם חשבון.
- מספר טלפון בכל תחומי הטלפון הראשיים או הממצים.
התוצאות מופיעות ברשימת חשבונות אינטראקטיבית בתוך הצ'אט.
נסה הנחיות כמו
- תראה את החשבונות הפעילים שלי.
- רשום את החשבונות שלי.
- הצג חשבונות בסיאטל.
- רשום חשבונות לא פעילים.
- הצג חשבונות שהוקצו לי.
- מצא חשבון Contoso.
- מצא את החשבון עם מספר טלפון +1-555-0100.
- רשום את כל החשבונות.
- הצגת חשבונות תעשיית הטכנולוגיה.
מה שתראו בצ'אט
העוזר מציג רשימת חשבונות אינטראקטיבית כרכיב אפליקציה בצ'אט. הרשימה מציגה חשבונות תואמים עם פרטים מרכזיים כמו שם החשבון, תעשייה, עיר, טלפון ודואר אלקטרוני.
עצות שימושיות
- תגיד "החשבונות שלי" או "הוקצה לי" כדי לראות רק את החשבונות שבבעלותיך.
- השתמש במילות סטטוס כמו פעיל או לא פעיל כדי לסנן תוצאות.
- שלב מסננים על ידי אמירה כמו "הצג את החשבונות הפעילים שלי בסיאטל."
- השתמש בשם חברה או מספר טלפון כדי לחפש חשבון מסוים.
- חיפוש טלפונים משתמש כברירת מחדל בשלושת שדות הטלפון הנפוצים של החשבונות. בקש כיסוי מקיף שיכלול שדות מותאמים קריאים ונוספים בפורמט טלפון.
- אם אתה רוצה סיכום מלא של חברה, תגיד "תעדכן אותי על Contoso" במקום. זה משתמש בכלי אחר.
עצה
לאחר שרשימת החשבונות מופיעה, תוכל לשאול שאלות המשך על כל חשבון שמוצג. לדוגמה, "פתח את החשבון הראשון" או "לסכם את קונטוסו."
מה קורה הלאה?
לאחר שהרשימה מופיעה, תוכל להמשיך עם הנחיות כמו:
- פתח את החשבון הראשון.
- סיכם את הסיפור הזה.
- הצג אנשי קשר בחשבון הזה.
- עדכן את מספר הטלפון בחשבון הזה.
האם זה משנה את הנתונים?
לא, רישום חשבונות לא משנה נתונים.
רשימת החשבונות היא לקריאה בלבד. פעולות המשך מהרשימה, כמו עדכון שדה, יכולות לשנות נתונים. העוזר מבקש אישור לפני שהוא מבצע שינויים.
מה אפשר לעשות מהרכיב של אפליקציה בצ'אט
מרשימת החשבונות בצ'אט, אתה יכול:
- סרוק וסקור חשבונות תואמים ברשת שניתן למיין.
- בחר חשבון כדי לראות פרטים נוספים.
- פתח את טופס החשבון המלא ב-Dynamics 365.
- עדכן שדות נתמכים בתוך הקו כאשר זמינים.
- המשך לעבוד עם החשבון בצ'אט באמצעות הנחיות המשך.
דרישות מוקדמות
כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. אין צורך בתצורה נוספת.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | רשימת חשבונות |
| שם הכלי הפנימי | list_accounts |
| מטרה | מציג חשבונות לקוחות המסוננים לפי סטטוס, עיר, בעלים, שם או טלפון ומציג אותם בחוויית אפליקציה אינטראקטיבית בסגנון רשת בצ'אט |
התנהגות כלי
מפרט חשבונות לקוחות מסוננים לפי סטטוס, עיר, בעלים, שם או טלפון ומציג אותם בחוויית אפליקציה אינטראקטיבית בסגנון רשת בצ'אט. הפרמטר search מבצע התאמה של Contains-Match מול שם החשבון.
phone הפרמטר בודק telephone1, telephone2, ועם telephone3 כיסוי ראשי. כיסוי ממצה נותן עדיפות לאותם שדות נפוצים ומחפש עד 48 שדות קריאים בפורמט Dataverse Phone, כולל שדות מותאמים אישית. התאמת הטלפון בודקת תחילה את הערך השמור במדויק, ואז משתמשת בהשוואה לא רגישה לעיצוב עבור ערכי 7-15 ספרות זכאים. כאשר מגבלות מטא-דאטה או שדה, שליפת מועמדים, או מגבלת התוצאה המבוקשת משמיט התאמות, התגובה כוללת phoneLookupTruncated: true והנרטיב מזהיר כי ייתכן שקיימות התאמות נוספות. הקלט שיצא additionalFilter משימוש נדחה; השתמש במסננים מתועדים בדרגה ראשונה.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
true |
הכלי הזה לא משנה נתונים. |
destructiveHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
idempotentHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
openWorldHint |
לא הוגדר | משתמש בברירת מחדל (שואלת את Dataverse). |
מושגי קלט
חיפוש
| קלט | תיאור | נדרש |
|---|---|---|
| — | מחרוזת טקסט חופשי. מבצע התאמת הכילה מול שם החשבון. | לא |
עיר
| קלט | תיאור | נדרש |
|---|---|---|
address1_city |
סינון על ידי address1_city (מכיל התאמה). השתמש כאשר המשתמש מגדיר מיקום גאוגרפי. |
לא |
טלפון
| קלט | תיאור | נדרש |
|---|---|---|
phone |
מספר טלפון להתאמה מול telephone1, telephone2, ו telephone3- . התאמות כפולות חוזרות לצורך הבהרה. |
לא |
כיסוי חיפוש
| קלט | תיאור | נדרש |
|---|---|---|
searchCoverage |
primary (ברירת מחדל) מחפש בשלושת שדות הטלפון הנפוצים לחשבון.
exhaustive מחפש עד 48 שדות קריאים בפורמט Dataverse Phone ודיווחים על קיצורים כאשר קיימים עוד. |
לא |
סטטוס
| קלט | תיאור | נדרש |
|---|---|---|
active, inactive |
active או inactive. מסננים לפי קוד מצב החשבון. |
לא |
היקף הבעלות
| קלט | תיאור | נדרש |
|---|---|---|
assignedToMe |
assignedToMe (בוליאני). כאשר זה נכון, הוא מעריך את התוצאות לחשבונות בבעלות המשתמש הנוכחי. |
לא |
מגבלת תוצאות
| קלט | תיאור | נדרש |
|---|---|---|
top |
top (מספר שלם). מספר החשבונות המקסימלי להחזרה. ברירת מחדל היא 10, מקסימום 200. |
לא |
תגובה והתנהגות ממשק משתמש
כלי זה מציג רשת חשבונות אינטראקטיבית של אפליקציה בצ'אט.
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
רשת אינטראקטיבית (תצוגת רשימה)
הרשת מציגה שם חשבון, תעשייה, עיר, טלפון ואימייל. המשתמשים יכולים לבחור שורה כדי להעמיק בפרטים או לנקוט בפעולות המשך בצ'אט.
הערות ניתוב
שימוש list_accounts :
- החשבונות שלי, חשבונות שהוקצו לי, החשבונות הפעילים שלי.
- סינון מבוסס סטטוס (פעיל, לא פעיל).
- סינון מבוסס עירוניות.
- חיפוש שם חשבון.
- חיפוש מספרי טלפון.
אל תשתמש list_accounts כשההודעה אומרת במפורש:
-
חשבון ספציפי לפי שם לתצוגת פירוט—נתיב ל-
get_account. -
"תדריך אותי על" או "תסכם" חברה — נתיב ל-
summarize_account. -
חיפוש טקסט חופשי בין סוגי ישויות מרובים—נתב ל-
search_entities. -
חפש קישור שדה — נתיב ל-
search_lookup_records.
כלים קשורים
| כלי | קשר |
|---|---|
get_account |
פותח את טופס החשבון המלא עבור חשבון נבחר |
summarize_account |
יוצר סיכום חשבון מבוסס בינה מלאכותית |
list_contacts |
רשימה של אנשי קשר, שמשמשים לעיתים קרובות לצד גלישה בחשבון |
search_entities |
חיפוש טקסט חופשי בכל סוג ישות |
search_lookup_records |
מחפש רשומות לקישור שדה חיפוש |
list_entity_records |
רשת ישות גנרית לסוגי ישויות ללא כלי רשימות ייעודי |
סיווג מוטציות נתונים
נקודת כניסה לקריאה בלבד עם פוטנציאל מוטציה במורד הזרם.
הרישום עצמו לא משנה נתונים. פעולות מעקב מהרשת (עדכון, עריכת שדות) יכולות להפעיל פעולות כתיבה דרך כלים נפרדים.