NeboAI
NeboAI
להתחלה

חבילות עובדים

חבילת עובד מתארת תפקיד שחברה יכולה לגייס: על מה העובד אחראי, איך הוא עובד, אילו סוגי מערכות הוא צריך ומה הוא עושה בעצמו. כותבים אותה כתיקייה עם AGENT.md, וכשהתפקיד צריך יותר מצ׳אט, גם agent.json.

החבילה

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:

  1. קורא את הצרכים של החבילה בלי לשאול מודל: כל יכולת ב-requires.interfaces, כל תוסף ב-requires.plugins, וכל יכולת או תוסף שטריגר מעקב מציין.
  2. מציג לבעלים משפט הסכמה אחד לצרכים האלה, ועם הגיוס מעניק אותם לעובד הזה כהרשאות קבועות. פעולות שדורשות אישור נשארות כך. ראה יכולות ואישורים.
  3. מתקין תלויות: תוספים ב-requires.plugins, כישורים מהחנות שמוזכרים ב-skills ובפעולות, והתלויות שהוצהרו כשהחבילה פורסמה.
  4. שואל את הבעלים את שאלות ה-inputs, ומודיע לבעלים דרך תיבת הדואר הנכנס על כל יכולת שעדיין אין לה חיבור.

תהליך עבודה שליכולת שלו אין חיבור נשמר ומסומן כפגום, עם הסיבה. הוא מתחיל לעבוד ברגע שהבעלים מחבר מערכת.

מה Nebo בודק

Nebo קורא את agent.json בסלחנות. מפתחות לא מוכרים מתעלמים מהם. תהליך עבודה שלא תואם לסכמה מדולג, והבעלים מקבל הודעה בתיבת הדואר הנכנס שהוא לא ירוץ; שאר העובד עדיין נטען. הבעיות האלה פוסלות את כל הקובץ:

  • טריגר event עם רשימת sources ריקה.
  • שתי פעולות עם אותו id באותו תהליך עבודה.
  • קלט עם scope שאינו company או seat, או שאלה כספית עם ערך ברירת מחדל.
  • ערך ceiling שאינו "approval".
  • עץ שיחות טלפון בלי ברכה אחת בדיוק ובלי לפחות כוונה אחת בעלת שם.

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

כתוב תחומי אחריות, לא כלים. חבילת עובד מציינת יכולות, כמו ledger או mail, ואף פעם לא מוצר, חברה או תעשייה מסוימים. הבעלים מחליט איזו מערכת ממלאת כל יכולת, כך שחבילה אחת משרתת כל חברה שמגייסת אותה.

הבא