הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת זו כאשר ברצונך לרשום, לערוך או להסיר נקודות קצה של שרת MCP של צד שלישי שסוכן השירות יכול להפעיל עבורך.
מה הוא עושה
העוזר פותח ממשק ניהול שבו תוכל לנהל רישומים חיצוניים של שרת כלי MCP בסביבת Dynamics 365 שלך. שרתי כלים MCP (Model Context Protocol) הם נקודות קצה HTTPS שמציגות כלים נוספים שסוכן השירות יכול לקרוא להם במהלך שיחה.
מווידג'ט ההרשמה אפשר להוסיף נקודות קצה חדשות לשרת, לערוך קיימות, לבדוק חיבוריות ולהסיר רישומים שכבר לא צריך. כל רישום כולל שם תצוגה, כתובת URL של נקודת קצה, היקף אימות, קידומת כלי ותמונת מצב של הכלים שהשרת מציג.
נסה הנחיות כמו
- לנהל את שרתי ה-MCP שלי.
- רשם שרת כלים חיצוני.
- הראה את רישומי השרת שלי ב-MCP.
- הוסף נקודת קצה של כלי צד שלישי.
- פתח את מנהל שרת MCP.
- אני רוצה לרשום נקודת קצה של כלי.
מה שתראו בצ'אט
העוזר מציג ווידג'ט לניהול הרשמה אינטראקטיבי כרכיב אפליקציה בצ'אט. אם כבר יש לך הרשמות, הווידג'ט מציג אותן ברשימה עם פרטים מרכזיים כמו שם תצוגה, כתובת URL של נקודת קצה, קידומת כלי ומספר כלים.
טיפים שימושיים
- אתה צריך את ההרשאה Service Agent Maker Customize כדי לנהל רישומים.
- כל רישום דורש קידומת כלי ייחודית (3-20 תווים אלפאנומריים קטנים או מקפים) שמסמנת את כלי השרת.
- תמיד השתמש בכפתור Test Connection לפני שמירת רישום חדש כדי לוודא שנקודת הקצה ניתנת להשגה.
- הסביבה שלך תומכת עד 20 הרשמות שרתי MCP חיצוניים.
- קידומות התואמות למרחבי שמות כלים של צד ראשון (כגון "case", "email" או "mcp") נשמרות ואינן ניתנות לשימוש.
עצה
לאחר רישום שרת, הכלים שלו זמינים לסוכן השירות בשיחות עתידיות. אתה יכול לאמת על ידי בקשה מהסוכן להשתמש בכלי מהשרת הזה.
מה קורה הלאה?
לאחר הופעת ווידג'ט ההרשמה, אתם יכולים:
- הוסף שרת MCP חדש.
- בדוק את חיבור השרת שלי.
- הסר את שרת Contoso.
- תראה אילו כלים השרת שלי מספק.
האם זה משנה את הנתונים?
שלב זה הוא לקריאה בלבד, אך פעולות מעקב ממנו עשויות לשנות את הנתונים.
פתיחת ווידג'ט ההרשמה לא משנה את הנתונים. הוספה, עריכה או הסרה של רישומים מתוך הווידג'ט אכן משנה את תצורת הסביבה שלך.
מה אפשר לעשות מהרכיב של אפליקציה בצ'אט
מווידג'ט ההרשמה בצ'אט, אתה יכול:
- צפה בכל שרתי כלי MCP חיצוניים הרשומים לסביבתך.
- הוסף רישום שרת חדש על ידי מתן כתובת ה-URL של נקודת הקצה, היקף האימות וקידומת הכלי.
- ערוך את שם התצוגה, נקודת הקצה או היקף האימות של רישום קיים.
- בדוק את הקישוריות לשרת רשום כדי לוודא שהוא נגיש ומחזיר כלים תקפים.
- הסר רישום שאתה כבר לא צריך.
- בדוק את רשימת הכלים שכל שרת מציג.
דרישות מוקדמות
כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. אין צורך בתצורה נוספת.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | ניהול שרתי כלים חיצוניים של MCP |
| שם הכלי הפנימי | manage_mcp_registration |
| מטרה | פותח את ממשק המנהל לניהול הרשמות שרתי MCP בכלי צד שלישי |
התנהגות כלי
פותח את ממשק המנהל לניהול רישום שרתי MCP בכלי צד שלישי. מנהלים יכולים לצפות, להוסיף, לערוך ולהסיר רישומי נקודת קצה של שרת HTTPS שמרחיבים את יכולות סוכן השירות באמצעות כלים חיצוניים. כלי זה מכסה רק רישום נקודות קצה ב-HTTPS; הקצאת סוכני Copilot Studio מנוהלת בנפרד.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
true |
הכלי הזה לא משנה נתונים ישירות. |
destructiveHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
idempotentHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
openWorldHint |
לא הוגדר | משתמש בברירת מחדל (שואלת את Dataverse). |
מושגי קלט
פעולה
| קלט | תיאור | חובה |
|---|---|---|
open, list |
open (ברירת מחדל) או list. שניהם מחזירים את ווידג'ט ניהול הרישום; הערך מתעד את כוונת האינטראקציה המבוקשת. |
לא |
כתובת הארגון
| קלט | תיאור | חובה |
|---|---|---|
| — | אופציונלי. כתובת סביבה .dynamics.com . כאשר ניתן, הוא מחליף את הסביבה שנבחרה כרגע. |
לא |
תגובה והתנהגות ממשק משתמש
כלי זה מציג ווידג'ט לניהול רישום אינטראקטיבי.
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
ווידג'ט ניהול רישום אינטראקטיבי
בשתי הפעולות, הווידג'ט מציג את ממשק ניהול הרישומים שבו מנהלי המנהלים יכולים לגלוש, להוסיף, לערוך, לבדוק ולמחוק רישומים של שרתי MCP.
הערך action נשאר רמז כוונה בתגובה.
הערות ניתוב
שימוש manage_mcp_registration כאשר:
- המשתמש אומר "שרת MCP", "שרת כלים חיצוני", "נקודת קצה של כלי צד שלישי", או "רשום נקודת קצה של כלי".
- המשתמש מדביק כתובת URL של שרת HTTPS ורוצה לרשום אותה.
- המשתמש מבקש לנהל, לצפות או להגדיר אינטגרציות כלים חיצוניות.
אל תשתמש manage_mcp_registration ב:
- המשתמש מזכיר סוכן Copilot Studio, סוכן משנה או סוכן MCS — נתיב ל-
manage_copilot_studio_registration. - המשתמש רוצה להאציל האצלה לבוט שפורסם — route to
manage_copilot_studio_registration.
כלים קשורים
| כלי | מערכת יחסים |
|---|---|
save_mcp_registration |
כלי מופעל באמצעות ווידג'טים שממשיך רישום חדש או מעודכן |
delete_registration |
כלי מופעל באמצעות ווידג'טים שמסיר רישום עם type: "mcp" |
test_mcp_registration_connection |
כלי עם שימוש בווידג'טים שבודק קישוריות לנקודת קצה |
manage_copilot_studio_registration |
ממשק מנהל מקביל לרישום סוכני Copilot Studio |
סיווג מוטציות נתונים
נקודת כניסה לקריאה בלבד עם פוטנציאל מוטציה במורד הזרם.
הכלי עצמו אינו משנה נתונים. הווידג'ט שהוא מציג מפעיל save_mcp_registrationאת , delete_registration עם type: "mcp", ו test_mcp_registration_connection - לביצוע פעולות כתיבה.