แพ็กเกจ
แอปคือแพ็กเกจพนักงานที่มี 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:* | คำขอไปยังโฮสต์ภายนอกผ่านพร็อกซีของ Nebo |
device:motion | ไจโรสโคปและมาตรความเร่งสำหรับหน้านี้เท่านั้น บน iPhone หน้าต้องเรียก DeviceMotionEvent.requestPermission() จากการแตะด้วย |
ทุกสิทธิ์อยู่ในรูป prefix:scope ขอเท่าที่แอปจำเป็นต้องใช้
เต็มหน้าจอ การวางแนว และการเอียง
เกมและภาพยนตร์ใช้ทั้งหน้าจอได้ ตั้งค่า fullscreen และสำหรับแอปมือถือ ตั้งค่า orientation: portrait (ค่าเริ่มต้น), landscape หรือ any การวางแนวอื่นจะถูกปฏิเสธเมื่อเขียน manifest
{
"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 x 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 ซึ่งเขียนโฟลเดอร์ manifest บุคลิก และหน้าในการเรียกครั้งเดียว แอปจะปรากฏในทีม AI ของเจ้าของภายในไม่กี่วินาที
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 ถามว่าพนักงานของตัวเองเป็นใคร แล้วพิมพ์คำตอบ หากแสดง id และชื่อของพนักงาน แสดงว่าเชื่อมต่อถูกต้อง
<!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 หา id ของแอปจากที่อยู่ของหน้า หน้าที่ให้บริการจากที่อื่นต้องมี <meta name="nebo-app-id" content="<id>"> เก็บสถานะไว้ใน storage ของแอป ไม่ใช่ในหน้า เพราะหน้าต่างปิดได้ แต่ storage ยังคงอยู่
หน้าให้บริการอย่างไร
- Nebo ให้บริการ
ui/ที่/apps/<id>/ui/และเปิดในหน้าต่างของตัวเอง - พาธที่ไม่มีไฟล์ตรงกันจะย้อนกลับไปที่
index.htmlการกำหนดเส้นทางฝั่งไคลเอนต์จึงทำงานได้ - หน้า HTML จะได้รับเมตาแท็ก
nebo-app-idและnebo-base-url - ทุกไฟล์ถูกส่งพร้อม content type จริง รวมถึงวิดีโอ เสียง ฟอนต์
wasmและโมเดล 3D (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
แอปที่เจ้าของสร้างเผยแพร่ตัวเองได้ เจ้าของพูดว่า “เผยแพร่ตัวเอง” หรือแตะ เผยแพร่ ในแชทของแอป บนหน้าจอของแอปในแอปมือถือ (ในแถบด้านบน หรือเป็นปุ่มข้างปุ่มปิดสำหรับแอปแบบเต็มหน้าจอ) หรือเลือก เผยแพร่แอปนี้… จากเมนูเดสก์ท็อป (เมนูไฟล์บน macOS ขณะที่หน้าต่างแอปอยู่ด้านหน้า หรือเมนูแอปของหน้าต่างแอปบน 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 | บุคลิกและ manifest ของรายการ |
agent.json | การกำหนดค่าของพนักงาน {} ก็ใช้ได้ |
manifest.json | เก็บไว้เป็น manifest ของแอป: หน้าต่างและสิทธิ์จะไปถึงแอปที่ติดตั้ง ต้องเป็น 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 และ การเผยแพร่