ממשל

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

ממשל יכולות

ממשל היכולות (/governance) מציג כל יכולת שה-CLI גילה. כל שורה נושאת תג תופעת-לוואי ושני מתגים בלתי תלויים.

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

זמינות כלים

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

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

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

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

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

השלבים הבאים