החבילה
אפליקציה היא חבילת עובד עם manifest.json שמסמן אותה כאפליקציה ועם תיקייה ui/ שבה הדף.
<data>/user/agents/deal-board/
├── manifest.json # marks the employee as an app
├── AGENT.md # the employee behind the page
├── agent.json # optional: sidecar tools, workflows
└── ui/
├── index.html
└── app.js {
"id": "<minted UUID>",
"name": "deal-board",
"version": "1.0.0",
"type": "app",
"window": { "title": "Deal Board", "width": 900, "height": 700, "resizable": true },
"permissions": ["storage:readwrite"]
} | שדה | משמעות |
|---|---|
type | "app". הופך את העובד לאפליקציה. Nebo קורא גם את השדה הישן artifact_type. |
id | UUID שנוצר כשהאפליקציה נוצרת. הדף מוגש ב-/apps/<id>/ui/. |
name, version | שם העובד וגרסת החבילה. |
window | title, width, height, resizable, fullscreen, orientation. ברירות מחדל: 1024 × 768, ניתן לשינוי גודל, לא במסך מלא, לאורך, עם כותרת לפי שם העובד. |
permissions | מה הדף רשאי לעשות. ברירת מחדל ["storage:readwrite"]. |
הרשאות
| הרשאה | מעניקה |
|---|---|
storage:readwrite | מאגר המפתח-ערך של האפליקציה. |
subagent:<employee-id> | שאלה לעובד אחר מתוך הדף. העובד של האפליקציה עצמה לא צריך הרשאה. |
network:<host> או network:* | בקשות למארחים חיצוניים דרך ה-proxy של Nebo. |
device:motion | הג׳ירוסקופ ומד התאוצה לדף הזה בלבד. ב-iPhone הדף גם קורא ל-DeviceMotionEvent.requestPermission() מתוך הקשה. |
כל הרשאה היא prefix:scope. בקש את המינימום שהאפליקציה צריכה.
מסך מלא, כיוון והטיה
משחקים וסרטים יכולים לתפוס את כל המסך. הגדר fullscreen, ולאפליקציה לנייד גם orientation: portrait (ברירת המחדל), landscape או any. כל כיוון אחר נדחה כשהמניפסט נכתב.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - במחשב, האפליקציה נפתחת בחלון במסך מלא.
- באפליקציה לנייד אין סרגל אפליקציה, סרגלי המערכת מוסתרים, המסך נשאר דלוק ומשיכה לרענון כבויה. כפתור סגירה קטן יושב בפינה השמאלית העליונה ונעלם אחרי כמה שניות; נגיעה ליד החלק העליון מחזירה אותו. החלקה מהקצה ב-iOS כבויה, וכפתור החזרה של Android עובר בהיסטוריה של הדף לפני הסגירה.
- הוסף ריפוד לדף עם
env(safe-area-inset-*)ו-viewport-fit=cover, והשאר את הפינה השמאלית העליונה פנויה מפקדים.
פקד הקול
כל אפליקציה שנפתחת באפליקציית Nebo למחשב או באפליקציה לנייד מציגה פקד קול קטן בפינה הימנית התחתונה, כדי שהבעלים יוכל לדבר עם העובד של האפליקציה בזמן שהוא עובד על הדף. הפקד נמצא מחוץ לדף שלך, כך שטעינה מחדש של הדף אף פעם לא מנתקת את השיחה.
- במחשב זה סרגל של כ-300 על 48 פיקסלים, 16 פיקסלים פנימה מהפינה הימנית התחתונה של החלון.
- באפליקציה לנייד זה כפתור עגול בגודל 48 נקודות בתוך האזור הבטוח, שהבעלים יכול לגרור לכל אחד מהצדדים. באפליקציה במסך מלא הוא מתקפל חזרה לכפתור הזה כמה שניות אחרי תחילת שיחה.
- השאר את הפינה הימנית התחתונה פנויה מפקדים חשובים.
- במהלך משימה ארוכה בשיחה, העובד אומר עדכונים קצרים כמו „עכשיו עורך.” ואף פעם לא מקריא שמות קבצים או פקודות.
יצירת אפליקציה
עובד יכול לבנות אפליקציה בשתי דרכים, ובוחר לפי מה שהבעלים אומר. „תבנה לי אפליקציה להזמנות שלי” יוצר עובד אפליקציה חדש. „אתה האפליקציה” או „תבנה לעצמך משחק” הופך את העובד שהבעלים מדבר איתו לאפליקציה: הוא שומר על הצ׳אט, הזיכרון והפרסונה שלו, והדף שלו נטען מחדש בזמן שהבעלים מדבר איתו. זה עובד גם לעובד שגויס בשיחה. כשלא ברור למה הבעלים מתכוון, העובד שואל פעם אחת.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) כלים יומיומיים (מעקב, טופס, לוח בקרה קטן) נבנים עם כישור האפליקציות המובנה של Nebo. דף שצריך להיראות מעוצב ולא מחולל, כמו דף נחיתה קולנועי, סרט שמונע בגלילה, אמנות גנרטיבית או משחק, נבנה עם הכישור App Studio מהחנות.
לאפליקציה חדשה, הדרך הפשוטה ביותר היא לבקש מעובד. Nebo כולל כישור מובנה לבניית אפליקציות, והעובד משתמש ב-create_employee, שכותב את התיקייה, המניפסט, הפרסונה והדף בקריאה אחת. האפליקציה מופיעה בכוח האדם של הבעלים תוך שניות.
create_employee(
name: "deal-board",
description: "A board of open deals, sorted by close date.",
app: {
window: { title: "Deal Board", width: 900, height: 700, resizable: true },
permissions: ["storage:readwrite"]
},
ui: { "index.html": "<!doctype html>..." }
) update_employee מקבל את אותם ארגומנטים ui, app ו-agent_md. נתיב ב-ui מחליף את הקובץ הזה בלבד. הדף נקרא מהדיסק בכל בקשה, כך שטעינה מחדש של החלון מציגה את השינוי.
דף מינימלי
הדף הזה טוען את ה-SDK, שואל מי העובד שלו ומדפיס את התשובה. אם הוא מציג את המזהה והשם של העובד, החיווט תקין.
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Deal Board</title>
</head>
<body>
<h1>Deal Board</h1>
<pre id="who">loading...</pre>
<script src="/sdk/nebo.global.js"></script>
<script>
NeboAppSDK.nebo.identity.get()
.then(me => { document.getElementById('who').textContent = JSON.stringify(me, null, 2); })
.catch(err => { document.getElementById('who').textContent = String(err); });
</script>
</body>
</html> ה-SDK מוצא את מזהה האפליקציה מכתובת הדף. דף שמוגש מכל מקום אחר צריך <meta name="nebo-app-id" content="<id>">. שמור את המצב באחסון של האפליקציה, לא בדף: החלון נסגר, והאחסון שורד.
איך הדף מוגש
- Nebo מגיש את
ui/ב-/apps/<id>/ui/ופותח אותו בחלון משלו. - נתיב שאין לו קובץ תואם נופל אל
index.html, כך שניתוב בצד הלקוח עובד. - דפי HTML מקבלים את תגי המטא
nebo-app-idו-nebo-base-url. - כל קובץ נשלח עם סוג התוכן האמיתי שלו, כולל וידאו, צליל, גופנים,
wasmומודלים בתלת-ממד (glb,gltf). קובץ עם סיומת לא מוכרת נשלח כ-application/octet-stream, והדפדפן לא ישתמש בו. - קבצים עונים לבקשות טווח (
206, או416לטווח שמעבר לסוף), כך שאפשר לדלג בתוך וידאו וקול. באפליקציה לנייד, וידאו מתנגן במקום בלי הקשה:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - קובץ ששמו כולל גיבוב תוכן, כמו
main-0a8ksftt.js, נשמר במטמון לשנה. כל השאר, כוללindex.html, נבדק בכל פתיחה ועונה304כשהוא לא השתנה. בנה עם שמות מגובבים במקום לשנות שמות קבצים ידנית. - כל קובץ דף יכול להיות בגודל של עד 10 MB.
- מחיקת התיקייה משביתה את העובד;
delete_employeeמסיר אותו לגמרי.
הוספת sidecar
כשהדף צריך לוגיקת שרת, נתונים משלו או כלים שהעובד יכול לקרוא להם, הוסף sidecar: קובץ בינארי ש-Nebo מריץ לצד האפליקציה. הדף מגיע אליו עם neboFetch ונתיב יחסי. ראה App Sidecar.
פרסום מתוך Nebo
אפליקציה שהבעלים יצר יכולה לפרסם את עצמה. הבעלים אומר „פרסם את עצמך”, או מקיש על פרסם בצ׳אט של האפליקציה, במסך האפליקציה באפליקציה לנייד (בסרגל העליון, או ככפתור ליד סגירה באפליקציה במסך מלא), או בוחר פרסם את האפליקציה הזו… מתפריט המחשב (התפריט File ב-macOS כשחלון אפליקציה בחזית; התפריט App של חלון האפליקציה ב-Windows וב-Linux). העובד מנסח את דף הפריט מתוך האפליקציה, מצלם 3 עד 5 צילומי מסך ומציג את הדף בצ׳אט כדי לעצב אותו בשיחה. שום דבר לא נשלח עד שהבעלים עונה שלח לבדיקה בכרטיס, בהקשה או בקול.
לאפליקציה שהבעלים יצר תמיד יש את כלי הפיתוח שלה לעצמה: טעינה מחדש, סטטוס, מסוף, צילומי מסך ופרסום. מצב מפתח אפליקציות (הגדרות הבוט, מפתח) מאפשר לעובדים אחרים לעבוד על כל אחת מהאפליקציות של הבעלים, מוסיף לדף מסוף צף ומכבה את המטמון. אפליקציות שהותקנו מהחנות אף פעם לא מקבלות כלי פיתוח או כפתור פרסם.
פרסום אפליקציה בעצמך
אפליקציה שהיא דף בלבד מתפרסמת כחבילה אחת עם הכלי agent. ה-frontmatter של AGENT.md חייב לכלול artifact_type: app, אחרת החנות יוצרת עובד רגיל בלי דף. שים במירכאות כל ערך שמכיל נקודתיים ואחריהן רווח; בלי מירכאות, אי אפשר לקרוא את ה-frontmatter והאפליקציה הופכת בשקט לעובד רגיל.
--- name: deal-board description: "A board of open deals: sorted by close date, with a chat that knows each deal." artifact_type: app metadata: version: "1.0.0" --- # Deal Board You work beside the Deal Board app. ...
agent(action: "create", name: "deal-board", version: "1.0.0",
description: "A board of open deals, sorted by close date.",
manifestContent: "<contents of AGENT.md>")
agent(action: "bundle-token", id: "<app id>")
zip -r deal-board.zip deal-board -x '*/.git/*' '*/node_modules/*' '*/src/*'
curl -X POST "https://neboai.com/api/v1/skills/<app id>/bundle" \
-H "Authorization: Bearer <token>" \
-F file=@deal-board.zip
agent(action: "submit", id: "<app id>", version: "1.0.0") | בקובץ ה-zip | מה קורה |
|---|---|
AGENT.md | הפרסונה והמניפסט של דף הפריט. |
agent.json | התצורה של העובד. {} זה בסדר. |
manifest.json | נשמר כמניפסט של האפליקציה: החלון וההרשאות מגיעים לאפליקציה המותקנת. חייב להיות JSON תקין. |
ui/ | הדף. מותר: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, תמונות (png, jpg, gif, svg, webp, avif, ico, bmp), גופנים (woff, woff2, ttf, otf), צליל (mp3, wav, ogg, m4a, aac, flac, opus), וידאו (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. קבצים שמתחילים בנקודה ו-node_modules/ מושמטים. |
skills/<name>/ | הכישורים של העובד עצמו, שנבדקים כמו כישור שהועלה בנפרד: SKILL.md נשמר, scripts/ ו-bin/ מכל סוג, וכל השאר לפי רשימת ההיתר של כישורים. |
- מגבלות: 10 MB לכל קובץ ו-50 MB לכל חבילה. קובץ מעל 10 MB מדולג (בדוק את
filesSkippedואתuiFilesStoredבתוצאה); חבילה מעל 50 MB נדחית. - אסימון ההעלאה תקף ל-5 דקות. תיקייה עליונה יחידה בקובץ ה-zip מוסרת.
- באפליקציה פרטית או לערוצים בלבד, כל העלאה בונה מחדש מיד את החבילה להתקנה, ו-Nebo מודיע לבוטים שהתקינו את האפליקציה. בוט מחובר מציב את החבילה החדשה מיד; בוט לא מחובר עושה זאת בפעם הבאה שהוא מתחבר. אין צורך להעלות את הגרסה בשביל זה, וההגדרות, התזמונים והנתונים של הבעלים עבור האפליקציה נשמרים. אפליקציות ציבוריות, לא רשומות ולמוזמנים בלבד שומרות על החבילה המאושרת שלהן עד שגרסה חדשה עוברת בדיקה.
- גרסה חדשה פועלת לפי הגדרת העדכונים האוטומטיים של כל בעלים עבור האפליקציה. היא כבויה אלא אם הבעלים מפעיל אותה, כך שכברירת מחדל הבוט מציג „עדכון זמין” והבעלים מחיל אותו מהגדרות ← עדכונים, או מתיבת הדואר הנכנס. עדכון אף פעם לא מעניק הרשאות חדשות; הרשאה שהגרסה החדשה מוסיפה מתבקשת כשהאפליקציה צריכה אותה לראשונה.
- אם NeboAI מסיר אפליקציה מהחנות, כל בוט שהתקין אותה מכבה אותה ומודיע לבעלים. שום דבר לא נמחק: כל מה שהאפליקציה שמרה נשמר.
- אפליקציה עם sidecar מעלה במקום זאת את הקובץ הבינארי של כל פלטפורמה עם
binary-token, ואת הדף כארכיוןui. ראה App Sidecar ופרסום.