ממשל

ממשל הוא המקום שבו אתם מחליטים מה מותר לעוזר לעשות. שלושה דברים פועלים יחד, וכולם נמצאים בקטלוג הכלים (/tools): ממשל יכולות עבור יכולות ה-API שלכם, זמינות כלים לקביעת מי רשאי להשתמש בכל כלי, ויכולות עמוד (Abilities) עבור הפעולות שהרכיב המוטמע רושם בעמוד שלכם.

ממשל יכולות

ממשל היכולות, בקטלוג הכלים (/tools), מציג כל יכולת שהגילוי מצא. כל שורה נושאת תג תופעת-לוואי ושני מתגים בלתי תלויים.

• מופעלת — האם היכולת מוצגת לעוזר וניתנת לקריאה על ידו. כבויה פירושה בלתי נראית.
• דרישת אישור — כופה שלב אישור לפני שהיכולת רצה. הפעלת אישור לעולם אינה מפעילה יכולת מושבתת; שני המתגים בלתי תלויים זה בזה.
• תג תופעת לוואי — קריאה, כתיבה או הרסנית, כך שתוכלו לראות במבט אחד אילו יכולות משנות נתונים.

סרגל **החל על הכול** פועל על כל היכולות שנטענו בעמוד בבת אחת: הפעל הכול, השבת הכול, דרוש אישור לכול, או הסר אישור מהכול. כל פעולה מבקשת אישור ומציגה כמה יכולות היא תשנה; יכולות שכבר תואמות נשארות ללא שינוי. אם נותרו יכולות שטרם נטענו, רק הטעונות מושפעות.

זמינות כלים

זמינות הכלים, גם היא בקטלוג הכלים (/tools), קובעת אילו כלים משטחי הצ׳אט וה-MCP מציעים לכל משתמש קצה. כל כלי זמין כברירת מחדל, וה-API שלכם הוא שאוכף הרשאות; הוסיפו כלל כדי לכוון כלי למשתמשים מסוימים. כללים מתאימים לפי זהות, לא לפי זמן — אין כאן תזמון.

• דרישת התחברות — הציעו את הכלי רק למשתמשים מאומתים.
• הרשאות נדרשות — התנו את הכלי ב-scopes של OAuth, בהתאמה של כולם או של אחד מהם.
• התאמות תכונות — כוונו לתביעת זהות (claim) או לתכונת הקשר-מארח, עם אופרטור וערך.
• כללים מתקדמים — ללוגיקה שהטופס הפשוט אינו יכול לבטא, ערכו את הכלל כ-JSON עם ביטויי and/or/not.

יכולות עמוד (Abilities)

יכולות העמוד, התחום השלישי בקטלוג הכלים (/tools), מנהלות את הפעולות שהרכיב המוטמע שלכם רושם בעמוד באמצעות syncanix.registerAction — פעולות בצד הלקוח כמו רענון רשימה. הן נבדלות מיכולות הקטלוג, שהן נקודות הקצה של ה-API שלכם.

• מתג חירום — מתג ראשי שמונע מהעוזר לבצע כל פעולה רשומה, ללא תלות במתגים של כל יכולת עמוד.
• מתג «פעילה» לכל יכולת עמוד — יכולת עמוד לא פעילה לעולם אינה מוצגת לעוזר ואינה ניתנת לקריאה.
• אישור — יכולת עמוד יכולה לדרוש שמשתמש הקצה יאשר לפני שהיא רצה. אפשר גם להצהיר על יכולת עמוד עוד לפני שהרכיב רושם אותה.

השלבים הבאים