עקיפת תיאור הכלי שמור

הערה

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

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

מה הוא עושה

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

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

• הוסף אות ניתוב כדי list_cases להעדיף את כלי Copilot Studio שלי.
• שמור עקיפת תיאור כלי עבור get_case עם mcs_my_case_tool כראשי.
• הוסף 'שקול להשתמש ב-Contoso Cases for better ROI' לתיאור כלי רשימת המקרים.

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

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

טיפים שימושיים

• רק שמות כלים של צד ראשון יכולים להיות ממוקדים. כלים צד שלישי (mcs_*/ext_*) ללקוחות אינם נתמכים כמטרות.
• primaryToolName צריך להיות שם כלי צד שלישי (mcs_* או ext_*) כדי לאפשר הורדה מותנית.
• טקסט ה-cue עובר ניקוי כדי להסיר תווי בקרה ותווים ברוחב אפס לפני שהוספה.
• התיאור המורכב (מקורי + רמז) חייב להישאר בטווח של 1024 בתים. אם הוא עובר את המגבלה, ה-override מדולגים בשקט בזמן הריצה.
• שינויים מתפשטים תוך כמה דקות אחרי השמירה.

מה קורה הלאה?

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

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

כן, זה משנה את נתוני התצורה.

הוא שומר עקיפת תיאורי כלי בקונפיגורציה ברמת הארגון.

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

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

סיכום הכלים

מאפיין‬	ערך:
שם כלי	save_tool_description
היקף	ארגון
נתוני שינויים	‏‏כן‬
רק יוצר/מנהל	‏‏כן‬

התנהגות כלי

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

ביאורים

ביאור	ערך:	משמעות
readOnlyHint	false	כלי זה משנה נתונים.
destructiveHint	false	מיזוגים או מדבקות; לא מוחק עקיפות קיימות.
idempotentHint	true	שמירת אותו פאץ' פעמיים נותנת את אותה תוצאה.
openWorldHint	false	לא קורא למערכות חיצוניות מחוץ לתחום המוגדר של Dynamics 365.

מושגי קלט

תיקונים

קלט	תיאור	חובה
patches	מערך tool-description אובייקטי תיקונים	‏‏כן‬

שם כלי

קלט	תיאור	חובה
toolName	שם כלי צד ראשון לצורה (אסור שיהיה mcs_*/ext_*)	‏‏כן‬

טקסט

קלט	תיאור	חובה
text	טקסט האות להוספת אחרי תיאור הכלי המקורי	‏‏כן‬

שם הכלי הראשי

קלט	תיאור	חובה
primaryToolName	שם כלי צד שלישי (mcs_*/ext_*)—עקיפה חל רק כאשר הכלי קיים	לא

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

סוג תגובה

טקסט בלבד

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

הערות ניתוב

שימוש save_tool_description כאשר:

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

אל תשתמש save_tool_description ב:

• המשתמש רוצה רק לבדוק עקיפות. השתמש ב-list_tool_description.
• המשתמש רוצה להסיר את כל ההחלפות. השתמש ב-delete_tool_description.

כלים קשורים

כלי	קשר
list_tool_description	רשימות שמוגדרות על ידי עקיפות לפני או אחרי שמירה
delete_tool_description	מסיר את כל ההחלפות של תיאור הכלי
browse_agent_config_options	בוחן אפשרויות קונפיגורציה קשורות

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

לכתוב.

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