התחלה עם קונפיגורציית סוכן

הערה

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

השתמש ביכולת הזו כשאתה רוצה לבדוק מה ניתן להגדיר בסוכן ולהבין את אפשרויות ההתאמה הזמינות לרשתות, טפסים, צירי זמן, רשימות בחירה, אסטרטגיות פתרון, נראות כלים, שרתי כלים חיצוניים של MCP, סוכני Copilot Studio, מענקי כלים חוצי מרחבי שמות, וכאשר ניהול אוצר המילים של השירות מופעל וכלי אוצר המילים זמין לסוכן – אוצר המילים של השירות (מונחים מילונים ומילים נרדפות).

מה הוא עושה

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

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

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

• מה אני יכול להגדיר את זה?
• עזור לי לסדר את הסוכן.
• מתחילים עם ההגדרות.
• איך אני מתאים אישית את רשת המארז?
• תראה לי אפשרויות קונפיגורציה של ציר זמן.
• אילו הגדרות צורה זמינות?
• חפש אפשרויות קונפיגורציה ל-picklist.
• עיין בתצורת הסוכן עבור ישות האירוע.
• תראה לי נראות כלים.
• נהל רישומים חיצוניים של MCP.
• נהל רישום סוכנים ב-Copilot Studio.
• אילו כלים נוספים של סוכנים אוכל להוסיף?
• נהל את אוצר המילים של השירות. (זמין כאשר כלי אוצר המילים של השירות הוא חלק מערכת הכלים של הסוכן.)

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

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

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

• תתחיל בלי נתיב ספציפי לראות את תפריט השורש של כל קטגוריות הקונפיגורציה.
• תגיד "חפש [מילת מפתח]" כדי למצוא אפשרויות קונפיגורציה בכל הקטגוריות בלי לנווט ידנית.
• שאל "הצג דוגמאות" בכל רמה כדי לראות תצוגות מקדימות לפני ואחרי איך נראה שינוי תצורה.
• ציין ישות (כגון "אירוע" או "חשבון") כדי לסנן אפשרויות להגדרות הרלוונטיות לסוג הישות הזה.
• בחר בין תחום "ארגון" (ארגוני כלל) לבין תחום "פרופיל" (פרופיל יישום) כדי למקד את שכבת הקונפיגורציה הנכונה.

עצה

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

מה קורה הלאה?

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

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

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

לא, גלישה באפשרויות ההגדרה לא משנה נתונים.

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

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

כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. אין צורך בתצורה נוספת.

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	התחלה עם קונפיגורציית סוכן
שם הכלי הפנימי	browse_agent_config_options
מטרה	מדריך יצרן דרך אפשרויות קונפיגורציה של סוכנים דרך עץ ניווט אינטראקטיבי רב-פניות

התנהגות כלי

מדריך יצרן דרך אפשרויות קונפיגורציית סוכנים דרך עץ ניווט אינטראקטיבי, מרובה סיבובים. מכסה רשתות, טפסים, צירי זמן, רשימות בחירה, חיפושים ואסטרטגיות פתרון, בנוסף למשטחי ההרחבה של הסוכן—נראות כלים, שרתי כלים חיצוניים של MCP, סוכני Copilot Studio, ומענקי כלים חוצי-מרחבי שמות. כאשר ניהול אוצר המילים של השירות מופעל וכלי אוצר המילים זמין לסוכן — בדרך כלל סוכני שירות לקוחות, או כל סוכן שקיבל את ערכת השירות דרך מענק חוצה שמות — הוא גם מכסה את אוצר המילים של השירות (מונחים במילון מונחים ומילים נרדפות); הערך הזה מושמט כאשר הכלי אינו זמין לסוכן או שהיכולת כבויה. מחזיר תפריטים היררכיים שהמשתמש יכול להיכנס אליהם, עם דוגמאות לפני/אחרי בכל רמה. נקודת הכניסה הראשית לגילוי קונפיגורציה.

ביאורים

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

מושגי קלט

נתיב הניווט

קלט	תיאור	נדרש
path	path (מחרוזת, אופציונלי). נתיב מוגבל בנקודות כדי לקפוץ לכל רמה בעץ הקונפיגורציה (לדוגמה, grid.incident, form, timeline.incident, tool-selectioncross-namespace-grantmcp-registrationcopilot-studio, ו—כאשר כלי אוצר המילים של השירות זמין לסוכן —).service-vocabulary הנתיב service-vocabulary נפתר רק כאשר היכולת הזו זמינה לסוכן הנוכחי; אחרת הוא מחזיר תוצאה של "קטגוריה לא ידועה". השמיט או העביר ריק לתפריט השורש.	לא

דוגמאות למתג

קלט	תיאור	נדרש
showExamples	showExamples (בוליאני, אופציונלי). כאשר זה נכון, מחזיר דוגמאות לפני/אחרי ברמת העץ הנוכחית.	לא

מסנן ישות

קלט	תיאור	נדרש
entity	entity (מחרוזת, אופציונלי). מסנן את העץ לשם לוגי של ישות ספציפית (לדוגמה, incident, account).	לא

שכבת הקונפיגורציה

קלט	תיאור	נדרש
scope	scope (enum: org | profile, אופציונלי). מכוון לשכבה מסוימת. השמט בשיחה הראשונה כדי שהכלי יראה לבחירה.	לא

מזהה פרופיל

קלט	תיאור	נדרש
profileId	profileId (מחרוזת UUID, אופציונלי). נדרש כאשר היקף הוא profile. הכלי מפרט GUIDs זמינים לפרופילים אם לא הושמטו.	משתנה

חיפוש

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

כלול שכבות

קלט	תיאור	נדרש
includeLayers	includeLayers (בוליאני, אופציונלי). כאשר זה נכון, החיפוש מתחשב גם בתת-העץ החינוכי layers.* . ברירת המחדל היא False.	לא

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

סוג תגובה

טקסט בלבד

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

הערות ניתוב

שימוש browse_agent_config_options כאשר:

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

אל תשתמש browse_agent_config_options ב:

• המשתמש כבר יודע מה הוא רוצה לשמור ומספק פרטים ספציפיים. נתב ישירות עם save_agent_config הטווח המתאים.
• המשתמש מבקש לרשום תצורות קיימות. השתמש list_agent_configs עם הטווח המתאים.
• המשתמש שואל על ההעדפות האישיות שלו. השתמש ב-list_user_prefs.

כלים קשורים

כלי	קשר
save_agent_config	שומר תצורות ברמת ארגון או פרופיל לאחר גילוי
get_agent_config_capabilities	בדיקת הרשאות מהירה לפני ההגדרה
list_agent_configs	מפרט מה כבר מוגדר ברמת הארגון או הפרופיל

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

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

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