NeboAI
NeboAI
Bẹ̀rẹ̀

Àwọn áàpù

Áàpù kan jẹ́ òṣìṣẹ́ kan pẹ̀lú ojú-ìwé kan. Àwọn olùní ń ṣí i nínú fèrèsé tirẹ̀ láti rí nǹkan kan àti láti bá a ṣiṣẹ́ tààrà: pátákó kan, olùtọpa kan, fọ́ọ̀mù kan. Ojú-ìwé náà jẹ́ HTML àti JavaScript lásán, ó sì ń bá Nebo àti òṣìṣẹ́ rẹ̀ sọ̀rọ̀ nípasẹ̀ script kan, App SDK.

Àpò náà

Áàpù kan jẹ́ àpò òṣìṣẹ́ pẹ̀lú manifest.json tí ó ń sàmì sí i gẹ́gẹ́ bí áàpù àti fódà ui/ pẹ̀lú ojú-ìwé náà.

<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"]
}
PápáÌtumọ̀
type"app". Ó ń sọ òṣìṣẹ́ náà di áàpù. Nebo tún ń ka artifact_type àtijọ́.
idUUID tí a ṣẹ̀dá nígbà tí a ṣẹ̀dá áàpù náà. A ń pèsè ojú-ìwé náà ní /apps/<id>/ui/.
name, versionOrúkọ òṣìṣẹ́ náà àti ẹ̀dà àpò náà.
windowtitle, width, height, resizable, fullscreen, orientation. Àwọn ìpìlẹ̀: 1024 × 768, ó ṣeé yí ìwọ̀n padà, kì í ṣe ojú-ìwé kíkún, ìdúró gígùn, orúkọ rẹ̀ ni ti òṣìṣẹ́ náà.
permissionsOhun tí ojú-ìwé náà lè ṣe. Ìpìlẹ̀ ["storage:readwrite"].

Àwọn àṣẹ

ÀṣẹOhun tí ó ń fún ni
storage:readwriteIbi ìpamọ́ kọ́kọ́rọ́-iye áàpù náà.
subagent:<employee-id>Bíbéèrè lọ́wọ́ òṣìṣẹ́ míì láti ojú-ìwé. Òṣìṣẹ́ áàpù náà fúnra rẹ̀ kò nílò àṣẹ kankan.
network:<host> tàbí network:*Àwọn ìbéèrè sí àwọn host òde nípasẹ̀ proxy Nebo.
device:motionGyroscope àti accelerometer fún ojú-ìwé yìí nìkan. Lórí iPhone, ojú-ìwé náà tún ń pe DeviceMotionEvent.requestPermission() láti inú títẹ̀ kan.

Gbogbo àṣẹ jẹ́ prefix:scope. Béèrè èyí tí ó kéré jù tí áàpù náà nílò.

Ojú-ìwé kíkún, ìdúró àti ìtẹ̀

Àwọn eré àti fíìmù lè gba gbogbo ojú-ìwé. Ṣètò fullscreen àti, fún áàpù fóònù, orientation kan: portrait (ìpìlẹ̀), landscape tàbí any. A ń kọ ìdúró míì èyíkéyìí nígbà tí a bá ń kọ manifest náà.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Lórí kọ̀ǹpútà, áàpù náà ń ṣí nínú fèrèsé tí ó gba gbogbo ojú-ìwé.
  • Nínú áàpù fóònù, kò sí ọ̀pá áàpù, a fi àwọn ọ̀pá ètò pamọ́, ojú-ìwé ń wà ní títàn, fífà láti sọ dọ̀tun sì wà ní pípa. Bọ́tìnnì Pa á dé kékeré kan wà ní igun òkè-òsì, ó sì ń pòórá lẹ́yìn ìṣẹ́jú-àáyá díẹ̀; fífọwọ́kan nítòsí òkè ń mú un padà. Fífà láti etí ti iOS wà ní pípa, bọ́tìnnì ẹ̀yìn Android sì ń rìn padà nínú ìtàn ojú-ìwé náà kí ó tó pa á dé.
  • Fi ààyè sí ojú-ìwé náà pẹ̀lú env(safe-area-inset-*) àti viewport-fit=cover, kí o sì pa àwọn ìṣàkóso mọ́ kúrò ní igun òkè-òsì.

Ìṣàkóso ohùn

Gbogbo áàpù tí a ṣí nínú áàpù kọ̀ǹpútà Nebo tàbí nínú áàpù fóònù ń fi ìṣàkóso ohùn kékeré kan hàn ní igun ìsàlẹ̀-ọ̀tún rẹ̀, kí olùní lè bá òṣìṣẹ́ áàpù náà sọ̀rọ̀ nígbà tí ó ń ṣiṣẹ́ lórí ojú-ìwé náà. Ìṣàkóso náà wà lóde ojú-ìwé rẹ, nítorí náà títún ojú-ìwé gbé wọlé kì í já ìpè náà rárá.

  • Lórí kọ̀ǹpútà, ó jẹ́ ọ̀pá tí ó tó nǹkan bí 300 ní 48 pixel, 16 pixel sínú láti igun ìsàlẹ̀-ọ̀tún fèrèsé náà.
  • Nínú áàpù fóònù, ó jẹ́ bọ́tìnnì yíyípo 48-point nínú agbègbè àìléwu tí olùní lè fà sí ẹ̀gbẹ́ kọ̀ọ̀kan. Nínú áàpù tí ó gba gbogbo ojú-ìwé, ó ń ká padà sí bọ́tìnnì yẹn ní ìṣẹ́jú-àáyá díẹ̀ sínú ìpè.
  • Pa àwọn ìṣàkóso pàtàkì mọ́ kúrò ní igun ìsàlẹ̀-ọ̀tún.
  • Nígbà iṣẹ́ gígùn kan lórí ìpè, òṣìṣẹ́ náà ń sọ àwọn ìròyìn kúkúrú bí “Mo ń ṣàtúnṣe báyìí.”, kì í sì í ka orúkọ fáìlì tàbí àṣẹ jáde rárá.

Ṣẹ̀dá áàpù kan

Òṣìṣẹ́ kan lè kọ́ áàpù ní ọ̀nà méjì, ó sì ń yàn gẹ́gẹ́ bí ohun tí olùní sọ. “Kọ́ áàpù kan fún mi fún àwọn ìbéèrè ọjà mi” ń ṣẹ̀dá òṣìṣẹ́ áàpù tuntun. “Ìwọ ni áàpù náà” tàbí “kọ́ eré kan fún ara rẹ” ń sọ òṣìṣẹ́ tí olùní ń bá sọ̀rọ̀ di áàpù náà: ó ń pa ìjíròrò, ìrántí àti ìwà rẹ̀ mọ́, ojú-ìwé rẹ̀ sì ń tún wọlé nígbà tí olùní ń bá a sọ̀rọ̀. Èyí ń ṣiṣẹ́ fún òṣìṣẹ́ tí a gbà síṣẹ́ nínú ìjíròrò pẹ̀lú. Nígbà tí kò bá ṣe kedere èyí tí olùní ní lọ́kàn, òṣìṣẹ́ náà ń béèrè lẹ́ẹ̀kan.

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

A ń kọ́ àwọn irinṣẹ́ ojoojúmọ́ (olùtọpa, fọ́ọ̀mù, dashboard kékeré) pẹ̀lú ọgbọ́n áàpù tí a kọ́ sínú Nebo. Ojú-ìwé tí ó yẹ kí ó dà bí èyí tí a ṣe àpẹẹrẹ rẹ̀ dípò èyí tí a ṣẹ̀dá lásán, bí ojú-ìwé ìbalẹ̀ bí sinimá, fíìmù tí yíyí ń darí, iṣẹ́ ọnà tí a ṣẹ̀dá tàbí eré kan, ni a ń kọ́ pẹ̀lú ọgbọ́n App Studio láti ọjà.

Fún áàpù tuntun, ọ̀nà tí ó rọrùn jù ni láti béèrè lọ́wọ́ òṣìṣẹ́ kan. Nebo ní ọgbọ́n tí a kọ́ sínú rẹ̀ fún kíkọ́ áàpù, òṣìṣẹ́ náà sì ń lo create_employee, tí ó ń kọ fódà, manifest, ìwà àti ojú-ìwé náà nínú ìpè kan. Áàpù náà ń fara hàn nínú agbo òṣìṣẹ́ olùní láàárín ìṣẹ́jú-àáyá.

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 ń gba àwọn argument ui, app àti agent_md kan náà. Ọ̀nà kan nínú ui ń rọ́pò fáìlì kan yẹn. A ń ka ojú-ìwé náà láti disk ní gbogbo ìbéèrè, nítorí náà títún fèrèsé gbé wọlé ń fi ìyípadà náà hàn.

Ojú-ìwé tí ó kéré jù

Ojú-ìwé yìí ń gbé SDK wọlé, ó ń béèrè ẹni tí òṣìṣẹ́ rẹ̀ jẹ́, ó sì ń kọ ìdáhùn náà jáde. Bí ó bá fi id àti orúkọ òṣìṣẹ́ náà hàn, ìsopọ̀ náà tọ́.

<!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 náà ń rí id áàpù láti inú àdírẹ́sì ojú-ìwé náà. Ojú-ìwé tí a pèsè láti ibòmíì nílò <meta name="nebo-app-id" content="<id>">. Pa ipò mọ́ sínú storage áàpù náà, kì í ṣe nínú ojú-ìwé: fèrèsé náà ń pa dé, storage sì ń là á já.

Bí a ṣe ń pèsè ojú-ìwé náà

  • Nebo ń pèsè ui/ ní /apps/<id>/ui/, ó sì ń ṣí i nínú fèrèsé tirẹ̀.
  • Ọ̀nà tí kò ní fáìlì tí ó bá a mu ń padà sí index.html, nítorí náà ìdarí ẹ̀gbẹ́ oníbàárà ń ṣiṣẹ́.
  • Àwọn ojú-ìwé HTML ń gba àwọn meta tag nebo-app-id àti nebo-base-url.
  • Gbogbo fáìlì ń jáde pẹ̀lú irú àkóónú rẹ̀ gidi, títí kan fídíò, ohùn, fọ́ǹtì, wasm àti àwọn àwòṣe 3D (glb, gltf). A ń fi fáìlì tí ó ní àfikún orúkọ tí a kò mọ̀ ránṣẹ́ gẹ́gẹ́ bí application/octet-stream, aṣàwákiri kò sì ní lò ó.
  • Àwọn fáìlì máa ń dáhùn àwọn ìbéèrè range (206, tàbí 416 fún range tí ó kọjá òpin), kí fídíò àti ohùn lè fò síwájú tàbí sẹ́yìn. Nínú ìṣàfilọ́lẹ̀ orí fóònù, fídíò máa ń ṣiṣẹ́ níbẹ̀ gan-an láìsí títẹ̀: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • A ń fi fáìlì tí orúkọ rẹ̀ ní hash àkóónú, bí main-0a8ksftt.js, pamọ́ sínú cache fún ọdún kan. Gbogbo ohun míì, títí kan index.html, ni a ń ṣàyẹ̀wò ní gbogbo ìṣísílẹ̀, ó sì ń dáhùn 304 nígbà tí kò bá yí padà. Kọ́ ọ pẹ̀lú àwọn orúkọ oní-hash dípò yíyí orúkọ fáìlì padà fúnra rẹ.
  • Fáìlì ojú-ìwé kọ̀ọ̀kan kò lè ju 10 MB lọ.
  • Pípa fódà náà rẹ́ ń dá òṣìṣẹ́ náà dúró; delete_employee ń yọ ọ́ kúrò pátápátá.

Fi sidecar kún un

Nígbà tí ojú-ìwé náà bá nílò ìlànà sáfà, dátà tirẹ̀, tàbí àwọn irinṣẹ́ tí òṣìṣẹ́ náà lè pè, fi sidecar kún un: binary tí Nebo ń ṣiṣẹ́ lẹ́gbẹ̀ẹ́ áàpù náà. Ojú-ìwé náà ń dé ọ̀dọ̀ rẹ̀ pẹ̀lú neboFetch àti ọ̀nà ìbátan kan. Wo Sidecar áàpù.

Ṣe àtẹ̀jáde láti inú Nebo

Áàpù tí olùní ṣe lè ṣe àtẹ̀jáde ara rẹ̀. Olùní ń sọ pé “ṣe àtẹ̀jáde ara rẹ”, tàbí ó ń tẹ Ṣe àtẹ̀jáde nínú ìjíròrò áàpù náà, lórí ojú-ìwé áàpù náà nínú áàpù fóònù (nínú ọ̀pá òkè, tàbí gẹ́gẹ́ bí bọ́tìnnì lẹ́gbẹ̀ẹ́ Pa á dé fún áàpù tí ó gba gbogbo ojú-ìwé), tàbí ó ń yan Ṣe àtẹ̀jáde Áàpù Yìí… láti inú àtòjọ kọ̀ǹpútà (àtòjọ File lórí macOS nígbà tí fèrèsé áàpù kan wà níwájú; àtòjọ App fèrèsé áàpù lórí Windows àti Linux). Òṣìṣẹ́ náà ń kọ àkọ́pamọ́ àkọsílẹ̀ láti inú áàpù náà, ó ń ya àwòrán ojú-ìwé 3 sí 5, ó sì ń fi àkọsílẹ̀ náà hàn nínú ìjíròrò láti ṣe àtúnṣe rẹ̀ nípa sísọ̀rọ̀. A kò fi nǹkan kan ránṣẹ́ títí tí olùní yóò fi dáhùn Fi ránṣẹ́ fún àyẹ̀wò lórí káàdì náà, nípa títẹ̀ tàbí nípa ohùn.

Áàpù tí olùní ṣe máa ń ní àwọn irinṣẹ́ olùgbéejáde rẹ̀ fún ara rẹ̀ nígbà gbogbo: títún gbé wọlé, ipò, console, àwòrán ojú-ìwé àti ṣíṣe àtẹ̀jáde. Ipò App Developer (Ètò bot, Developer) ń jẹ́ kí àwọn òṣìṣẹ́ míì ṣiṣẹ́ lórí èyíkéyìí nínú àwọn áàpù olùní, ó ń fi console tí ń léfòó kún ojú-ìwé náà, ó sì ń pa cache. Àwọn áàpù tí a fi sórí ẹ̀rọ láti ọjà kì í gba àwọn irinṣẹ́ olùgbéejáde tàbí bọ́tìnnì Ṣe àtẹ̀jáde rárá.

Ṣe àtẹ̀jáde áàpù kan fúnra rẹ

Áàpù tí ó jẹ́ ojú-ìwé nìkan ń ṣe àtẹ̀jáde gẹ́gẹ́ bí àpapọ̀ kan pẹ̀lú irinṣẹ́ agent. Frontmatter AGENT.md gbọ́dọ̀ sọ artifact_type: app, bí bẹ́ẹ̀ kọ́ ọjà yóò ṣẹ̀dá òṣìṣẹ́ lásán tí kò ní ojú-ìwé. Fi àmì àyọlò sí iye èyíkéyìí tí ó ní colon tí àyè kan tẹ̀lé; láìsí àmì àyọlò, a kò lè ka frontmatter náà, áàpù náà yóò sì di òṣìṣẹ́ lásán láìsí ìkìlọ̀.

---
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")
Nínú zipOhun tí ó ń ṣẹlẹ̀
AGENT.mdÌwà náà àti manifest àkọsílẹ̀ náà.
agent.jsonÌṣètò òṣìṣẹ́ náà. {} dára.
manifest.jsonA pa á mọ́ gẹ́gẹ́ bí manifest áàpù náà: fèrèsé àti àwọn àṣẹ ń dé áàpù tí a fi sórí ẹ̀rọ. Ó gbọ́dọ̀ jẹ́ JSON tí ó tọ́.
ui/Ojú-ìwé náà. Tí a gbà láàyè: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, àwòrán (png, jpg, gif, svg, webp, avif, ico, bmp), fọ́ǹtì (woff, woff2, ttf, otf), ohùn (mp3, wav, ogg, m4a, aac, flac, opus), fídíò (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. A ń sọ àwọn fáìlì oní-àmì-ìdúró àti node_modules/ nù.
skills/<name>/Àwọn ọgbọ́n òṣìṣẹ́ náà fúnra rẹ̀, tí a ṣàyẹ̀wò bí ọgbọ́n tí a gbé sókè fúnra rẹ̀: a pa SKILL.md mọ́, scripts/ àti bin/ irú èyíkéyìí, gbogbo ohun míì lórí àtòjọ ìgbàláàyè ọgbọ́n.
  • Òdiwọ̀n: 10 MB fún fáìlì kọ̀ọ̀kan àti 50 MB fún àpapọ̀ kọ̀ọ̀kan. A ń fo fáìlì tí ó ju 10 MB lọ (ṣàyẹ̀wò filesSkipped àti uiFilesStored nínú àbájáde); a ń kọ àpapọ̀ tí ó ju 50 MB lọ.
  • Token ìgbésókè ń wà fún ìṣẹ́jú 5. A ń yọ fódà òkè kan ṣoṣo nínú zip kúrò.
  • Fún áàpù àdáni tàbí ti àwọn ìkànnì nìkan, gbogbo ìgbésókè ń tún àpò tí a lè fi sórí ẹ̀rọ kọ́ lẹ́sẹ̀kẹsẹ̀, Nebo sì ń sọ fún àwọn bot tí ó fi áàpù náà sórí ẹ̀rọ. Bot tí ó wà lórí ayélujára ń fi àpò tí a tún kọ́ sí ààyè rẹ̀ lẹ́sẹ̀kẹsẹ̀; èyí tí kò sí lórí ayélujára ń ṣe é nígbà tí ó bá tún sopọ̀. O kò nílò láti gbé ẹ̀dà sókè fún èyí, a sì ń pa àwọn ètò, ètò àkókò àti dátà olùní fún áàpù náà mọ́. Àwọn áàpù gbangba, àìṣàkọsílẹ̀ àti ti ìpè-nìkan ń pa àpò tí a fọwọ́ sí wọn mọ́ títí tí ẹ̀dà tuntun yóò fi yege nínú àyẹ̀wò.
  • Ẹ̀dà tuntun ń tẹ̀lé ètò àtúnṣe aládàáṣe olùní kọ̀ọ̀kan fún áàpù náà. Ó wà ní pípa àyàfi tí olùní bá tàn án, nítorí náà ní ìpìlẹ̀ bot náà ń fi "Àtúnṣe wà" hàn, olùní sì ń lò ó láti Ètò, lẹ́yìn náà Àwọn àtúnṣe, tàbí láti Àpótí ìránṣẹ́. Àtúnṣe kì í fúnni ní àṣẹ tuntun rárá; àṣẹ tí ẹ̀dà tuntun fi kún un ni a ń béèrè fún nígbà tí áàpù náà bá kọ́kọ́ nílò rẹ̀.
  • Bí NeboAI bá yọ áàpù kan kúrò nínú ọjà, gbogbo bot tí ó fi sórí ẹ̀rọ ń pa á, ó sì ń sọ fún olùní. A kò pa nǹkan kan rẹ́: a ń pa gbogbo ohun tí áàpù náà fi pamọ́ mọ́.
  • Áàpù tí ó ní sidecar ń gbé binary pẹpẹ kọ̀ọ̀kan sókè pẹ̀lú binary-token dípò, ojú-ìwé náà gẹ́gẹ́ bí àpò ui. Wo Sidecar áàpù àti Ṣíṣe àtẹ̀jáde.