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"]
} | Feld | Bedeutung |
|---|---|
type | "app". Macht den Mitarbeiter zu einer App. Nebo liest auch das ältere artifact_type. |
id | Eine UUID, die beim Erstellen der App erzeugt wird. Die Seite wird unter /apps/<id>/ui/ bereitgestellt. |
name, version | Der Name des Mitarbeiters und die Version des Pakets. |
window | title, 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. |
permissions | Was die Seite darf. Standard ["storage:readwrite"]. |
Berechtigungen
| Berechtigung | Erlaubt |
|---|---|
storage:readwrite | Der 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:motion | Gyroskop 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-*)undviewport-fit=coverund 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.htmlzurück, sodass clientseitiges Routing funktioniert. - HTML-Seiten erhalten die Meta-Tags
nebo-app-idundnebo-base-url. - Jede Datei wird mit ihrem echten Content-Type ausgeliefert, auch Video, Ton, Schriften,
wasmund 3D-Modelle (glb,gltf). Eine Datei mit unbekannter Endung wird alsapplication/octet-streamgesendet, und der Browser verwendet sie nicht. - Dateien beantworten Range-Anfragen (
206oder416fü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.htmleingeschlossen, wird bei jedem Öffnen geprüft und antwortet mit304, 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_employeeentfernt 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 Zip | Was passiert |
|---|---|
AGENT.md | Die Persona und das Manifest des Eintrags. |
agent.json | Die Konfiguration des Mitarbeiters. {} reicht. |
manifest.json | Bleibt 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
filesSkippedunduiFilesStoredim 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-tokenhoch und die Seite alsui-Archiv. Siehe App-Sidecar und Veröffentlichen.