הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
היכולת הזו פועלת מאחורי הקלעים כשאתה בודק קישוריות לסוכן Copilot Studio מווידג'ט ניהול הרישום.
מה הוא עושה
כשאתה בוחר Test Connection בטופס ההרשמה לסוכן Copilot Studio, כלי זה מאשר שסוכן השירות יכול להגיע לבוט הנבחר. הוא מבצע בדיקה בת שלושה שלבים: שליפת זהות הבוט והמטא-דאטה מ-Dataverse, פתרון סביבת Power Platform, ואימות נגישות דרך Agents SDK.
אם החיבור מצליח, הכלי מחזיר את זהות הבוט, שם הסכימה, מזהה הסביבה שנפתרה, תצוגה מקדימה לתיאור קריאה בלבד, חותמת זמן של שליפת ותוצאות נגישות. נתונים אלו ממלאים את טופס הרישום. אם החיבור נכשל, הכלי מחזיר שגיאה מדורגת שמציינת איזה שלב נכשל (לדוגמה, בוט לא נמצא, בוט לא פעיל, הסביבה לא נפתרה, או SDK לא נגיש).
נסה הנחיות כמו
לא ישים. הכלי הזה נקרא אוטומטית כאשר בודקים חיבור מווידג'ט הניהול. הוא לא מופעל על ידי הקלדת הנחיה.
מה שתראו בצ'אט
ווידג'ט ההרשמה מציג את תוצאת הבדיקה בתוך הקו. עם ההצלחה, רואים את זהות הבוט מלאה מראש ותצוגה מקדימה לקריאה בלבד של תיאור Dataverse. תיאור הרישום נשאר שדה נפרד שנוצר על ידי יוצרים. במקרה של כישלון, אתה רואה הודעת שגיאה ספציפית שמתארת איזה שלב במבחן החיבור נכשל.
טיפים שימושיים
- תמיד תבדוק לפני שאתה שומר. המטא-דאטה של הבוט מבדיקה מוצלחת ממלאים את השדות הנדרשים בטופס ההרשמה.
- אם הבדיקה נכשלת בשלב "הבוט לא נמצא", ודאו שמזהה הבוט נכון והבוט פורסם ב-Copilot Studio.
- אם הבדיקה נכשלת בשלב "בוט לא פעיל", פרסם מחדש את הבוט ב-Copilot Studio כדי להפעיל אותו.
- אם הבדיקה נכשלת עם שגיאת הסכמה או הרשאה, בדוק שההרשאות הנדרשות ל-Power Platform קיימות עבור חשבון המשתמש שלך.
- למבחן יש מגבלת פסק זמן. אם ערכת הפיתוח של הסוכנים מגיבה באיטיות, המבחן עלול להיכשל גם אם הבוט טכנית נגיש.
מה קורה הלאה?
לאחר בדיקה מוצלחת, אפשר:
- שמור את הרישום הזה.
- בדוק את המטא-דאטה של הבוטים.
- כתוב תיאור לסוכן הזה.
האם זה משנה את הנתונים?
לא, זה לא משנה נתונים.
בדיקת חיבור היא לקריאה בלבד. הוא מביא מטא-דאטה ומאשר נגישות אך לא משנה שום תצורה.
דרישות מוקדמות
כלי זה דורש את הדברים הבאים:
- הרחבת Copilot עם Copilot Studio.
למדו עוד ב-Extend Copilot עם Copilot Studio.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | בדיקת חיבור סוכן MCS |
| שם הכלי הפנימי | test_copilot_studio_registration_connection |
| מטרה | אוסף את זהות הבוט של Copilot Studio ותצוגה מקדימה של תיאור קריאה בלבד, פותר את הסביבה שלו ומאשר נגישות דרך ערכת הפיתוח של Agents |
התנהגות כלי
מביא את זהות בוט Copilot Studio ותצוגה מקדימה לתיאור קריאה בלבד מ-Dataverse, פותר את סביבת Power Platform, ומאשר נגישות דרך ערכת הפיתוח של Agents. התצוגה המקדימה לא מתמשכת כתיאור הרישום; היוצר כותב את השדה הזה בנפרד. זהו כלי תמיכה בווידג'טים שמופעל אוטומטית מווידג'ט ניהול הרישום.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
true |
הכלי הזה לא משנה נתונים. |
destructiveHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
idempotentHint |
לא הוגדר | לא רלוונטי (כלי לקריאה בלבד). |
openWorldHint |
לא הוגדר | משתמש ברירת מחדל (שאילתות ל-Dataverse + Power Platform). |
מושגי קלט
מזהה תוכנית Bot
| קלט | תיאור | חובה |
|---|---|---|
botId |
botId (UUID, נדרש). ה-Dataverse bot.botid של הבוט Copilot Studio לבדיקה. |
כן |
מזהה סביבה
| קלט | תיאור | חובה |
|---|---|---|
environmentId |
environmentId (UUID, אופציונלי). סביבת Power Platform, GUID. כאשר הוא מסופק, הוא מדלג על קריאת ה-API של פתרון הסביבה. |
לא |
כתובת הארגון
| קלט | תיאור | חובה |
|---|---|---|
orgUrl |
orgUrl (אופציונלי). מחליף את כתובת ה-URL הסביבתית שנבחרה כרגע. |
לא |
תגובה והתנהגות ממשק משתמש
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
עדכון ווידג'ט עם תוצאות בדיקת חיבור
מחזיר זהות בוט, שם סכמה, מזהה סביבה, תצוגה מקדימה לתיאור קריאה בלבד, fetchedAtוסטטוס נגישות. הווידג'ט מציג הצלחה או טעות מסווגת.
הערות ניתוב
הכלי הזה נקרא בלעדית על ידי הווידג'ט manage_copilot_studio_registration . אל תפעיל את זה ישירות.
כלים קשורים
| כלי | מערכת יחסים |
|---|---|
manage_copilot_studio_registration |
כלי המשגר שפותח את ווידג'ט ההרשמה |
save_copilot_studio_registration |
שומר את הרישום עם תיאור והגדרת קלט שנוצרו על ידי היצרן |
list_copilot_studio_registration_bots |
רשימת בוטים זמינים עבור בחירת הבוטים |
delete_registration |
מסיר רישום סוכן כאשר type הוא "mcs" |
סיווג מוטציות נתונים
לקריאה בלבד. בודק קישוריות ומביא מטא-דאטה מבלי לשנות נתונים.