הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
היכולת הזו פועלת מאחורי הקלעים כאשר מוסיפים או עורכים רישום סוכן Copilot Studio מתוך ווידג'ט ניהול הרישום.
מה הוא עושה
כשאתה ממלא את טופס ההרשמה בווידג'ט ניהול הסוכנים של Copilot Studio ובוחר 'שמירה', הכלי הזה שומר את ההרשמה בסביבת Dynamics 365 שלך. הוא מטפל הן ביצירת רישומים חדשים והן בעדכון רשמים קיימים.
הכלי מאמת את זהות הבוט ושם הסכימה, אוכף את תקרת הרישום (10 לכל סביבה), ומונע מזהי בוטים כפולים או שמות סכימות. עם ההצלחה, הוא שומר את הרישום ומרענן את רשימת הכלים של סוכן השירות כך שההקצאת הסוכן החדש תהיה זמינה.
נסה הנחיות כמו
לא ישים. כלי זה נקרא אוטומטית כאשר שומרים רישום מהווידג'ט של הניהול. הוא לא מופעל על ידי הקלדת הנחיה.
מה שתראו בצ'אט
ווידג'ט ההרשמה מתעדכן כדי לאשר שהשמירה הצליחה, ומציג את מזהה הרישום והאם נוצר או עודכן. אם האימות נכשל (למשל, מזהה בוט כפול או שם סכימה), הווידג'ט מציג הודעת שגיאה שמסבירה מה לתקן.
עצות שימושיות
- עליך להריץ Test Connection לפני שמירת הרשמה חדשה. המטא-דאטה של הבוט מהבדיקה משמשת למילוי השדות הנדרשים.
- כל בוט יכול להירשם רק פעם אחת. הסר קודם את הרישום הקיים אם אתה צריך לרשום מחדש את אותו בוט.
- התיאור שאתה מספק הוא מה שסוכן השירות רואה כאשר הוא מחליט אם להאציל שאלה לסוכן זה. תן את זה ברור ומדויק.
- שמות הסכמות חייבים להיות ייחודיים בכל הרשמות ל-Copilot Studio בסביבה שלך.
מה קורה הלאה?
לאחר השמירה, ווידג'ט ההרשמה חוזר לתצוגת הרשימה. באפשרותך:
- בדוק את החיבור שוב.
- ערוך את הרישום ששמרתי.
- הוסיפו סוכן נוסף של Copilot Studio.
האם זה משנה את הנתונים?
כן, זה משנה את הנתונים.
שמירת רישום יוצרת או מעדכנת רשומת קונפיגורציה בסביבת Dynamics 365 שלך ומרעננת את רשימת הכלים הזמינה של סוכן השירות.
דרישות מוקדמות
כלי זה דורש את הדברים הבאים:
- הרחבת Copilot עם Copilot Studio שתעבור הגדרה. נדרש תפקיד מנהל מערכת או מנהל שירות Copilot.
למדו עוד ב-Extend Copilot עם Copilot Studio.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | שמירת רישום סוכן MCS |
| שם הכלי הפנימי | save_copilot_studio_registration |
| מטרה | שומר רישום סוכן חדש או מעודכן של Copilot Studio (MCS) |
התנהגות כלי
שומר על רישום סוכן חדש או מעודכן של Copilot Studio (MCS). זהו כלי תמיכה בווידג'טים שמופעל אוטומטית כאשר משתמשים מתקשרים עם ווידג'ט רישומי ההרחבה. הוא אינו מיועד להפעלה ישירה על ידי המודל.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
false |
כלי זה יוצר או מעדכן נתוני רישום. |
destructiveHint |
false |
העדכונים אינם הרסניים (תבנית upsert). |
idempotentHint |
true |
קריאות חוזרות עם אותו קלט מניבות את אותה תוצאה. |
openWorldHint |
לא הוגדר | משתמש כברירת מחדל. |
מושגי קלט
אובייקט רישום
| קלט | תיאור | נדרש |
|---|---|---|
botId, name, displayName, , description, inputParametersenvironmentIdschemaName, ,m365AppId |
מכיל את פרטי רישום הסוכן כולל botId (GUID בוט Dataverse), name (מזהה ייחודי), displayName, description, inputParameters, environmentId (סביבת Power Platform), schemaName, ו m365AppId-. |
לא |
מזהה רישום
| קלט | תיאור | נדרש |
|---|---|---|
id |
id (אופציונלי). כאשר ניתן, מעדכן רישום קיים; כאשר מושמטים, נוצר אחד חדש. |
לא |
כתובת הארגון
| קלט | תיאור | נדרש |
|---|---|---|
orgUrl |
orgUrl (אופציונלי). מחליף את כתובת ה-URL הסביבתית שנבחרה כרגע. |
לא |
תגובה והתנהגות ממשק משתמש
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
עדכון ווידג'טים
הווידג'ט מתעדכן ומציג את הרישום ששמר.
הערות ניתוב
הכלי הזה נקרא בלעדית על ידי הווידג'ט manage_copilot_studio_registration . אל תפעיל את זה ישירות.
כלים קשורים
| כלי | קשר |
|---|---|
manage_copilot_studio_registration |
כלי המשגר שפותח את ווידג'ט ההרשמה |
delete_registration |
מסיר רישום סוכן כאשר type הוא "mcs" |
test_copilot_studio_registration_connection |
בודק את נגישות הסוכן לפני השמירה |
list_copilot_studio_registration_bots |
רשימת בוטים זמינים עבור בחירת הבוטים |
סיווג מוטציות נתונים
כתוב (העלות). יוצר או מעדכן רישום סוכן Copilot Studio בחנות הרישום המוגדרת על ידי הארגון.