Paketti
Sovellus on työntekijäpaketti, jossa on sovellukseksi merkitsevä manifest.json ja ui/-kansio sivua varten.
<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"]
} | Kenttä | Merkitys |
|---|---|
type | "app". Tekee työntekijästä sovelluksen. Nebo lukee myös vanhemman kentän artifact_type. |
id | UUID, joka luodaan sovellusta luotaessa. Sivu tarjoillaan osoitteessa /apps/<id>/ui/. |
name, version | Työntekijän nimi ja paketin versio. |
window | title, width, height, resizable, fullscreen, orientation. Oletukset: 1024 × 768, koon muutos sallittu, ei koko näyttöä, pystysuunta, otsikkona työntekijän nimi. |
permissions | Mitä sivu saa tehdä. Oletus ["storage:readwrite"]. |
Luvat
| Lupa | Myöntää |
|---|---|
storage:readwrite | Sovelluksen avain-arvo-tallennuksen. |
subagent:<employee-id> | Toiselta työntekijältä kysymisen sivulta. Sovelluksen oma työntekijä ei tarvitse lupaa. |
network:<host> tai network:* | Pyynnöt ulkoisille palvelimille Nebon välityspalvelimen kautta. |
device:motion | Gyroskoopin ja kiihtyvyysanturin vain tälle sivulle. iPhonessa sivu kutsuu myös DeviceMotionEvent.requestPermission() napautuksesta. |
Jokainen lupa on muotoa prefix:scope. Pyydä vähintä, mitä sovellus tarvitsee.
Koko näyttö, suunta ja kallistus
Pelit ja elokuvat voivat käyttää koko näytön. Aseta fullscreen ja mobiilisovellusta varten orientation: portrait (oletus), landscape tai any. Muut suunnat hylätään, kun manifesti kirjoitetaan.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Tietokoneella sovellus avautuu koko näytön ikkunaan.
- Mobiilisovelluksessa ei ole sovelluspalkkia, järjestelmäpalkit ovat piilossa, näyttö pysyy päällä ja päivitys vetämällä on pois käytöstä. Pieni Sulje-painike on vasemmassa yläkulmassa ja himmenee muutaman sekunnin kuluttua; kosketus yläreunan lähellä tuo sen takaisin. iOS:n reunapyyhkäisy on pois käytöstä, ja Androidin takaisin-painike käy läpi sivun historian ennen sulkemista.
- Lisää sivulle reunukset arvoilla
env(safe-area-inset-*)javiewport-fit=coverja pidä säätimet poissa vasemmasta yläkulmasta.
Ääniohjain
Jokaisessa Nebon työpöytäsovelluksessa tai mobiilisovelluksessa avatussa sovelluksessa näkyy pieni ääniohjain oikeassa alakulmassa, jotta omistaja voi puhua sovelluksen työntekijälle sen työskennellessä sivulla. Ohjain on sivusi ulkopuolella, joten sivun uudelleenlataus ei koskaan katkaise puhelua.
- Tietokoneella se on noin 300 × 48 pikselin palkki, 16 pikselin päässä ikkunan oikeasta alakulmasta.
- Mobiilisovelluksessa se on pyöreä 48 pisteen painike turva-alueen sisällä, ja omistaja voi vetää sen kumpaan tahansa reunaan. Koko näytön sovelluksessa se pienenee takaisin painikkeeksi muutaman sekunnin kuluttua puhelun alkamisesta.
- Pidä tärkeät säätimet poissa oikeasta alakulmasta.
- Pitkän tehtävän aikana puhelussa työntekijä kertoo lyhyitä päivityksiä, kuten ”Muokkaan nyt.”, eikä koskaan lue ääneen tiedostonimiä tai komentoja.
Luo sovellus
Työntekijä voi rakentaa sovelluksen kahdella tavalla ja valitsee sen mukaan, mitä omistaja sanoo. ”Rakenna minulle sovellus tilauksiani varten” luo uuden sovellustyöntekijän. ”Sinä olet sovellus” tai ”rakenna itsestäsi peli” muuttaa työntekijän, jolle omistaja puhuu, sovellukseksi: se säilyttää chatinsa, muistinsa ja persoonansa, ja sen sivu latautuu uudelleen omistajan puhuessa sille. Tämä toimii myös keskustelussa palkatulle työntekijälle. Kun ei ole selvää, kumpaa omistaja tarkoittaa, työntekijä kysyy kerran.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Arkiset työkalut (seurantalista, lomake, pieni koontinäyttö) rakennetaan Nebon sisäänrakennetulla sovellustaidolla. Sivu, jonka pitäisi näyttää suunnitellulta eikä generoidulta, kuten elokuvamainen aloitussivu, vierityksen ohjaama elokuva, generoitu taide tai peli, rakennetaan kaupan App Studio -taidolla.
Uuden sovelluksen yksinkertaisin tapa on pyytää työntekijää. Nebossa on sisäänrakennettu taito sovellusten rakentamiseen, ja työntekijä käyttää create_employee-työkalua, joka kirjoittaa kansion, manifestin, persoonan ja sivun yhdellä kutsulla. Sovellus näkyy omistajan työvoimassa sekunneissa.
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 ottaa samat argumentit ui, app ja agent_md. Polku kentässä ui korvaa sen yhden tiedoston. Sivu luetaan levyltä jokaisella pyynnöllä, joten ikkunan uudelleenlataus näyttää muutoksen.
Minimaalinen sivu
Tämä sivu lataa SDK:n, kysyy, kuka sen työntekijä on, ja tulostaa vastauksen. Jos se näyttää työntekijän tunnuksen ja nimen, kytkennät ovat oikein.
<!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 löytää sovelluksen tunnuksen sivun osoitteesta. Muualta tarjoiltu sivu tarvitsee merkinnän <meta name="nebo-app-id" content="<id>">. Pidä tila sovelluksen tallennuksessa, ei sivulla: ikkuna sulkeutuu, mutta tallennus säilyy.
Miten sivu tarjoillaan
- Nebo tarjoilee hakemiston
ui/osoitteessa/apps/<id>/ui/ja avaa sen omaan ikkunaansa. - Polku, jolle ei löydy tiedostoa, palaa tiedostoon
index.html, joten asiakaspuolen reititys toimii. - HTML-sivut saavat metatagit
nebo-app-idjanebo-base-url. - Jokainen tiedosto lähetetään oikealla sisältötyypillään, mukaan lukien video, ääni, fontit,
wasmja 3D-mallit (glb,gltf). Tuntemattomalla tiedostopäätteellä varustettu tiedosto lähetetään tyyppinäapplication/octet-stream, eikä selain käytä sitä. - Tiedostot vastaavat alueeseen kohdistuviin pyyntöihin (
206, tai416, jos alue on lopun jälkeen), joten videota ja ääntä voi kelata. Mobiilisovelluksessa video toistuu paikallaan ilman napautusta:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Tiedosto, jonka nimessä on sisällön tiiviste, kuten
main-0a8ksftt.js, tallennetaan välimuistiin vuodeksi. Kaikki muu, myösindex.html, tarkistetaan jokaisella avauksella ja vastaa304, kun se ei ole muuttunut. Rakenna tiivisteellisillä nimillä äläkä nimeä tiedostoja uudelleen käsin. - Jokainen sivutiedosto voi olla enintään 10 MB.
- Kansion poistaminen poistaa työntekijän käytöstä;
delete_employeepoistaa sen kokonaan.
Lisää sivuvaunu
Kun sivu tarvitsee palvelinlogiikkaa, omaa dataa tai työkaluja, joita työntekijä voi kutsua, lisää sivuvaunu: binääri, jota Nebo ajaa sovelluksen rinnalla. Sivu tavoittaa sen neboFetch-kutsulla ja suhteellisella polulla. Katso Sovelluksen sivuvaunu.
Julkaise Nebosta
Omistajan tekemä sovellus voi julkaista itsensä. Omistaja sanoo ”julkaise itsesi” tai napauttaa Julkaise sovelluksen chatissa tai sovelluksen näkymässä mobiilisovelluksessa (yläpalkissa tai koko näytön sovelluksessa Sulje-painikkeen vieressä) tai valitsee työpöytävalikosta Julkaise tämä sovellus… (macOS:ssä File-valikko, kun sovellusikkuna on edessä; Windowsissa ja Linuxissa sovellusikkunan App-valikko). Työntekijä luonnostelee listauksen sovelluksesta, ottaa 3–5 kuvakaappausta ja näyttää listauksen chatissa muokattavaksi puhumalla. Mitään ei lähetetä ennen kuin omistaja vastaa kortilla Lähetä tarkistettavaksi napauttamalla tai äänellä.
Omistajan tekemällä sovelluksella on aina kehittäjätyökalunsa itselleen: uudelleenlataus, tila, konsoli, kuvakaappaukset ja julkaiseminen. Sovelluskehittäjätila (Botin asetukset, Kehittäjä) antaa muiden työntekijöiden työskennellä minkä tahansa omistajan sovelluksen parissa, lisää sivulle kelluvan konsolin ja poistaa välimuistin käytöstä. Kaupasta asennetut sovellukset eivät koskaan saa kehittäjätyökaluja tai Julkaise-painiketta.
Julkaise sovellus itse
Pelkästä sivusta koostuva sovellus julkaistaan yhtenä nippuna agent-työkalulla. AGENT.md-tiedoston etuosassa on oltava artifact_type: app, tai kauppa luo tavallisen työntekijän ilman sivua. Lainausmerkitse jokainen arvo, jossa on kaksoispiste ja sen perässä välilyönti; ilman lainausmerkkejä etuosaa ei voi lukea, ja sovelluksesta tulee huomaamatta tavallinen työntekijä.
--- 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-tiedostossa | Mitä tapahtuu |
|---|---|
AGENT.md | Persoona ja listauksen manifesti. |
agent.json | Työntekijän määritykset. {} kelpaa. |
manifest.json | Säilytetään sovelluksen manifestina: ikkuna ja luvat siirtyvät asennettuun sovellukseen. Oltava kelvollista JSONia. |
ui/ | Sivu. Sallitut: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, kuvat (png, jpg, gif, svg, webp, avif, ico, bmp), fontit (woff, woff2, ttf, otf), ääni (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Pistetiedostot ja node_modules/ jätetään pois. |
skills/<name>/ | Työntekijän omat taidot, tarkistettuina kuin erikseen ladattu taito: SKILL.md säilytetään, scripts/ ja bin/ mitä tahansa tyyppiä, kaikki muu taitojen sallittujen luettelon mukaan. |
- Rajat: 10 MB tiedostoa kohden ja 50 MB nippua kohden. Yli 10 MB:n tiedosto ohitetaan (tarkista tuloksesta
filesSkippedjauiFilesStored); yli 50 MB:n nippu hylätään. - Latausmerkki on voimassa 5 minuuttia. Zip-tiedoston yksittäinen ylätason kansio poistetaan.
- Yksityisessä tai vain kanaville tarkoitetussa sovelluksessa jokainen lataus rakentaa asennettavan paketin heti uudelleen, ja Nebo ilmoittaa siitä boteille, jotka ovat asentaneet sovelluksen. Verkossa oleva botti ottaa uudelleenrakennetun paketin käyttöön heti; verkon ulkopuolella oleva tekee sen, kun se seuraavan kerran yhdistää. Versiota ei tarvitse nostaa tätä varten, ja omistajan sovellusta koskevat asetukset, ajastukset ja data säilyvät. Julkiset, listaamattomat ja vain kutsulla saatavat sovellukset säilyttävät hyväksytyn pakettinsa, kunnes uusi versio läpäisee tarkistuksen.
- Uusi versio noudattaa kunkin omistajan sovelluskohtaista automaattisten päivitysten asetusta. Se on pois päältä, ellei omistaja ota sitä käyttöön, joten oletuksena botti näyttää ”Päivitys saatavilla”, ja omistaja asentaa sen kohdasta Asetukset ja sitten Päivitykset tai Saapuneet-kansiosta. Päivitys ei koskaan myönnä uusia lupia; uuden version lisäämää lupaa pyydetään, kun sovellus tarvitsee sitä ensimmäisen kerran.
- Jos NeboAI poistaa sovelluksen kaupasta, jokainen sen asentanut botti poistaa sen käytöstä ja ilmoittaa omistajalle. Mitään ei poisteta: kaikki, mitä sovellus tallensi, säilytetään.
- Sivuvaunullinen sovellus lataa sen sijaan kunkin alustan binäärin
binary-token-merkillä ja sivunui-arkistona. Katso Sovelluksen sivuvaunu ja Julkaiseminen.