NeboAI
NeboAI
Loslegen

Apps

Eine App ist ein Mitarbeiter mit einer Seite. Inhaber öffnen sie in einem eigenen Fenster, um direkt etwas zu sehen und damit zu arbeiten: ein Board, einen Tracker, ein Formular. Die Seite besteht aus einfachem HTML und JavaScript und spricht über ein einziges Skript, das App SDK, mit Nebo und ihrem Mitarbeiter.

Das Paket

Eine App ist ein Mitarbeiterpaket mit einer manifest.json, die es als App kennzeichnet, und einem Ordner ui/ mit der Seite.

<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"]
}
FeldBedeutung
type"app". Macht den Mitarbeiter zu einer App. Nebo liest auch das ältere artifact_type.
idEine UUID, die beim Erstellen der App erzeugt wird. Die Seite wird unter /apps/<id>/ui/ bereitgestellt.
name, versionDer Name des Mitarbeiters und die Version des Pakets.
windowtitle, width, height, resizable, fullscreen, orientation. Standardwerte: 1024 × 768, in der Größe veränderbar, nicht im Vollbild, Hochformat, mit dem Namen des Mitarbeiters als Titel.
permissionsWas die Seite darf. Standard ["storage:readwrite"].

Berechtigungen

BerechtigungErlaubt
storage:readwriteDer Key-Value-Speicher der App.
subagent:<employee-id>Von der Seite aus einen anderen Mitarbeiter fragen. Der eigene Mitarbeiter der App braucht keine Berechtigung.
network:<host> oder network:*Anfragen an externe Hosts über Nebos Proxy.
device:motionGyroskop und Beschleunigungssensor nur für diese Seite. Auf dem iPhone ruft die Seite außerdem DeviceMotionEvent.requestPermission() nach einem Tippen auf.

Jede Berechtigung hat die Form prefix:scope. Fordere nur das Nötigste an, was die App braucht.

Vollbild, Ausrichtung und Neigung

Spiele und Filme können den ganzen Bildschirm nutzen. Setze fullscreen und, für die mobile App, eine orientation: portrait (Standard), landscape oder any. Jede andere Ausrichtung wird beim Schreiben des Manifests abgelehnt.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Auf dem Desktop öffnet sich die App in einem Vollbildfenster.
  • In der mobilen App gibt es keine App-Leiste, die Systemleisten sind ausgeblendet, der Bildschirm bleibt an und Ziehen zum Aktualisieren ist deaktiviert. Eine kleine Schließen-Schaltfläche sitzt in der oberen linken Ecke und blendet sich nach einigen Sekunden aus; eine Berührung nahe dem oberen Rand holt sie zurück. Die Randwischgeste von iOS ist deaktiviert, und die Zurück-Taste von Android geht erst den Verlauf der Seite durch, bevor sie schließt.
  • Polstere die Seite mit env(safe-area-inset-*) und viewport-fit=cover und halte Bedienelemente von der oberen linken Ecke fern.

Die Sprachsteuerung

Jede App, die in der Nebo-Desktop-App oder in der mobilen App geöffnet wird, zeigt in der unteren rechten Ecke eine kleine Sprachsteuerung, damit der Inhaber mit dem Mitarbeiter der App sprechen kann, während dieser an der Seite arbeitet. Die Steuerung liegt außerhalb deiner Seite, daher bricht ein Neuladen der Seite das Gespräch nie ab.

  • Auf dem Desktop ist sie eine Leiste von etwa 300 mal 48 Pixeln, 16 Pixel von der unteren rechten Ecke des Fensters entfernt.
  • In der mobilen App ist sie eine runde 48-Punkt-Schaltfläche innerhalb des sicheren Bereichs, die der Inhaber an beide Seiten ziehen kann. In einer Vollbild-App klappt sie wenige Sekunden nach Beginn eines Gesprächs wieder zu dieser Schaltfläche zusammen.
  • Halte wichtige Bedienelemente von der unteren rechten Ecke fern.
  • Bei einer langen Aufgabe während eines Gesprächs gibt der Mitarbeiter kurze Updates wie „Bearbeite jetzt.“ und liest nie Dateinamen oder Befehle vor.

Eine App erstellen

Ein Mitarbeiter kann eine App auf zwei Arten bauen und wählt danach, was der Inhaber sagt. „Bau mir eine App für meine Bestellungen“ erzeugt einen neuen App-Mitarbeiter. „Du bist die App“ oder „bau dir selbst ein Spiel“ macht den Mitarbeiter, mit dem der Inhaber spricht, zur App: Er behält seinen Chat, sein Gedächtnis und seine Persona, und seine Seite lädt neu, während der Inhaber mit ihm spricht. Das funktioniert auch bei einem Mitarbeiter, der im Gespräch eingestellt wurde. Wenn nicht klar ist, was der Inhaber meint, fragt der Mitarbeiter einmal nach.

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

Alltägliche Tools (ein Tracker, ein Formular, ein kleines Dashboard) werden mit Nebos integriertem App-Skill gebaut. Eine Seite, die gestaltet und nicht generiert aussehen soll, etwa eine cineastische Landingpage, ein scrollgesteuerter Film, generierte Kunst oder ein Spiel, wird mit dem App-Studio-Skill aus dem Marktplatz gebaut.

Für eine neue App ist es am einfachsten, einen Mitarbeiter darum zu bitten. Nebo enthält einen integrierten Skill zum Bauen von Apps, und der Mitarbeiter nutzt create_employee, das Ordner, Manifest, Persona und Seite in einem Aufruf schreibt. Die App erscheint innerhalb von Sekunden in der Belegschaft des Inhabers.

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 nimmt dieselben Argumente ui, app und agent_md. Ein Pfad in ui ersetzt genau diese eine Datei. Die Seite wird bei jeder Anfrage von der Festplatte gelesen, daher zeigt ein Neuladen des Fensters die Änderung.

Eine minimale Seite

Diese Seite lädt das SDK, fragt, wer ihr Mitarbeiter ist, und gibt die Antwort aus. Wenn sie die ID und den Namen des Mitarbeiters zeigt, stimmt die Verkabelung.

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

Das SDK ermittelt die App-ID aus der Adresse der Seite. Eine Seite, die von woanders bereitgestellt wird, braucht <meta name="nebo-app-id" content="<id>">. Halte den Zustand im Speicher der App, nicht in der Seite: Das Fenster wird geschlossen, der Speicher bleibt.

Wie die Seite bereitgestellt wird

  • Nebo stellt ui/ unter /apps/<id>/ui/ bereit und öffnet es in einem eigenen Fenster.
  • Ein Pfad ohne passende Datei fällt auf index.html zurück, sodass clientseitiges Routing funktioniert.
  • HTML-Seiten erhalten die Meta-Tags nebo-app-id und nebo-base-url.
  • Jede Datei wird mit ihrem echten Content-Type ausgeliefert, auch Video, Ton, Schriften, wasm und 3D-Modelle (glb, gltf). Eine Datei mit unbekannter Endung wird als application/octet-stream gesendet, und der Browser verwendet sie nicht.
  • Dateien beantworten Range-Anfragen (206 oder 416 für einen Bereich hinter dem Ende), sodass Video und Audio spulen können. In der mobilen App wird Video direkt an Ort und Stelle abgespielt, ohne Tippen: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • Eine Datei, deren Name einen Inhalts-Hash trägt, etwa main-0a8ksftt.js, wird ein Jahr lang zwischengespeichert. Alles andere, index.html eingeschlossen, wird bei jedem Öffnen geprüft und antwortet mit 304, wenn es unverändert ist. Baue mit gehashten Namen, statt Dateien von Hand umzubenennen.
  • Jede Seitendatei darf höchstens 10 MB groß sein.
  • Das Löschen des Ordners deaktiviert den Mitarbeiter; delete_employee entfernt ihn vollständig.

Einen Sidecar hinzufügen

Wenn die Seite Serverlogik, eigene Daten oder Tools braucht, die der Mitarbeiter aufrufen kann, füge einen Sidecar hinzu: eine Binärdatei, die Nebo neben der App ausführt. Die Seite erreicht ihn mit neboFetch und einem relativen Pfad. Siehe App-Sidecar.

Aus Nebo heraus veröffentlichen

Eine App, die der Inhaber erstellt hat, kann sich selbst veröffentlichen. Der Inhaber sagt „veröffentliche dich“, tippt im Chat der App auf Veröffentlichen, auf dem Bildschirm der App in der mobilen App (in der oberen Leiste oder, bei einer Vollbild-App, als Schaltfläche neben Schließen) oder wählt im Desktop-Menü Diese App veröffentlichen… (unter macOS im Menü Ablage, während ein App-Fenster im Vordergrund ist; unter Windows und Linux im App-Menü des App-Fensters). Der Mitarbeiter entwirft den Eintrag aus der App, macht 3 bis 5 Screenshots und zeigt den Eintrag im Chat, wo er sich im Gespräch formen lässt. Nichts wird gesendet, bis der Inhaber auf der Karte mit Zur Prüfung einreichen antwortet, per Tippen oder per Sprache.

Eine App, die der Inhaber erstellt hat, hat für sich selbst immer ihre Entwicklertools: Neuladen, Status, Konsole, Screenshots und Veröffentlichen. Der App-Entwicklermodus (Bot-Einstellungen, Entwickler) lässt andere Mitarbeiter an allen Apps des Inhabers arbeiten, fügt der Seite eine schwebende Konsole hinzu und schaltet das Caching ab. Apps, die aus dem Marktplatz installiert wurden, bekommen nie Entwicklertools oder eine Schaltfläche zum Veröffentlichen.

Eine App selbst veröffentlichen

Eine App, die nur aus einer Seite besteht, wird als ein Bundle mit dem Tool agent veröffentlicht. Das Frontmatter der AGENT.md muss artifact_type: app angeben, sonst erstellt der Marktplatz einen einfachen Mitarbeiter ohne Seite. Setze jeden Wert in Anführungszeichen, der einen Doppelpunkt gefolgt von einem Leerzeichen enthält; ohne Anführungszeichen kann das Frontmatter nicht gelesen werden, und die App wird stillschweigend zu einem einfachen Mitarbeiter.

---
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")
Im ZipWas passiert
AGENT.mdDie Persona und das Manifest des Eintrags.
agent.jsonDie Konfiguration des Mitarbeiters. {} reicht.
manifest.jsonBleibt als Manifest der App erhalten: Fenster und Berechtigungen gelangen in die installierte App. Muss gültiges JSON sein.
ui/Die Seite. Erlaubt: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, Bilder (png, jpg, gif, svg, webp, avif, ico, bmp), Schriften (woff, woff2, ttf, otf), Ton (mp3, wav, ogg, m4a, aac, flac, opus), Video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Dotfiles und node_modules/ werden verworfen.
skills/<name>/Die eigenen Skills des Mitarbeiters, geprüft wie ein einzeln hochgeladener Skill: SKILL.md bleibt erhalten, scripts/ und bin/ mit beliebigem Typ, alles andere gemäß der Skill-Positivliste.
  • Grenzen: 10 MB pro Datei und 50 MB pro Bundle. Eine Datei über 10 MB wird übersprungen (prüfe filesSkipped und uiFilesStored im Ergebnis); ein Bundle über 50 MB wird abgelehnt.
  • Das Upload-Token gilt 5 Minuten. Ein einzelner oberster Ordner im Zip wird entfernt.
  • Bei einer privaten oder nur für Kanäle freigegebenen App baut jeder Upload das installierbare Paket sofort neu, und Nebo benachrichtigt die Bots, die die App installiert haben. Ein Bot, der online ist, setzt das neu gebaute Paket sofort ein; einer, der offline ist, tut es bei der nächsten Verbindung. Dafür musst du die Version nicht erhöhen, und die Einstellungen, Zeitpläne und Daten des Inhabers für die App bleiben erhalten. Öffentliche, nicht gelistete und nur auf Einladung verfügbare Apps behalten ihr freigegebenes Paket, bis eine neue Version die Prüfung besteht.
  • Eine neue Version folgt der Einstellung für automatische Updates, die jeder Inhaber für die App hat. Sie ist aus, solange der Inhaber sie nicht einschaltet; standardmäßig zeigt der Bot also „Update verfügbar“, und der Inhaber spielt es über Einstellungen, dann Updates, oder über den Posteingang ein. Ein Update erteilt nie neue Berechtigungen; eine Berechtigung, die die neue Version hinzufügt, wird abgefragt, wenn die App sie zum ersten Mal braucht.
  • Wenn NeboAI eine App aus dem Marktplatz zurückzieht, schaltet jeder Bot, der sie installiert hat, sie ab und informiert den Inhaber. Nichts wird gelöscht: Alles, was die App gespeichert hat, bleibt erhalten.
  • Eine App mit Sidecar lädt stattdessen die Binärdatei jeder Plattform mit binary-token hoch und die Seite als ui-Archiv. Siehe App-Sidecar und Veröffentlichen.