החבילה
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | קובץ | חובה | מטרה |
|---|---|---|
AGENT.md | כן | הפרסונה: מי העובד, איך הוא עובד והכללים שלו. ראה פרסונה וזיכרון. |
agent.json | לא | היכולות שהוא דורש, שאלות לבעלים, תהליכי עבודה, הגדרות זיכרון ותקרות אישור. ראה מדריך agent.json. |
skills/ | לא | כישורים בפורמט SKILL.md הסטנדרטי. רק העובד הזה רואה אותם. |
manifest.json | לאפליקציות בלבד | זהות עם "type": "app". החנות כותבת מניפסט משלה כשהיא אורזת עובד. |
ui/ | לאפליקציות בלבד | הדף של האפליקציה. ראה אפליקציות. |
כתיבת חבילה
התחל מהפרסונה. ה-frontmatter נותן שם לעובד ותיאור בשורה אחת; הגוף הוא הוראות בפרוזה פשוטה.
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
הוסף agent.json כשהתפקיד צריך מערכת, הגדרה מהבעלים או עבודה שהוא עושה בלי שיבקשו. הקובץ הזה דורש את היכולת mail, שואל שאלה אחת בגיוס ועונה על כל הודעה חדשה כשהיא מגיעה.
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} המעקב מציין את היכולת mail, לא מוצר. בזמן ריצה היא מתורגמת לתוסף שהבעלים חיבר לדואר. ראה תהליכי עבודה לטריגרים ולפעולות.
טעינה על בוט
שים את התיקייה ב-<data>/user/agents/<name>/. Nebo עוקב אחר AGENT.md, agent.json ו-manifest.json וטוען מחדש את העובד כשנייה אחרי שינוי. הסרת התיקייה משביתה את העובד אבל שומרת את הרשומה שלו.
Nebo טוען עובדים משלושה מקורות, והמקורות המאוחרים גוברים: עובדים שמובנים ב-Nebo, חבילות חתומות וסגורות מהחנות ב-<data>/nebo/agents/, ותיקיות ב-<data>/user/agents/. עובד יכול גם ליצור או לשנות עבורך חבילה בעזרת הכלים create_employee ו-update_employee שלו, שכותבים לאותה תיקייה.
מה קורה בגיוס
כשבעלים מגייס את העובד שלך מהחנות או עם קוד AGNT-, Nebo:
- קורא את הצרכים של החבילה בלי לשאול מודל: כל יכולת ב-
requires.interfaces, כל תוסף ב-requires.plugins, וכל יכולת או תוסף שטריגר מעקב מציין. - מציג לבעלים משפט הסכמה אחד לצרכים האלה, ועם הגיוס מעניק אותם לעובד הזה כהרשאות קבועות. פעולות שדורשות אישור נשארות כך. ראה יכולות ואישורים.
- מתקין תלויות: תוספים ב-
requires.plugins, כישורים מהחנות שמוזכרים ב-skillsובפעולות, והתלויות שהוצהרו כשהחבילה פורסמה. - שואל את הבעלים את שאלות ה-
inputs, ומודיע לבעלים דרך תיבת הדואר הנכנס על כל יכולת שעדיין אין לה חיבור.
תהליך עבודה שליכולת שלו אין חיבור נשמר ומסומן כפגום, עם הסיבה. הוא מתחיל לעבוד ברגע שהבעלים מחבר מערכת.
מה Nebo בודק
Nebo קורא את agent.json בסלחנות. מפתחות לא מוכרים מתעלמים מהם. תהליך עבודה שלא תואם לסכמה מדולג, והבעלים מקבל הודעה בתיבת הדואר הנכנס שהוא לא ירוץ; שאר העובד עדיין נטען. הבעיות האלה פוסלות את כל הקובץ:
- טריגר
eventעם רשימתsourcesריקה. - שתי פעולות עם אותו
idבאותו תהליך עבודה. - קלט עם
scopeשאינוcompanyאוseat, או שאלה כספית עם ערך ברירת מחדל. - ערך
ceilingשאינו"approval". - עץ שיחות טלפון בלי ברכה אחת בדיוק ובלי לפחות כוונה אחת בעלת שם.
חלק מהבדיקות רצות כשתהליך עבודה מתחיל ולא כשהוא נטען, למשל הפרמטרים שכל סוג פעולה דורש. ראה פעולות.
כתוב תחומי אחריות, לא כלים. חבילת עובד מציינת יכולות, כמו ledger או mail, ואף פעם לא מוצר, חברה או תעשייה מסוימים. הבעלים מחליט איזו מערכת ממלאת כל יכולת, כך שחבילה אחת משרתת כל חברה שמגייסת אותה.
הבא
- מדריך agent.json
- פרסונה וזיכרון
- פרסום: הצב את העובד בחנות.