NeboAI
NeboAI
להתחלה

מדריך agent.json

agent.json מכיל את כל מה שקשור לעובד ואינו פרוזה: היכולות שהוא דורש, השאלות שהוא שואל את הבעלים, איך הזיכרון שלו נשמר, אילו פעולות תמיד דורשות אישור ותהליכי העבודה שהוא מריץ. כל שדה הוא אופציונלי.

דוגמה

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

שדות

שדהסוגמשמעות
requires.interfacesרשימת מחרוזותהיכולות שהתפקיד צריך, כמו mail או ledger. ניתנות בגיוס; כל פעולה שדורשת אישור נשארת פריט לאישור. ראה יכולות ואישורים.
requires.pluginsרשימת מחרוזותתוספים שמותקנים יחד עם העובד. השתמש בזה רק כשהתפקיד באמת תלוי בתוסף אחד; עדיף להשתמש ביכולת.
requires.toolsרשימת מחרוזותכלים שנטענים לסשן של העובד מהתור הראשון שלו. זה אף פעם לא עוקף אישור.
skillsרשימת מחרוזותכישורים מהחנות להתקנה ולשימוש: @org/skills/name, אופציונלית עם @version, או קוד SKIL-. כישורים שבתיקייה skills/ של החבילה עצמה לא צריכים רשומה.
inputslistשאלות שהבעלים עונה עליהן בגיוס. ראה קלטים.
memoryobjectאיך שיחות וזיכרון נשמרים. ראה פרסונה וזיכרון.
subscribesרשימת מחרוזותתחומי מידע של החברה שהעובד קורא מחדש כשהם משתנים, כמו finance.ar.*.
ceilingmapפעולה אל "approval". הפעולה הזו תמיד שואלת את הבעלים עבור העובד הזה. שום ערך אחר לא מתקבל.
workflowsmapשם תהליך עבודה אל תהליך העבודה. ראה תהליכי עבודה.
toolslistכלי HTTP שמוגשים על ידי ה-sidecar של אפליקציה. ראה כלי Sidecar.
scopesmapקבוצות בעלות שם של tools, skills ו-plugins. ה-plugins של תחום מתוארים לעובד כשהתחום הזה פעיל.

קלטים

קלט הוא שאלה שהבעלים עונה עליה בזמן הגיוס. התשובות מופיעות לעובד תחת "Configured Inputs" וממלאות מצייני מיקום {{key}} בטריגרים של מעקב ושל תיקיות.

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
שדהברירת מחדלמשמעות
keyחובההשם שמשמש במצייני מיקום. name מתקבל כחלופה.
labelמתוך keyהשאלה שמוצגת לבעלים.
typetexttext, textarea, number, select, checkbox או radio.
requiredfalseמסמן את השאלה כשאלה שהבעלים חייב לענות עליה.
defaultאיןתשובה ממולאת מראש. לא מותרת בשאלה כספית.
placeholder, descriptionאיןטקסט עזרה.
optionsאיןעבור select ו-radio: אובייקטים מסוג {value, label} או מחרוזות פשוטות.
idאיןשם יציב עם נקודות לעובדה, כמו finance.ap.invoice_mailbox, כדי שעובדים אחרים יוכלו לשתף אותה.
scopecompanycompany: עובדה משותפת של החברה. seat: לגיוס הזה בלבד.
missingאיןמה העובד עושה כל עוד השאלה לא נענתה.
moneyfalseמסמן סכום כסף. לשאלה כספית לא יכול להיות ערך ברירת מחדל.

כלי Sidecar

אפליקציה עם sidecar חושפת לעובד שלה נקודות קצה של HTTP ככלים. Nebo רושם כל רשומה בשם app__<app>__<name> ושולח קריאות ל-sidecar לפי method ו-path. ראה App Sidecar.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

תהליכי עבודה

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