NeboAI
NeboAI
Kezdés

Alkalmazások

Az alkalmazás egy munkatárs egy oldallal. A tulajdonosok saját ablakban nyitják meg, hogy közvetlenül lássanak valamit, és dolgozzanak vele: egy táblát, egy nyomkövetőt, egy űrlapot. Az oldal egyszerű HTML és JavaScript, és egyetlen szkripten, az App SDK-n keresztül beszél a Nebóval és a munkatársával.

A csomag

Az alkalmazás egy munkatárscsomag egy manifest.json fájllal, amely alkalmazásként jelöli, és egy ui/ mappával, amelyben az oldal van.

<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"]
}
MezőJelentés
type"app". Alkalmazássá teszi a munkatársat. A Nebo a régebbi artifact_type mezőt is olvassa.
idAz alkalmazás létrehozásakor kiosztott UUID. Az oldalt a /apps/<id>/ui/ címen szolgáljuk ki.
name, versionA munkatárs neve és a csomag verziója.
windowtitle, width, height, resizable, fullscreen, orientation. Alapértelmezések: 1024 × 768, átméretezhető, nem teljes képernyős, álló, a munkatárs nevével címezve.
permissionsMit tehet az oldal. Alapértelmezés: ["storage:readwrite"].

Engedélyek

EngedélyMit ad
storage:readwriteAz alkalmazás kulcs-érték tárolója.
subagent:<employee-id>Egy másik munkatárs megkérdezése az oldalról. Az alkalmazás saját munkatársához nem kell engedély.
network:<host> vagy network:*Kérések külső hosztokhoz a Nebo proxyján keresztül.
device:motionA giroszkóp és a gyorsulásmérő, csak ehhez az oldalhoz. iPhone-on az oldal egy koppintásra a DeviceMotionEvent.requestPermission() függvényt is meghívja.

Minden engedély prefix:scope formájú. A lehető legkevesebbet kérje, amire az alkalmazásnak szüksége van.

Teljes képernyő, tájolás és döntés

A játékok és filmek elfoglalhatják a teljes képernyőt. Állítsa be a fullscreen mezőt, és a mobilalkalmazáshoz egy orientation értéket: portrait (az alapértelmezés), landscape vagy any. Minden más tájolást elutasítunk a manifest írásakor.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Asztali gépen az alkalmazás teljes képernyős ablakban nyílik meg.
  • A mobilalkalmazásban nincs alkalmazássáv, a rendszersávok el vannak rejtve, a képernyő ébren marad, és a lehúzással frissítés ki van kapcsolva. A bal felső sarokban egy kis Bezárás gomb ül, amely néhány másodperc után elhalványul; a képernyő tetejének megérintése visszahozza. Az iOS széléről indított pöccintés ki van kapcsolva, az Android vissza gombja pedig bezárás előtt végiglépked az oldal előzményein.
  • Lássa el az oldalt env(safe-area-inset-*) és viewport-fit=cover margóval, és tartsa távol a vezérlőket a bal felső saroktól.

A hangvezérlő

Minden alkalmazás, amelyet a Nebo asztali alkalmazásában vagy a mobilalkalmazásban nyitnak meg, egy kis hangvezérlőt mutat a jobb alsó sarkában, hogy a tulajdonos beszélhessen az alkalmazás munkatársával, miközben az az oldalon dolgozik. A vezérlő az oldalon kívül helyezkedik el, így az oldal újratöltése soha nem bontja a hívást.

  • Asztali gépen ez egy nagyjából 300 × 48 pixeles sáv, az ablak jobb alsó sarkától 16 pixelre.
  • A mobilalkalmazásban ez egy 48 pontos kerek gomb a biztonságos területen belül, amelyet a tulajdonos bármelyik oldalra áthúzhat. Teljes képernyős alkalmazásban egy hívás kezdete után néhány másodperccel visszacsukódik erre a gombra.
  • Tartsa távol a fontos vezérlőket a jobb alsó saroktól.
  • Egy hívás közbeni hosszú feladat során a munkatárs rövid állapotjelentéseket mond, például „Most szerkesztek.”, és soha nem olvas fel fájlneveket vagy parancsokat.

Alkalmazás létrehozása

Egy munkatárs kétféleképpen építhet alkalmazást, és aszerint választ, amit a tulajdonos mond. Az „Építs nekem egy alkalmazást a rendeléseimhez” új alkalmazás-munkatársat hoz létre. A „Te vagy az alkalmazás” vagy az „építs magadból egy játékot” azt a munkatársat alakítja alkalmazássá, akivel a tulajdonos éppen beszél: megtartja a csevegését, a memóriáját és a személyiségét, az oldala pedig újratöltődik, miközben a tulajdonos beszél vele. Ez a beszélgetésben felvett munkatársakra is működik. Ha nem egyértelmű, melyikre gondol a tulajdonos, a munkatárs egyszer megkérdezi.

update_employee(
  name: "<the employee's own name>",
  app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
  ui: { "index.html": "<!doctype html>..." }
)

A mindennapi eszközök (nyomkövető, űrlap, kis irányítópult) a Nebo beépített alkalmazáskészségével készülnek. Az olyan oldal, amelynek tervezettnek, nem pedig generáltnak kell hatnia — például egy filmszerű nyitóoldal, egy görgetésre lejátszódó film, generált művészet vagy egy játék —, a piactérről elérhető App Studio készséggel készül.

Egy új alkalmazáshoz a legegyszerűbb, ha megkér egy munkatársat. A Nebo tartalmaz egy beépített készséget alkalmazások építéséhez, a munkatárs pedig a create_employee eszközt használja, amely egyetlen hívással megírja a mappát, a manifestet, a személyiséget és az oldalt. Az alkalmazás másodperceken belül megjelenik a tulajdonos munkaerejében.

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>..." }
)

Az update_employee ugyanazokat az ui, app és agent_md argumentumokat fogadja. Egy ui alatti elérési út csak azt az egy fájlt cseréli le. Az oldalt minden kérésnél a lemezről olvassuk, így az ablak újratöltése megmutatja a változást.

Egy minimális oldal

Ez az oldal betölti az SDK-t, megkérdezi, ki a munkatársa, és kiírja a választ. Ha megjelenik a munkatárs azonosítója és neve, a bekötés rendben van.

<!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>

Az SDK az oldal címéből állapítja meg az alkalmazás azonosítóját. A máshonnan kiszolgált oldalnak szüksége van erre: <meta name="nebo-app-id" content="<id>">. Az állapotot az alkalmazás tárhelyén tartsa, ne az oldalon: az ablak bezárul, a tárhely megmarad.

Hogyan szolgáljuk ki az oldalt

  • A Nebo a ui/ mappát a /apps/<id>/ui/ címen szolgálja ki, és saját ablakban nyitja meg.
  • Az olyan elérési út, amelyhez nincs fájl, az index.html fájlra esik vissza, így a kliensoldali útválasztás működik.
  • A HTML-oldalak nebo-app-id és nebo-base-url metacímkéket kapnak.
  • Minden fájl a valódi tartalomtípusával megy ki, beleértve a videót, a hangot, a betűtípusokat, a wasm fájlokat és a 3D-modelleket (glb, gltf). Az ismeretlen kiterjesztésű fájlt application/octet-stream típusként küldjük, és a böngésző nem fogja használni.
  • A fájlok válaszolnak a tartománykérésekre (206, illetve a végén túli tartomány esetén 416), így a videóban és a hangban lehet tekerni. A mobilalkalmazásban a videó koppintás nélkül, helyben lejátszódik: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • Az a fájl, amelynek a neve tartalomhasht hordoz, például main-0a8ksftt.js, egy évig gyorsítótárban marad. Minden mást, az index.html fájlt is beleértve, minden megnyitáskor ellenőrzünk, és változatlanság esetén 304 a válasz. Hash-elt nevekkel buildeljen, ne kézzel nevezze át a fájlokat.
  • Az oldal minden fájlja legfeljebb 10 MB lehet.
  • A mappa törlése deaktiválja a munkatársat; a delete_employee teljesen eltávolítja.

Sidecar hozzáadása

Ha az oldalnak szerveroldali logikára, saját adatokra vagy a munkatárs által hívható eszközökre van szüksége, adjon hozzá egy sidecart: egy binárist, amelyet a Nebo az alkalmazás mellett futtat. Az oldal a neboFetch függvénnyel és relatív elérési úttal éri el. Lásd: Alkalmazás-sidecar.

Közzététel a Nebóból

A tulajdonos által készített alkalmazás közzéteheti önmagát. A tulajdonos azt mondja: „tedd közzé magad”, vagy a Közzététel gombra koppint az alkalmazás csevegésében, a mobilalkalmazásban az alkalmazás képernyőjén (a felső sávban, vagy teljes képernyős alkalmazásnál a Bezárás melletti gombként), vagy az asztali menüből a Az alkalmazás közzététele… lehetőséget választja (macOS-en a Fájl menüben, amikor egy alkalmazásablak van elöl; Windowson és Linuxon az alkalmazásablak Alkalmazás menüjében). A munkatárs az alkalmazásból megírja a listaelem vázlatát, 3–5 képernyőképet készít, és megmutatja a listaelemet a csevegésben, hogy beszélgetéssel lehessen formálni. Semmit sem küld el, amíg a tulajdonos nem válaszol a kártyán a Beküldés ellenőrzésre lehetőséggel, koppintással vagy hangon.

A tulajdonos által készített alkalmazás saját maga számára mindig rendelkezik a fejlesztői eszközeivel: újratöltés, állapot, konzol, képernyőképek és közzététel. Az alkalmazásfejlesztői mód (Bot beállításai, Fejlesztő) lehetővé teszi, hogy más munkatársak is dolgozzanak a tulajdonos bármelyik alkalmazásán, lebegő konzolt ad az oldalhoz, és kikapcsolja a gyorsítótárazást. A piactérről telepített alkalmazások soha nem kapnak fejlesztői eszközöket vagy Közzététel gombot.

Alkalmazás közzététele saját kezűleg

A csak oldalból álló alkalmazás egyetlen csomagként jelenik meg az agent eszközzel. Az AGENT.md fejlécében szerepelnie kell az artifact_type: app értéknek, különben a piactér oldal nélküli, egyszerű munkatársat hoz létre. Tegyen idézőjelbe minden olyan értéket, amely kettőspontot és utána szóközt tartalmaz; idézőjel nélkül a fejléc nem olvasható, és az alkalmazás szó nélkül egyszerű munkatárssá válik.

---
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")
A zip-fájlbanMi történik
AGENT.mdA személyiség és a listaelem manifestje.
agent.jsonA munkatárs konfigurációja. A {} is megfelel.
manifest.jsonAz alkalmazás manifestjeként megmarad: az ablak- és engedélybeállítások eljutnak a telepített alkalmazáshoz. Érvényes JSON-nak kell lennie.
ui/Az oldal. Engedélyezett: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, képek (png, jpg, gif, svg, webp, avif, ico, bmp), betűtípusok (woff, woff2, ttf, otf), hang (mp3, wav, ogg, m4a, aac, flac, opus), videó (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. A ponttal kezdődő fájlokat és a node_modules/ mappát elhagyjuk.
skills/<name>/A munkatárs saját készségei, amelyeket ugyanúgy ellenőrzünk, mint egy önállóan feltöltött készséget: a SKILL.md megmarad, a scripts/ és a bin/ bármilyen típusú lehet, minden más a készségek engedélyezőlistája szerint.
  • Korlátok: fájlonként 10 MB, csomagonként 50 MB. A 10 MB-nál nagyobb fájlt kihagyjuk (ellenőrizze a filesSkipped és az uiFilesStored értéket az eredményben); az 50 MB-nál nagyobb csomagot elutasítjuk.
  • A feltöltési token 5 percig érvényes. A zip-fájlban lévő egyetlen legfelső mappát eltávolítjuk.
  • Privát vagy csak csatornákban elérhető alkalmazásnál minden feltöltés azonnal újraépíti a telepíthető csomagot, és a Nebo értesíti azokat a botokat, amelyek telepítették az alkalmazást. Az online bot azonnal a helyére teszi az újraépített csomagot; az offline bot a következő csatlakozáskor teszi meg. Ehhez nem kell emelnie a verziót, és a tulajdonos beállításai, ütemezései és az alkalmazás adatai megmaradnak. A nyilvános, nem listázott és csak meghívással elérhető alkalmazások a jóváhagyott csomagjukat tartják meg, amíg egy új verzió át nem megy az ellenőrzésen.
  • Az új verzió minden tulajdonosnál az adott alkalmazásra vonatkozó automatikus frissítési beállítást követi. Ez ki van kapcsolva, hacsak a tulajdonos be nem kapcsolja, így alapértelmezés szerint a bot „Frissítés érhető el” üzenetet mutat, és a tulajdonos a Beállítások, majd a Frissítések menüből vagy a Beérkezett mappából telepíti. A frissítés soha nem ad új engedélyeket; az új verzió által hozzáadott engedélyt akkor kérjük, amikor az alkalmazásnak először szüksége van rá.
  • Ha a NeboAI visszavon egy alkalmazást a piactérről, minden bot, amely telepítette, kikapcsolja, és értesíti a tulajdonost. Semmi sem törlődik: minden, amit az alkalmazás elmentett, megmarad.
  • A sidecarral rendelkező alkalmazás ehelyett a binary-token segítségével tölti fel minden platform binárisát, az oldalt pedig ui archívumként. Lásd: Alkalmazás-sidecar és Közzététel.