NeboAI
NeboAI
Eñepyrũ

Aplicación-kuéra

Peteĩ aplicación ha'e peteĩ mba'apohára oguerekóva kuatiarogue. Jára oipe'a iventana ae-pe ohecha ha omba'apo hag̃ua peteĩ mba'e ndive voi: peteĩ tablero, peteĩ ñangarekoha, peteĩ formulario. Kuatiarogue ha'e HTML ha JavaScript hesakãva, ha oñe'ẽ Nebo ndive ha imba'apohára ndive peteĩ script rupive, App SDK.

Paquete

Peteĩ aplicación ha'e peteĩ mba'apohára paquete oguerekóva peteĩ manifest.json ohechaukáva aplicación ha'eha ha peteĩ carpeta ui/ kuatiarogue reheve.

<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"]
}
CampoHe'iséva
type"app". Omoambue mba'apohára aplicación-pe. Nebo omoñe'ẽ avei artifact_type tujavéva.
idPeteĩ UUID ojejapóva aplicación oñemopu'ã jave. Kuatiarogue oñeme'ẽ /apps/<id>/ui/-pe.
name, versionMba'apohára réra ha paquete versión.
windowtitle, width, height, resizable, fullscreen, orientation. Ijypyguáva: 1024 × 768, ikatúva oñemoambue tuichakue, ndaha'éi pantalla tuichakue, ijyvatéva, téra mba'apohára rérape.
permissionsMba'épa ikatu ojapo kuatiarogue. Ijypyguáva ["storage:readwrite"].

Permiso

PermisoOme'ẽ
storage:readwriteAplicación ñeñongatu llave-valor.
subagent:<employee-id>Ambue mba'apohárape ñeporandu kuatiaroguégui. Aplicación mba'apohára ae ndoikotevẽi permiso.
network:<host> térã network:*Jerure host okayguávape Nebo proxy rupive.
device:motionGiroscopio ha acelerómetro ko kuatiaroguépe g̃uarã añoite. iPhone-pe kuatiarogue ohenói avei DeviceMotionEvent.requestPermission() peteĩ jepokógui.

Opaite permiso ha'e prefix:scope. Ejerure pe michĩvéva aplicación oikotevẽva.

Pantalla tuichakue, orientación ha jepyrũ

Ñembosarái ha película ikatu ojagarra pantalla tuichakue. Emoĩ fullscreen ha, aplicación móvil-pe g̃uarã, peteĩ orientation: portrait (ijypyguáva), landscape térã any. Oimeraẽ ambue orientación oñemboyke manifiesto ojehai jave.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Escritorio-pe aplicación ojepe'a peteĩ ventana pantalla tuichakuépe.
  • Aplicación móvil-pe ndaipóri aplicación barra, sistema barra okañy, pantalla opyta ijurujáva ha pull to refresh ndomba'apói. Peteĩ votõ michĩ Emboty oĩ yvate asu gotyo ha okañy mbovy segundo rire; peteĩ jepoko yvate ykére ogueru jey. iOS jepoko pembe ndomba'apói, ha Android jevy votõ oguata kuatiarogue rembiasakue rupi omboty mboyve.
  • Emoĩ pa'ũ kuatiaroguépe env(safe-area-inset-*) ha viewport-fit=cover reheve, ha eñongatu control-kuéra yvate asu gotyo pa'ũgui.

Ñe'ẽ control

Opaite aplicación ojepe'áva Nebo escritorio aplicación-pe térã aplicación móvil-pe ohechauka peteĩ ñe'ẽ control michĩ iguýpe akatúa gotyo, jára ikatu hag̃uáicha oñe'ẽ aplicación mba'apohára ndive omba'apo aja kuatiaroguépe. Control oĩ nde kuatiarogue okápe, upévare kuatiarogue ñemyenyhẽ jey araka'eve noñembotýi ñehenói.

  • Escritorio-pe ha'e peteĩ barra 300 × 48 píxel rupi, 16 píxel ventana iguýpe akatúa gotyo pembe guive.
  • Aplicación móvil-pe ha'e peteĩ votõ apu'a 48 punto área segura ryepýpe jára ikatúva oguerova mokõive gotyo. Peteĩ aplicación pantalla tuichakuépe, ojevy upe votõme mbovy segundo ñehenói rire.
  • Eñongatu control iñimportánteva iguýpe akatúa gotyo pembe pa'ũgui.
  • Peteĩ tembiapo ipukúva aja ñehenóipe, mba'apohára he'i marandu mbyky ha'eháicha “Ko'ag̃a amoambuehína.” ha araka'eve nomoñe'ẽi hatãme archivo réra ni comando.

Emopu'ã peteĩ aplicación

Peteĩ mba'apohára ikatu omopu'ã peteĩ aplicación mokõi tape rupi, ha oiporavo pe jára he'ívare. “Emopu'ã chéve peteĩ aplicación che pedido-kuérape g̃uarã” omopu'ã peteĩ mba'apohára aplicación pyahu. “Nde ha'e pe aplicación” térã “emopu'ã ndejehegui peteĩ ñembosarái” omoambue mba'apohára jára oñe'ẽhápe aplicación-pe: oñongatu ichat, imandu'a ha iteko, ha ikuatiarogue ojemyenyhẽ jey jára oñe'ẽ aja hendive. Kóva omba'apo avei peteĩ mba'apohára ojekontratáva ñomongetápe. Ndahesakãiramo mávapa jára he'ise, mba'apohára oporandu peteĩ jey.

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

Tembiporu ára ha árape (peteĩ ñangarekoha, peteĩ formulario, peteĩ panel michĩ) ojejapo Nebo aplicación katupyry ijypyguáva reheve. Peteĩ kuatiarogue ojehechava'erã oñembosako'i porãháicha ndaha'éi ojejapo ijehegui, ha'eháicha peteĩ landing page cinematográfica, peteĩ película scroll rupi, arte ojejapóva térã peteĩ ñembosarái, ojejapo App Studio katupyry ñemuhágui reheve.

Peteĩ aplicación pyahúpe g̃uarã, tape ndahasyvéva ha'e eporandu peteĩ mba'apohárape. Nebo oguereko peteĩ katupyry ijypyguáva aplicación ñemopu'ãme g̃uarã, ha mba'apohára oipuru create_employee, ohaíva carpeta, manifiesto, teko ha kuatiarogue peteĩ ñehenóipe. Aplicación ojehecha jára mba'apoharakuérape mbovy segundo-pe.

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 ohupyty umi argumento voi ui, app ha agent_md. Peteĩ rape ui-pe omyengovia upe archivo añoite. Kuatiarogue oñemoñe'ẽ disco-gui opaite jerurépe, upévare ventana ñemyenyhẽ jey ohechauka ñemoambue.

Peteĩ kuatiarogue michĩvéva

Ko kuatiarogue omyenyhẽ SDK, oporandu máva ha'e imba'apohára ha ohechauka mbohovái. Ohechaukáramo mba'apohára id ha héra, ñembojoaju oĩ porã.

<!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 ojuhu aplicación id kuatiarogue rendaitégui. Peteĩ kuatiarogue oñeme'ẽva ambue hendágui oikotevẽ <meta name="nebo-app-id" content="<id>">. Eñongatu reko aplicación storage-pe, ndaha'éi kuatiaroguépe: ventana oñemboty, ha storage opyta.

Mba'éicha oñeme'ẽ kuatiarogue

  • Nebo ome'ẽ ui/ /apps/<id>/ui/-pe ha oipe'a iventana ae-pe.
  • Peteĩ rape ndoguerekóiva archivo ojojoguáva ojevy index.html-pe, upévare ñembohape cliente-pe omba'apo.
  • Kuatiarogue HTML ohupyty meta etiqueta nebo-app-id ha nebo-base-url.
  • Opaite archivo osẽ ijcontenido mba'eichagua añetegua reheve, oikehápe video, ñe'ẽpu, tai ra'ãnga, wasm ha modelo 3D (glb, gltf). Peteĩ archivo oguerekóva extensión ojeikuaa'ỹva oñemondo application/octet-stream ramo ha navegador noipurumo'ãi.
  • Umi archivo ombohovái range jerure (206, térã 416 peteĩ range ohasávape ipaha), upévare video ha pu ikatu oñemongu'e. Aplicación móvil-pe, video oñemboha'e upépe voi rejopy'ỹre: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • Peteĩ archivo héra oguerekóva contenido hash, ha'eháicha main-0a8ksftt.js, oñeñongatu caché-pe peteĩ ary. Opa ambue mba'e, index.html jepe, ojehecha opaite jepe'ápe ha ombohovái 304 noñemoambuéiramo. Emopu'ã téra hash reheve ndaha'éi remoambuévo archivo réra pópe.
  • Peteĩteĩ kuatiarogue archivo ikatu oguereko 10 MB peve.
  • Carpeta ñembogue omboguejy mba'apohára; delete_employee oipe'apa.

Embojoapy peteĩ sidecar

Kuatiarogue oikotevẽ jave servidor lógica, imarandu ae, térã tembiporu mba'apohára ikatúva ohenói, embojoapy peteĩ sidecar: peteĩ binario Nebo omboguatáva aplicación ykére. Kuatiarogue og̃uahẽ hese neboFetch ha peteĩ rape relativo reheve. Ehecha App Sidecar.

Emoherakuã Nebo-gui

Peteĩ aplicación jára ojapova'ekue ikatu omoherakuã ijehegui. Jára he'i “emoherakuã ndejehegui”, térã opoko Publish aplicación chat-pe, aplicación pantalla-pe aplicación móvil-pe (yvate barra-pe, térã peteĩ votõ Emboty ykére aplicación pantalla tuichakuépe g̃uarã), térã oiporavo Publish This App… escritorio menú-gui (File menú macOS-pe peteĩ aplicación ventana oĩ aja tenondépe; aplicación ventana App menú Windows ha Linux-pe). Mba'apohára ohai ñemoha'ãnga aplicación-gui, ojapo 3 guive 5 peve captura, ha ohechauka ñemoha'ãnga chat-pe oñemoha'ãnga hag̃ua oñe'ẽvo. Mba'eve noñemondói jára ombohovái peve Submit for review tarjeta-pe, opokóvo térã iñe'ẽ rupive.

Peteĩ aplicación jára ojapova'ekue oguereko akóinte programador tembiporu ijehegui g̃uarã: ñemyenyhẽ jey, reko, consola, captura ha ñemoherakuã. App Developer reko (Bot ñemboheko, Developer) ohejá ambue mba'apoharakuéra omba'apo oimeraẽ jára aplicación-pe, ombojoapy peteĩ consola ovevéva kuatiaroguépe ha omboguejy caché. Aplicación oñemoĩva ñemuhágui araka'eve ndohupytýi programador tembiporu ni votõ Publish.

Emoherakuã peteĩ aplicación nde voi

Peteĩ aplicación kuatiarogue añoitégui oñemoherakuã peteĩ bundle ramo tembiporu agent reheve. AGENT.md frontmatter he'iva'erã artifact_type: app, ndaupéichairõ ñemuha omopu'ã peteĩ mba'apohára jepiguáva kuatiarogue'ỹre. Emoĩ comilla oimeraẽ valor oguerekóvape dos puntos ha upéi peteĩ pa'ũ; comilla'ỹre, frontmatter ndaikatúi oñemoñe'ẽ ha aplicación oiko kirirĩháme peteĩ mba'apohára jepiguáva.

---
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-peMba'épa oiko
AGENT.mdTeko ha ñemoha'ãnga manifiesto.
agent.jsonMba'apohára ñemboheko. {} oĩ porã.
manifest.jsonOñeñongatu aplicación manifiesto ramo: ventana ha permiso og̃uahẽ aplicación oñemoĩvape. Ha'eva'erã JSON hekopegua.
ui/Kuatiarogue. Ojeguerohorýva: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, ta'ãnga (png, jpg, gif, svg, webp, avif, ico, bmp), tai ra'ãnga (woff, woff2, ttf, otf), ñe'ẽpu (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Archivo punto-gui oñepyrũva ha node_modules/ oñenohẽ.
skills/<name>/Mba'apohára katupyry ae, ojehesa'ỹijóva peteĩ katupyry ojejupíva ijeheguiicha: SKILL.md oñeñongatu, scripts/ ha bin/ oimeraẽ mba'eichagua, opa ambue mba'e katupyry lísta ojeguerohorývape.
  • Rapykuere: 10 MB peteĩteĩ archivo-pe ha 50 MB peteĩteĩ bundle-pe. Peteĩ archivo ohasáva 10 MB ndojeporúi (ehecha filesSkipped ha uiFilesStored tembiapopyrépe); peteĩ bundle ohasáva 50 MB oñemboyke.
  • Ñembojupi token opyta 5 minuto. Peteĩ carpeta yvategua añoite zip-pe oñenohẽ.
  • Peteĩ aplicación ñemi térã canal-kuérape añoitépe g̃uarã, opaite ñembojupi omopu'ã jey paquete ikatúva oñemoĩ pya'eterei ha Nebo omombe'u bot-kuéra omoĩva'ekuépe aplicación. Peteĩ bot oĩva ñandutípe omoĩ paquete pyahu pya'eterei; peteĩ ndaipóriva ñandutípe ojapo ojoaju jey vove. Ndereikotevẽi remopu'ã versión kóvape g̃uarã, ha jára ñemboheko, horario ha marandu aplicación-pe g̃uarã oñeñongatu. Aplicación opavavépe g̃uarã, ojehechauka'ỹva ha invitación-pe añoite oñongatu ipaquete oñemoneĩva peteĩ versión pyahu ohasa peve jehesa'ỹijo.
  • Peteĩ versión pyahu osegi peteĩteĩ jára ñembohekopyahu ijeheguíva ñemboheko aplicación-pe g̃uarã. Ndomba'apói jára omyendy'ỹramo, upévare ijypýpe bot ohechauka "Update available" ha jára omoĩ Ñemboheko-gui, upéi Updates, térã Ñe'ẽmondo oguahẽvagui. Peteĩ ñembohekopyahu araka'eve nome'ẽi permiso pyahu; peteĩ permiso versión pyahu ombojoapýva ojejerure aplicación oikotevẽ ypy jave.
  • NeboAI oipe'áramo peteĩ aplicación ñemuhágui, opaite bot omoĩva'ekue omboguejy ha omombe'u járape. Mba'eve noñemboguéi: opa mba'e aplicación oñongatuva'ekue opyta.
  • Peteĩ aplicación oguerekóva sidecar ombojupi peteĩteĩ plataforma binario binary-token reheve, kuatiarogue peteĩ archivo ui ramo. Ehecha App Sidecar ha Ñemoherakuã.