הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
כלי זה זמין כברירת מחדל בשרתים הבאים של MCP: Dynamics 365 Customer Service.
הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
יכולת זו פועלת מאחורי הקלעים כאשר מוסיפים או עורכים רישום שרת MCP חיצוני מתוך ווידג'ט ניהול הרישום.
מה הוא עושה
כאשר אתה ממלא את טופס ההרשמה בווידג'ט ניהול שרת MCP ובוחר 'שמירה', כלי זה משאיר את ההרשמה לסביבת Dynamics 365 שלך. הוא מטפל הן ביצירת רישומים חדשים והן בעדכון רשמים קיימים.
הכלי מאמת את כתובת ה-URL של נקודת הקצה לאבטחה, בודק שהיקף האימות מותר, אוכף את תקרת ההרשמה (20 לכל סביבה), ומונע נקודות קצה או קידומות כלילות כפולות. בהצלחה, הוא שומר את ההרשמה ומרענן את רשימת הכלים של סוכן השירות כך שכלי השרת החדש יהיו זמינים.
נסה הנחיות כמו
לא ישים. כלי זה נקרא אוטומטית כאשר שומרים רישום מהווידג'ט של הניהול. הוא לא מופעל על ידי הקלדת הנחיה.
מה שתראו בצ'אט
ווידג'ט ההרשמה מתעדכן כדי לאשר שהשמירה הצליחה, ומציג את מזהה הרישום והאם נוצר או עודכן. אם האימות נכשל (למשל, נקודת קצה כפולה או קידומת כלי שמור), הווידג'ט מציג הודעת שגיאה שמסבירה מה לתקן.
עצות שימושיות
- עליך להריץ Test Connection לפני שמירת הרשמה חדשה. תמונת הכלי מהמבחן היא מה שנשאר.
- כל נקודת קצה שרת יכולה להירשם רק פעם אחת. הסר קודם את הרישום הקיים אם אתה צריך לרשום מחדש את אותו URL.
- קידומות לכלי חייבות להיות ייחודיות בכל הרשמה בסביבה שלך.
- שמירת רישום מבטלת את מטמון הכלי, ולכן הכלים המעודכנים נכנסים לתוקף בשיחה הבאה.
מה קורה הלאה?
לאחר השמירה, ווידג'ט ההרשמה חוזר לתצוגת הרשימה. באפשרותך:
- בדוק את החיבור שוב.
- ערוך את הרישום ששמרתי.
- הוסף שרת MCP נוסף.
האם זה משנה את הנתונים?
כן, זה משנה את הנתונים.
שמירת רישום יוצרת או מעדכנת רשומת קונפיגורציה בסביבת Dynamics 365 שלך ומרעננת את רשימת הכלים הזמינה של סוכן השירות.
דרישות מוקדמות
כלי זה דורש את הדברים הבאים:
- תפקיד מנהל מערכת או מנהל שירות Copilot.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | שמור רישום MCP חיצוני |
| שם הכלי הפנימי | save_mcp_registration |
| מטרה | ממשיך רישום שרת MCP חיצוני חדש או מעודכן |
התנהגות כלי
שומר על רישום שרת MCP חיצוני חדש או מעודכן. זהו כלי תמיכה בווידג'טים שמופעל אוטומטית כאשר משתמשים מתקשרים עם ווידג'ט רישומי ההרחבה. הוא אינו מיועד להפעלה ישירה על ידי המודל.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
false |
כלי זה יוצר או מעדכן נתוני רישום. |
destructiveHint |
false |
העדכונים אינם הרסניים (תבנית upsert). |
idempotentHint |
true |
קריאות חוזרות עם אותו קלט מניבות את אותה תוצאה. |
openWorldHint |
לא הוגדר | משתמש כברירת מחדל. |
מושגי קלט
אובייקט רישום
| קלט | תיאור | נדרש |
|---|---|---|
displayName, name, endpoint, , authScopemodetoolPrefix, ,tools |
מכיל את פרטי רישום השרת כולל displayName, name (מזהה ייחודי), endpoint (כתובת HTTPS), authScope (טווח יעד של Entra OBO), mode, toolPrefixומערך tools . |
לא |
מזהה רישום
| קלט | תיאור | נדרש |
|---|---|---|
id |
id (אופציונלי). כאשר ניתן, מעדכן רישום קיים; כאשר מושמטים, נוצר אחד חדש. |
לא |
כתובת הארגון
| קלט | תיאור | נדרש |
|---|---|---|
orgUrl |
orgUrl (אופציונלי). מחליף את כתובת ה-URL הסביבתית שנבחרה כרגע. |
לא |
תגובה והתנהגות ממשק משתמש
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
עדכון ווידג'טים
הווידג'ט מתעדכן ומציג את הרישום ששמר.
הערות ניתוב
הכלי הזה נקרא בלעדית על ידי הווידג'ט manage_mcp_registration . אל תפעיל את זה ישירות.
כלים קשורים
| כלי | קשר |
|---|---|
manage_mcp_registration |
כלי המשגר שפותח את ווידג'ט ההרשמה |
delete_mcp_registration |
הסרת רישום |
test_mcp_registration_connection |
בודק קישוריות לפני שמירה |
סיווג מוטציות נתונים
כתוב (העלות). יוצר או מעדכן רישום שרת MCP חיצוני במאגר ההרשמה המוגדר לפי ארגון.