ప్యాకేజీ
యాప్ అంటే దాన్ని యాప్గా గుర్తించే 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. మ్యానిఫెస్ట్ రాసినప్పుడు ఇతర ఏ ఓరియంటేషన్ అయినా తిరస్కరించబడుతుంది.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - డెస్క్టాప్లో యాప్ పూర్తి-స్క్రీన్ విండోలో తెరుచుకుంటుంది.
- మొబైల్ యాప్లో యాప్ బార్ ఉండదు, సిస్టమ్ బార్లు దాచబడతాయి, స్క్రీన్ మెలకువగా ఉంటుంది, పుల్ టు రిఫ్రెష్ ఆఫ్లో ఉంటుంది. పై-ఎడమ మూలలో ఒక చిన్న మూసివేయి బటన్ ఉంటుంది, కొన్ని సెకన్ల తర్వాత మసకబారుతుంది; పైభాగానికి దగ్గరగా తాకితే అది తిరిగి వస్తుంది. iOS ఎడ్జ్ స్వైప్ ఆఫ్లో ఉంటుంది, Android బ్యాక్ బటన్ మూసివేయడానికి ముందు పేజీ చరిత్రలో వెనక్కి వెళ్తుంది.
- పేజీకి
env(safe-area-inset-*),viewport-fit=coverతో ప్యాడింగ్ ఇవ్వండి, నియంత్రణలను పై-ఎడమ మూలకు దూరంగా ఉంచండి.
వాయిస్ నియంత్రణ
Nebo డెస్క్టాప్ యాప్లో లేదా మొబైల్ యాప్లో తెరిచే ప్రతి యాప్ దాని కింది-కుడి మూలలో ఒక చిన్న వాయిస్ నియంత్రణను చూపిస్తుంది, కాబట్టి యాప్ ఉద్యోగి పేజీపై పని చేస్తున్నప్పుడు యజమాని వారితో మాట్లాడవచ్చు. నియంత్రణ మీ పేజీ బయట ఉంటుంది, కాబట్టి పేజీని రీలోడ్ చేసినా కాల్ ఎప్పుడూ కట్ అవ్వదు.
- డెస్క్టాప్లో అది విండో కింది-కుడి మూల నుండి 16 పిక్సెల్లు లోపల, సుమారు 300 బై 48 పిక్సెల్ల బార్.
- మొబైల్ యాప్లో అది సేఫ్ ఏరియా లోపల ఉండే 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>"> అవసరం. స్థితిని పేజీలో కాకుండా యాప్ storageలో ఉంచండి: విండో మూసుకుపోతుంది, storage నిలిచి ఉంటుంది.
పేజీ ఎలా అందించబడుతుంది
- Nebo
ui/ని/apps/<id>/ui/వద్ద అందించి దాని సొంత విండోలో తెరుస్తుంది. - సరిపోయే ఫైల్ లేని పాత్
index.htmlకి తిరిగి వెళ్తుంది, కాబట్టి క్లయింట్-సైడ్ రూటింగ్ పని చేస్తుంది. - HTML పేజీలకు
nebo-app-id,nebo-base-urlmeta ట్యాగ్లు వస్తాయి. - వీడియో, ధ్వని, ఫాంట్లు,
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వారిని పూర్తిగా తీసివేస్తుంది.
సైడ్కార్ను జోడించండి
పేజీకి సర్వర్ లాజిక్, సొంత డేటా, లేదా ఉద్యోగి పిలవగల టూల్స్ అవసరమైనప్పుడు, ఒక సైడ్కార్ను జోడించండి: Nebo యాప్ పక్కన నడిపే బైనరీ. పేజీ దాన్ని neboFetch, సాపేక్ష పాత్తో చేరుకుంటుంది. App సైడ్కార్ చూడండి.
Nebo నుండి ప్రచురించండి
యజమాని తయారు చేసిన యాప్ తనను తానే ప్రచురించుకోగలదు. యజమాని “నిన్ను నువ్వే ప్రచురించుకో” అని చెబుతారు, లేదా యాప్ చాట్లో, మొబైల్ యాప్లోని యాప్ స్క్రీన్పై (పై బార్లో, లేదా పూర్తి-స్క్రీన్ యాప్ కోసం మూసివేయి పక్కన ఉన్న బటన్గా) Publishపై ట్యాప్ చేస్తారు, లేదా డెస్క్టాప్ మెనూ నుండి Publish This App…ని ఎంచుకుంటారు (macOSలో యాప్ విండో ముందు ఉన్నప్పుడు File మెనూ; Windows, Linuxలో యాప్ విండో App మెనూ). ఉద్యోగి యాప్ నుండి లిస్టింగ్ను డ్రాఫ్ట్ చేసి, 3 నుండి 5 స్క్రీన్షాట్లు తీసి, మాట్లాడుతూ తీర్చిదిద్దడానికి లిస్టింగ్ను చాట్లో చూపిస్తారు. యజమాని కార్డ్పై ట్యాప్ లేదా వాయిస్ ద్వారా Submit for reviewకి సమాధానం ఇచ్చే వరకు ఏదీ పంపబడదు.
యజమాని తయారు చేసిన యాప్కు తన కోసం ఎల్లప్పుడూ డెవలపర్ టూల్స్ ఉంటాయి: రీలోడ్, స్థితి, కన్సోల్, స్క్రీన్షాట్లు, ప్రచురణ. App Developer మోడ్ (బాట్ సెట్టింగ్లు, Developer) ఇతర ఉద్యోగులు యజమాని యాప్లలో దేనిపైనైనా పని చేయడానికి అనుమతిస్తుంది, పేజీకి తేలియాడే కన్సోల్ను జోడిస్తుంది, కాషింగ్ను ఆఫ్ చేస్తుంది. మార్కెట్ప్లేస్ నుండి ఇన్స్టాల్ చేసిన యాప్లకు ఎప్పుడూ డెవలపర్ టూల్స్ లేదా Publish బటన్ రావు.
యాప్ను మీరే ప్రచురించండి
పేజీ మాత్రమే ఉన్న యాప్ agent టూల్తో ఒకే బండిల్గా ప్రచురించబడుతుంది. AGENT.md ఫ్రంట్మ్యాటర్లో artifact_type: app అని ఉండాలి, లేకపోతే మార్కెట్ప్లేస్ పేజీ లేని సాధారణ ఉద్యోగిని సృష్టిస్తుంది. కోలన్ తర్వాత స్పేస్ ఉన్న ఏ విలువనైనా కోట్లలో పెట్టండి; కోట్లు లేకపోతే, ఫ్రంట్మ్యాటర్ చదవబడదు, యాప్ నిశ్శబ్దంగా సాధారణ ఉద్యోగిగా మారుతుంది.
--- 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 మార్కెట్ప్లేస్ నుండి ఒక యాప్ను ఉపసంహరిస్తే, దాన్ని ఇన్స్టాల్ చేసిన ప్రతి బాట్ దాన్ని ఆఫ్ చేసి యజమానికి తెలియజేస్తుంది. ఏదీ తొలగించబడదు: యాప్ సేవ్ చేసిన ప్రతిదీ ఉంచబడుతుంది.
- సైడ్కార్ ఉన్న యాప్ దానికి బదులు ప్రతి ప్లాట్ఫామ్ బైనరీని
binary-tokenతో, పేజీనిuiఆర్కైవ్గా అప్లోడ్ చేస్తుంది. App సైడ్కార్, ప్రచురణ చూడండి.