NeboAI
NeboAI
Kom igång

Appar

En app är en medarbetare med en sida. Ägarna öppnar den i ett eget fönster för att se och arbeta med något direkt: en tavla, en uppföljning, ett formulär. Sidan är vanlig HTML och JavaScript, och den pratar med Nebo och med sin medarbetare via ett enda skript, App SDK.

Paketet

En app är ett medarbetarpaket med en manifest.json som markerar det som en app och en ui/-mapp med sidan.

<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"]
}
FältBetydelse
type"app". Gör medarbetaren till en app. Nebo läser även det äldre artifact_type.
idEtt UUID som skapas när appen skapas. Sidan serveras på /apps/<id>/ui/.
name, versionMedarbetarens namn och paketets version.
windowtitle, width, height, resizable, fullscreen, orientation. Standardvärden: 1024 × 768, storleksändringsbar, inte helskärm, stående, med medarbetarens namn som titel.
permissionsVad sidan får göra. Standard ["storage:readwrite"].

Behörigheter

BehörighetGer
storage:readwriteAppens nyckel-värde-lager.
subagent:<employee-id>Att fråga en annan medarbetare från sidan. Appens egen medarbetare behöver ingen behörighet.
network:<host> eller network:*Anrop till externa värdar via Nebos proxy.
device:motionGyroskopet och accelerometern, bara för den här sidan. På iPhone anropar sidan också DeviceMotionEvent.requestPermission() vid ett tryck.

Varje behörighet har formen prefix:scope. Be om så lite som appen behöver.

Helskärm, orientering och lutning

Spel och filmer kan ta hela skärmen. Ange fullscreen och, för mobilappen, en orientation: portrait (standard), landscape eller any. Alla andra orienteringar avvisas när manifestet skrivs.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • På datorn öppnas appen i ett helskärmsfönster.
  • I mobilappen finns inget appfält, systemfälten är dolda, skärmen hålls vaken och dra-för-att-uppdatera är avstängt. En liten Stäng-knapp sitter i det övre vänstra hörnet och tonas bort efter några sekunder; ett tryck nära överkanten tar fram den igen. Kantsvepet i iOS är avstängt, och Androids bakåtknapp går bakåt i sidans historik innan appen stängs.
  • Lägg utfyllnad på sidan med env(safe-area-inset-*) och viewport-fit=cover, och håll kontrollerna borta från det övre vänstra hörnet.

Röstkontrollen

Varje app som öppnas i Nebos datorapp eller i mobilappen visar en liten röstkontroll i det nedre högra hörnet, så att ägaren kan prata med appens medarbetare medan den arbetar med sidan. Kontrollen ligger utanför din sida, så att ladda om sidan bryter aldrig samtalet.

  • På datorn är den ett fält på ungefär 300 gånger 48 pixlar, 16 pixlar in från fönstrets nedre högra hörn.
  • I mobilappen är den en rund knapp på 48 punkter inom det säkra området som ägaren kan dra till någon av sidorna. I en helskärmsapp fälls den tillbaka till den knappen några sekunder in i ett samtal.
  • Håll viktiga kontroller borta från det nedre högra hörnet.
  • Under en lång uppgift i ett samtal säger medarbetaren korta uppdateringar som ”Redigerar nu.” och läser aldrig upp filnamn eller kommandon.

Skapa en app

En medarbetare kan bygga en app på två sätt och väljer utifrån vad ägaren säger. ”Bygg en app för mina beställningar” skapar en ny appmedarbetare. ”Du är appen” eller ”bygg ett spel av dig själv” gör den medarbetare som ägaren pratar med till appen: den behåller sin chatt, sitt minne och sin persona, och dess sida laddas om medan ägaren pratar med den. Det fungerar även för en medarbetare som anställts i en konversation. När det är oklart vad ägaren menar frågar medarbetaren en gång.

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

Vardagsverktyg (en uppföljning, ett formulär, en liten instrumentpanel) byggs med Nebos inbyggda appfärdighet. En sida som ska se designad ut snarare än genererad, till exempel en filmisk landningssida, en scrollstyrd film, genererad konst eller ett spel, byggs med färdigheten App Studio från marknadsplatsen.

För en ny app är det enklaste sättet att be en medarbetare. Nebo har en inbyggd färdighet för att bygga appar, och medarbetaren använder create_employee, som skriver mappen, manifestet, personan och sidan i ett enda anrop. Appen dyker upp i ägarens personalstyrka inom några sekunder.

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 tar samma argument ui, app och agent_md. En sökväg i ui ersätter just den filen. Sidan läses från disken vid varje anrop, så om du laddar om fönstret syns ändringen.

En minimal sida

Den här sidan läser in SDK:n, frågar vem dess medarbetare är och skriver ut svaret. Om den visar medarbetarens id och namn är kopplingen rätt.

<!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 hittar app-id:t från sidans adress. En sida som serveras från någon annanstans behöver <meta name="nebo-app-id" content="<id>">. Spara tillståndet i appens lagring, inte på sidan: fönstret stängs, men lagringen finns kvar.

Så serveras sidan

  • Nebo serverar ui/ på /apps/<id>/ui/ och öppnar den i ett eget fönster.
  • En sökväg utan matchande fil faller tillbaka på index.html, så routning på klientsidan fungerar.
  • HTML-sidor får metataggarna nebo-app-id och nebo-base-url.
  • Varje fil skickas med sin riktiga innehållstyp, inklusive video, ljud, typsnitt, wasm och 3D-modeller (glb, gltf). En fil med okänt filändelse skickas som application/octet-stream, och webbläsaren använder den inte.
  • Filer svarar på intervallförfrågningar (206, eller 416 för ett intervall bortom slutet), så att video och ljud kan spolas. I mobilappen spelas video upp på plats utan att man behöver trycka: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • En fil vars namn innehåller en innehållshash, till exempel main-0a8ksftt.js, cachelagras i ett år. Allt annat, inklusive index.html, kontrolleras vid varje öppning och svarar 304 om det är oförändrat. Bygg med hashade namn i stället för att döpa om filer för hand.
  • Varje sidfil får vara högst 10 MB.
  • Om du tar bort mappen inaktiveras medarbetaren; delete_employee tar bort den helt.

Lägg till en sidecar

När sidan behöver serverlogik, egen data eller verktyg som medarbetaren kan anropa lägger du till en sidecar: en binärfil som Nebo kör bredvid appen. Sidan når den med neboFetch och en relativ sökväg. Se App-sidecar.

Publicera från Nebo

En app som ägaren har skapat kan publicera sig själv. Ägaren säger ”publicera dig själv”, eller trycker på Publicera i appens chatt, på appens skärm i mobilappen (i det övre fältet, eller som en knapp bredvid Stäng i en helskärmsapp), eller väljer Publicera den här appen… i datorns meny (Arkiv-menyn på macOS när ett appfönster är i förgrunden; appfönstrets App-meny på Windows och Linux). Medarbetaren skriver ett utkast till annonsen utifrån appen, tar 3 till 5 skärmbilder och visar annonsen i chatten så att den kan formas genom samtal. Inget skickas förrän ägaren svarar Skicka in för granskning på kortet, med ett tryck eller med rösten.

En app som ägaren har skapat har alltid sina utvecklarverktyg för sig själv: ladda om, status, konsol, skärmbilder och publicering. Läget App Developer (Botinställningar, Utvecklare) låter andra medarbetare arbeta med alla ägarens appar, lägger till en flytande konsol på sidan och stänger av cachelagringen. Appar som installerats från marknadsplatsen får aldrig utvecklarverktyg eller en Publicera-knapp.

Publicera en app själv

En app som bara består av en sida publiceras som ett paket med verktyget agent. Frontmatter i AGENT.md måste ange artifact_type: app, annars skapar marknadsplatsen en vanlig medarbetare utan sida. Sätt citattecken runt alla värden som innehåller ett kolon följt av ett mellanslag; utan citattecken går frontmatter inte att läsa och appen blir i tysthet en vanlig medarbetare.

---
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")
I zip-filenVad som händer
AGENT.mdPersonan och annonsens manifest.
agent.jsonMedarbetarens konfiguration. {} går bra.
manifest.jsonBehålls som appens manifest: fönster och behörigheter följer med till den installerade appen. Måste vara giltig JSON.
ui/Sidan. Tillåtet: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, bilder (png, jpg, gif, svg, webp, avif, ico, bmp), typsnitt (woff, woff2, ttf, otf), ljud (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Punktfiler och node_modules/ tas bort.
skills/<name>/Medarbetarens egna färdigheter, kontrollerade som en färdighet som laddas upp separat: SKILL.md behålls, scripts/ och bin/ får innehålla alla typer, allt annat enligt färdigheternas tillåtelselista.
  • Gränser: 10 MB per fil och 50 MB per paket. En fil över 10 MB hoppas över (kontrollera filesSkipped och uiFilesStored i resultatet); ett paket över 50 MB avvisas.
  • Uppladdningstoken gäller i 5 minuter. En enskild toppmapp i zip-filen tas bort.
  • För en privat app eller en app som bara gäller kanaler bygger varje uppladdning om det installerbara paketet direkt, och Nebo meddelar de bottar som har installerat appen. En bot som är online lägger det ombyggda paketet på plats direkt; en som är offline gör det nästa gång den ansluter. Du behöver inte höja versionen för detta, och ägarens inställningar, scheman och data för appen behålls. Offentliga, olistade appar och appar som kräver inbjudan behåller sitt godkända paket tills en ny version har klarat granskningen.
  • En ny version följer varje ägares inställning för automatiska uppdateringar av appen. Den är avstängd om inte ägaren slår på den, så som standard visar boten ”Uppdatering tillgänglig” och ägaren installerar den från Inställningar, sedan Uppdateringar, eller från inkorgen. En uppdatering ger aldrig nya behörigheter; en behörighet som den nya versionen lägger till efterfrågas när appen först behöver den.
  • Om NeboAI drar tillbaka en app från marknadsplatsen stänger varje bot som har installerat den av den och meddelar ägaren. Inget tas bort: allt som appen har sparat behålls.
  • En app med en sidecar laddar i stället upp varje plattforms binärfil med binary-token, och sidan som ett ui-arkiv. Se App-sidecar och Publicering.