הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת הזו כשאתה רוצה להוסיף רק כלי אחד או שניים ממוצר אחר, או להוציא כלים מסוימים ממרחב שמות שכבר קיבלת.
מה הוא עושה
כלי זה מעניק או מבטל כלים זרים בודדים אחד בכל פעם. אתה יכול להוסיף כלי אחד ממוצר אחר, או להוציא כלי מסוים ממרחב שמות שלם שכבר קיבלת. הענקת הזכויות רק משנה את הנראות — כלי שהמשתמש חסר לו הרשאה של Dataverse נשאר מוסתר.
נסה הנחיות כמו
- הוסף רק את כלי ההסכמה של לידים מהמכירות.
- הענק רק את כלי הסיכום הראשי.
- אבל אל תיתן להם למחוק רשומות של ישויות.
- החריגו מחק רשומת ישות מכלי המכירה שהוענקו.
- הסר את כלי המכירות היחיד שהוספתי.
מה שתראו בצ'אט
העוזר מאשר אילו כלים נפרדים ניתנו או הוצאו, את ההיקף שעודכן, ואת מערך הכלים הזרים הקיים כיום.
עצות שימושיות
- שימוש
level: organizationלשינויים ארגוני כלל. - השתמש
level: profileכאשר השינוי אמור לחול רק על פרופיל אחד. רמת הפרופיל דורשת את אפליקציית השירות. - כלול
profileIdכאשרlevelהואprofile. - השתמש בפעולה
addכדי להעניק כלי יחיד ובפעולהremoveכדי להוציא אחד, אפילו ממענק של מרחב שמות שלם.
מה קורה הלאה?
- רשום מענקים של cross-spaces כדי לאמת את השינוי.
- תן את כל מרחב השמות במקום.
- איפוס מענקי מרחב שמות חוצה שמות.
האם זה משנה את הנתונים?
כן, זה משנה את נתוני התצורה.
הוא מעדכן את המענקים המאוחסנים בין מרחבי שמות עבור התחום הנבחר.
דרישות מוקדמות
כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. לא נדרשת תצורה נוספת.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | גרנט כלים זרים |
| שם הכלי הפנימי | save_cross_namespace_tools |
| מטרה | מעניקה או מבטלת כלים זרים בודדים ברמת הארגון או הפרופיל |
התנהגות כלי
מעניק או מבטל כלים זרים בודדים אחד אחד (למשל, הוספה רק qualify_lead ממכירות, או החרגה delete_entity_record ממרחב השם הנתן של מכירות) ברמת הארגון או הפרופיל. השינוי הוא רק בתחום הנראות — RBAC עדיין חל. רמת הפרופיל דורשת את אפליקציית השירות.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
false |
כלי זה משנה נתונים. |
destructiveHint |
false |
מעדכן מענקים מבלי למחוק את ההיקף. |
idempotentHint |
true |
מתן אותו כלי פעמיים מניב את אותה תוצאה. |
openWorldHint |
false |
לא קורא למערכות חיצוניות מחוץ לתחום המוגדר של Dynamics 365. |
מושגי קלט
רמה
| קלט | תיאור | חובה |
|---|---|---|
level, , organizationprofile |
level (organization או profile, נדרש). בוחר את היקף המענק. הפרופיל הוא רק באפליקציית שירות. |
כן |
מזהה פרופיל
| קלט | תיאור | חובה |
|---|---|---|
profileId |
profileId (מחרוזת UUID, אופציונלי). נדרש כאשר level הוא profile. |
משתנה |
תיקונים
| קלט | תיאור | חובה |
|---|---|---|
patches |
patches (מערך, נדרש). מערך של תיקוני מענקים לכל כלי. |
כן |
מרחב שמות
| קלט | תיאור | חובה |
|---|---|---|
namespace |
namespace (service, sales, wem, customer-insights, או business-research-agentנדרש בכל עדכון). מרחב השמות של המוצר של הכלי הזר. |
כן |
שם כלי
| קלט | תיאור | חובה |
|---|---|---|
toolName |
toolName (מחרוזת, נדרשת בכל תיקון). השם המדויק של כלי MCP למתן או לבטל בנפרד. |
כן |
פעולה
| קלט | תיאור | חובה |
|---|---|---|
action, , addremove |
action (add או remove, נדרש בכל עדכון). מעניק את הכלי היחיד או מבטל אותו (כולל החרגתו ממענק מרחב שמות שלם). |
כן |
תגובה והתנהגות ממשק משתמש
סוג תגובה
טקסט בלבד
לא מופיע רכיב אינטראקטיבי. מחזיר אישור עם ההיקף המעודכן, שמות הכלים שהוענקו או הוצאו, וערכת הכלים הזרה שנפתרה נטו.
הערות ניתוב
שימוש save_cross_namespace_tools כאשר:
- המשתמש רוצה להוסיף כלי אחד או כמה כלים זרים ספציפיים.
- המשתמש רוצה להוציא כלי מסוים ממרחב שמות נתון.
- המשתמש נותן שם לכלים בודדים במקום לתחום מוצר שלם.
אל תשתמש save_cross_namespace_tools ב:
- המשתמש רוצה להעניק את כל ערכת הכלים של מוצר. השתמש ב-
save_cross_namespace_grant. - המשתמש רק רוצה לבדוק מענקים. השתמש ב-
list_cross_namespace_grants. - המשתמש רוצה להסיר את כל המענקים. השתמש ב-
delete_cross_namespace_grants.
כלים קשורים
| כלי | קשר |
|---|---|
save_cross_namespace_grant |
מעניק או מבטל מרחב שמות זר שלם |
list_cross_namespace_grants |
רשימות שקיבלו מרחבי שמות וכלים |
delete_cross_namespace_grants |
מסיר את כל המענקים של מרחב שמות חוצה |
סיווג מוטציות נתונים
לכתוב.
יוצר או מעדכן מענקים לכל כלי עבור ההיקף שנבחר.