המודל
- יכולת היא ממשק עם טיפוס, אף פעם לא מוצר. ל-
mailיש את הפעולותmail.inbox.read,mail.inbox.searchו-mail.message.send. - חבילת עובד מפרטת את היכולות שהתפקיד שלה צריך ב-
requires.interfaces. - תוסף מספק יכולת על ידי קישור הפעולות שלה לפקודות שלו ב-
interfaceBindings. - חיבור הוא התוסף שהבעלים חיבר עבור אותה יכולת. טריגר מעקב שמציין יכולת רץ עליו.
הצהרה על מה שתפקיד צריך
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} ציין יכולות, לא תוספים. חבילת עובד שדורשת ledger עובדת בכל חברה, לא משנה באיזו מערכת הנהלת חשבונות היא משתמשת. השתמש ב-requires.plugins רק כשתפקיד באמת תלוי בתוסף מסוים אחד.
אספקת יכולת
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} תוסף שמקשר פעולה כלשהי מסוג mail.* מספק את mail. כל קישור הופך גם לכלי עם טיפוס לעובדים, כמו mail_message_send. תחביר התבנית מופיע במדריך plugin.json.
כשתהליך עבודה עוקב אחר יכולת, Nebo בוחר את התוסף המותקן שמספק אותה, ומעדיף תוסף שלעובד הזה יש בו חשבון, ואחר כך לפי סדר אלפביתי. אם אין אף אחד, תהליך העבודה נשמר, מסומן כפגום, והבעלים מקבל הודעה מה לחבר.
הקטלוג
Nebo מגיע עם קטלוג של יכולות והפעולות שלהן, כולל ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring ו-incidents. הקטלוג הוא אוצר מילים משותף, לא גדר. השתמש במונחים שלו בכל מקום שמתאים, כדי שעובדים ותוספים ממפרסמים שונים ייפגשו; מונח חדש הוא עניין של מוסכמה, לא שגיאה.
כל פעולה נושאת אחד משלושה סימונים.
| סימון | משמעות |
|---|---|
| ללא אישור | קריאה, או פעולה מגינה שהפיכה ומאבדת מערכה אם היא מחכה, כמו השהיה, ביטול או חזרה לאחור. רץ בלי לשאול. |
| דורש אישור | מעביר כסף, יוצר קשר עם מישהו מחוץ לחברה, או שאי אפשר לבטל אותו. Nebo שואל לפני שהכלי המקושר רץ. |
| קריטי | העברת כסף, כריתת חוזה, הרשומות של החברה עצמה, או סמכות קבועה לפעול ללא השגחה. תמיד דורש אישור; הבעלים מעניק כל אחת לכל עובד ולכל פעולה בנפרד, ושום הגדרה ברמת העובד לא מרופפת את זה. |
הסכמה בגיוס
כשבעלים מגייס עובד, Nebo קורא את הצרכים שלו מהחבילה: היכולות ב-requires.interfaces, התוספים ב-requires.plugins, וכל יכולת או תוסף שטריגר מעקב מציין. הבעלים רואה משפט אחד שמציין את הצרכים האלה. הגיוס מעניק אותם לאותו עובד כהרשאות קבועות. פעולות שדורשות אישור נשארות פריטים לאישור.
התקנת תוסף, שרת MCP, אפליקציה או כישור היא כשלעצמה ההרשאה להשתמש בהם; הם לא מופעלים אחד אחד. היכולות המובנות של Nebo עצמו מקובצות כ-chat, file, shell, web, contacts, desktop, media ו-system.
תקרות וחוקים
| מוצהר ב | השפעה |
|---|---|
ceiling ב-agent.json | הפעולות המפורטות תמיד שואלות את הבעלים עבור העובד הזה. הערך היחיד הוא "approval". |
ceiling של חוק בשכבת החברה | הפעולות המפורטות חסומות לכל עובד. |
חוק חברה עם reserved_to: owner | הפעולות המפורטות דורשות את האישור של הבעלים עצמו, ואת האישור הזה אי אפשר להעניק לעובד לעולם. |
מצבי הרשאה
לכל עובד יש מצב הרשאה. הוא מכריע בקריאות ששום כלל לא מכריע בהן, והבעלים יכול לעקוף אותו לריצה בודדת.
| מצב | התנהגות |
|---|---|
automatic | ברירת המחדל. העובד פועל בתוך התפקיד שלו ושואל רק על פעולות שדורשות אישור ועל כללי השאלה של הבעלים. |
ask | כל קריאה שמשנה משהו שואלת, אלא אם כלל היתר מכסה אותה. |
plan | קריאה ותכנון בלבד. קריאה שמשנה משהו לא רצה. |
full_access | שום דבר לא שואל. כללי חסימה ומגבלות קשיחות עדיין חלים. |
Nebo בודק כל פעולה באותו סדר: קודם מגבלות קשיחות, אחר כך תקרות וחוקים, אחר כך הכללים של הבעלים, ואחר כך המצב. מגבלות קשיחות, כמו הגנה על פרטי גישה מפני דליפה, אף פעם לא מוסרות, אפילו לא ב-full_access.