தொகுப்பு
ஒரு ஆப் என்பது, அதை ஆப் எனக் குறிக்கும் 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 | ஆப்பின் key-value சேமிப்பகம். |
subagent:<employee-id> | பக்கத்திலிருந்து வேறொரு பணியாளரிடம் கேட்டல். ஆப்பின் சொந்தப் பணியாளருக்கு அனுமதி தேவையில்லை. |
network:<host> அல்லது network:* | 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-ஐ ஏற்றி, தன் பணியாளர் யார் என்று கேட்டு, பதிலை அச்சிடுகிறது. அது பணியாளரின் 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>"> தேவை. நிலையைப் பக்கத்தில் அல்ல, ஆப்பின் சேமிப்பகத்தில் வையுங்கள்: சாளரம் மூடப்படும், சேமிப்பகம் நிலைத்திருக்கும்.
பக்கம் எப்படி வழங்கப்படுகிறது
- Nebo
ui/-ஐ/apps/<id>/ui/-இல் வழங்கி, அதைத் தனிச் சாளரத்தில் திறக்கிறது. - பொருந்தும் கோப்பு இல்லாத பாதை
index.html-க்குத் திரும்புகிறது, எனவே கிளையன்ட் பக்க வழிநடத்தல் வேலை செய்கிறது. - HTML பக்கங்கள்
nebo-app-idமற்றும்nebo-base-urlmeta குறிச்சொற்களைப் பெறுகின்றன. - வீடியோ, ஒலி, எழுத்துருக்கள்,
wasm, 3D மாடல்கள் (glb,gltf) உட்பட ஒவ்வொரு கோப்பும் அதன் உண்மையான உள்ளடக்க வகையுடன் அனுப்பப்படுகிறது. தெரியாத நீட்டிப்பு கொண்ட கோப்புapplication/octet-streamஆக அனுப்பப்படும், உலாவி அதைப் பயன்படுத்தாது. - கோப்புகள் range கோரிக்கைகளுக்குப் பதில் அளிக்கும் (
206, அல்லது முடிவைத் தாண்டிய range-க்கு416), எனவே வீடியோவையும் ஒலியையும் முன்னும் பின்னும் நகர்த்தலாம். மொபைல் ஆப்பில், வீடியோ தட்டாமலேயே அதே இடத்தில் இயங்கும்:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> main-0a8ksftt.jsபோலப் பெயரில் உள்ளடக்க hash கொண்ட கோப்பு ஒரு ஆண்டுக்குத் தற்காலிகமாகச் சேமிக்கப்படும்.index.htmlஉட்பட மற்ற அனைத்தும் ஒவ்வொரு திறப்பிலும் சரிபார்க்கப்பட்டு, மாறாதபோது304எனப் பதிலளிக்கும். கோப்புகளைக் கைமுறையாக மறுபெயரிடுவதற்குப் பதிலாக hash பெயர்களுடன் உருவாக்குங்கள்.- ஒவ்வொரு பக்கக் கோப்பும் அதிகபட்சம் 10 MB இருக்கலாம்.
- கோப்புறையை நீக்கினால் பணியாளர் செயலிழக்கும்;
delete_employeeஅதை முழுமையாக அகற்றுகிறது.
ஒரு sidecar-ஐச் சேருங்கள்
பக்கத்துக்குச் சர்வர் தர்க்கம், தனக்கென்று தரவு, அல்லது பணியாளர் அழைக்கக்கூடிய கருவிகள் தேவைப்படும்போது, ஒரு sidecar-ஐச் சேருங்கள்: ஆப்புக்கு அருகில் Nebo இயக்கும் ஒரு பைனரி. பக்கம் neboFetch மற்றும் சார்புப் பாதை மூலம் அதை அணுகுகிறது. App Sidecar பார்க்கவும்.
Nebo-விலிருந்து வெளியிடுங்கள்
உரிமையாளர் உருவாக்கிய ஆப் தன்னைத்தானே வெளியிட முடியும். உரிமையாளர் “உன்னை வெளியிடு” என்று சொல்கிறார், அல்லது ஆப்பின் அரட்டையில், மொபைல் ஆப்பில் ஆப்பின் திரையில் (மேல் பட்டியில், அல்லது முழுத்திரை ஆப்புக்கு மூடு என்பதன் அருகில் ஒரு பொத்தானாக) வெளியிடு என்பதைத் தட்டுகிறார், அல்லது டெஸ்க்டாப் மெனுவிலிருந்து இந்த ஆப்பை வெளியிடு… என்பதைத் தேர்ந்தெடுக்கிறார் (macOS-இல் ஆப் சாளரம் முன்னால் இருக்கும்போது File மெனு; Windows மற்றும் Linux-இல் ஆப் சாளரத்தின் App மெனு). பணியாளர் ஆப்பிலிருந்து பட்டியலை வரைந்து, 3 முதல் 5 திரைப்பிடிப்புகளை எடுத்து, பேசுவதன் மூலம் வடிவமைக்க அரட்டையில் பட்டியலைக் காட்டுகிறது. உரிமையாளர் கார்டில் தட்டியோ குரலாலோ மதிப்பாய்வுக்குச் சமர்ப்பி எனப் பதிலளிக்கும் வரை எதுவும் அனுப்பப்படாது.
உரிமையாளர் உருவாக்கிய ஆப்புக்கு எப்போதும் தனக்கான டெவலப்பர் கருவிகள் இருக்கும்: மீண்டும் ஏற்றுதல், நிலை, கன்சோல், திரைப்பிடிப்புகள், வெளியிடுதல். App Developer பயன்முறை (பாட் அமைப்புகள், டெவலப்பர்) பிற பணியாளர்கள் உரிமையாளரின் எந்த ஆப்பிலும் வேலை செய்ய அனுமதிக்கிறது, பக்கத்தில் மிதக்கும் கன்சோலைச் சேர்க்கிறது, தற்காலிகச் சேமிப்பை அணைக்கிறது. சந்தையிலிருந்து நிறுவப்பட்ட ஆப்களுக்கு டெவலப்பர் கருவிகளோ வெளியிடு பொத்தானோ ஒருபோதும் கிடைக்காது.
ஒரு ஆப்பை நீங்களே வெளியிடுங்கள்
பக்கம் மட்டுமே கொண்ட ஆப் agent கருவியுடன் ஒரே தொகுப்பாக வெளியிடப்படுகிறது. AGENT.md frontmatter 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 மற்றும் வெளியிடுதல் பார்க்கவும்.