Le package
Une application est un package d'employé avec un manifest.json qui le désigne comme application et un dossier ui/ contenant la page.
<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"]
} | Champ | Signification |
|---|---|
type | "app". Fait de l'employé une application. Nebo lit aussi l'ancien artifact_type. |
id | Un UUID généré lors de la création de l'application. La page est servie à /apps/<id>/ui/. |
name, version | Le nom de l'employé et la version du package. |
window | title, width, height, resizable, fullscreen, orientation. Par défaut : 1024 × 768, redimensionnable, pas en plein écran, portrait, avec le nom de l'employé comme titre. |
permissions | Ce que la page peut faire. Par défaut ["storage:readwrite"]. |
Autorisations
| Autorisation | Accorde |
|---|---|
storage:readwrite | Le magasin clé-valeur de l'application. |
subagent:<employee-id> | Interroger un autre employé depuis la page. L'employé propre à l'application n'a besoin d'aucune autorisation. |
network:<host> ou network:* | Des requêtes vers des hôtes externes via le proxy de Nebo. |
device:motion | Le gyroscope et l'accéléromètre, pour cette page uniquement. Sur iPhone, la page appelle aussi DeviceMotionEvent.requestPermission() à partir d'un toucher. |
Chaque autorisation s'écrit prefix:scope. Demandez le strict nécessaire pour l'application.
Plein écran, orientation et inclinaison
Les jeux et les films peuvent occuper tout l'écran. Définissez fullscreen et, pour l'application mobile, une orientation : portrait (par défaut), landscape ou any. Toute autre orientation est refusée lors de l'écriture du manifeste.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Sur ordinateur, l'application s'ouvre dans une fenêtre en plein écran.
- Dans l'application mobile, il n'y a pas de barre d'application, les barres système sont masquées, l'écran reste allumé et le tirer-pour-actualiser est désactivé. Un petit bouton Fermer se trouve dans le coin supérieur gauche et s'estompe au bout de quelques secondes ; toucher le haut de l'écran le fait réapparaître. Le balayage depuis le bord est désactivé sur iOS, et le bouton Retour d'Android parcourt l'historique de la page avant de la fermer.
- Ajoutez des marges à la page avec
env(safe-area-inset-*)etviewport-fit=cover, et gardez les commandes à l'écart du coin supérieur gauche.
La commande vocale
Chaque application ouverte dans l'application de bureau Nebo ou dans l'application mobile affiche une petite commande vocale dans son coin inférieur droit, pour que le propriétaire puisse parler à l'employé de l'application pendant qu'il travaille sur la page. La commande se trouve en dehors de votre page : recharger la page ne coupe donc jamais l'appel.
- Sur ordinateur, c'est une barre d'environ 300 par 48 pixels, à 16 pixels du coin inférieur droit de la fenêtre.
- Dans l'application mobile, c'est un bouton rond de 48 points, dans la zone sûre, que le propriétaire peut faire glisser d'un côté ou de l'autre. Dans une application en plein écran, il se replie en ce bouton quelques secondes après le début d'un appel.
- Gardez les commandes importantes à l'écart du coin inférieur droit.
- Pendant une longue tâche au cours d'un appel, l'employé donne de brèves nouvelles comme « Modification en cours. » et ne lit jamais à voix haute les noms de fichiers ni les commandes.
Créer une application
Un employé peut créer une application de deux façons, et choisit selon ce que dit le propriétaire. « Crée-moi une application pour mes commandes » crée un nouvel employé application. « C'est toi l'application » ou « crée-toi un jeu » transforme en application l'employé auquel parle le propriétaire : il garde sa discussion, sa mémoire et son persona, et sa page se recharge pendant que le propriétaire lui parle. Cela fonctionne aussi pour un employé embauché en conversation. Quand ce que veut le propriétaire n'est pas clair, l'employé pose la question une fois.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Les outils du quotidien (un suivi, un formulaire, un petit tableau de bord) sont créés avec le skill d'application intégré à Nebo. Une page qui doit avoir l'air conçue plutôt que générée, comme une page d'accueil cinématographique, un film qui défile au scroll, de l'art génératif ou un jeu, est créée avec le skill App Studio de la boutique.
Pour une nouvelle application, le plus simple est de demander à un employé. Nebo inclut un skill intégré pour créer des applications, et l'employé utilise create_employee, qui écrit le dossier, le manifeste, le persona et la page en un seul appel. L'application apparaît dans l'effectif du propriétaire en quelques secondes.
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 accepte les mêmes arguments ui, app et agent_md. Un chemin dans ui remplace ce seul fichier. La page est lue sur le disque à chaque requête : recharger la fenêtre affiche donc la modification.
Une page minimale
Cette page charge le SDK, demande qui est son employé et affiche la réponse. Si elle affiche l'id et le nom de l'employé, le branchement est correct.
<!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> Le SDK trouve l'id de l'application à partir de l'adresse de la page. Une page servie depuis un autre endroit a besoin de <meta name="nebo-app-id" content="<id>">. Gardez l'état dans le stockage de l'application, pas dans la page : la fenêtre se ferme, le stockage demeure.
Comment la page est servie
- Nebo sert
ui/à/apps/<id>/ui/et l'ouvre dans sa propre fenêtre. - Un chemin sans fichier correspondant renvoie vers
index.html, ce qui permet le routage côté client. - Les pages HTML reçoivent les balises meta
nebo-app-idetnebo-base-url. - Chaque fichier est envoyé avec son vrai type de contenu, y compris la vidéo, le son, les polices,
wasmet les modèles 3D (glb,gltf). Un fichier dont l'extension est inconnue est envoyé enapplication/octet-streamet le navigateur ne l'utilisera pas. - Les fichiers répondent aux requêtes de plage (
206, ou416pour une plage au-delà de la fin), ce qui permet de naviguer dans la vidéo et le son. Dans l'app mobile, la vidéo se lit sur place sans toucher l'écran :<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Un fichier dont le nom contient une empreinte du contenu, comme
main-0a8ksftt.js, est mis en cache pendant un an. Tout le reste,index.htmlcompris, est vérifié à chaque ouverture et répond304s'il n'a pas changé. Générez des noms avec empreinte au moment du build plutôt que de renommer les fichiers à la main. - Chaque fichier de page peut peser au maximum 10 MB.
- Supprimer le dossier désactive l'employé ;
delete_employeele supprime entièrement.
Ajouter un sidecar
Lorsque la page a besoin d'une logique serveur, de ses propres données ou d'outils que l'employé peut appeler, ajoutez un sidecar : un binaire que Nebo exécute à côté de l'application. La page l'atteint avec neboFetch et un chemin relatif. Voir Sidecar d'application.
Publier depuis Nebo
Une application créée par le propriétaire peut se publier elle-même. Le propriétaire dit « publie-toi », ou touche Publier dans la discussion de l'application, sur l'écran de l'application dans l'application mobile (dans la barre du haut, ou sous forme de bouton à côté de Fermer pour une application en plein écran), ou choisit Publier cette application… dans le menu de l'application de bureau (le menu Fichier sur macOS lorsqu'une fenêtre d'application est au premier plan ; le menu App de la fenêtre de l'application sur Windows et Linux). L'employé rédige la fiche à partir de l'application, prend 3 à 5 captures d'écran et affiche la fiche dans la discussion pour qu'on la peaufine en parlant. Rien n'est envoyé tant que le propriétaire n'a pas répondu Soumettre pour examen sur la carte, d'un toucher ou à la voix.
Une application créée par le propriétaire dispose toujours de ses outils de développement pour elle-même : rechargement, état, console, captures d'écran et publication. Le mode Développeur d'applications (Paramètres du bot, Développeur) permet à d'autres employés de travailler sur n'importe quelle application du propriétaire, ajoute une console flottante à la page et désactive la mise en cache. Les applications installées depuis la boutique n'obtiennent jamais d'outils de développement ni de bouton Publier.
Publier une application vous-même
Une application composée d'une seule page se publie en un seul bundle avec l'outil agent. L'en-tête de AGENT.md doit indiquer artifact_type: app, sinon la boutique crée un simple employé sans page. Mettez entre guillemets toute valeur contenant deux-points suivis d'une espace ; sans guillemets, l'en-tête ne peut pas être lu et l'application devient discrètement un simple employé.
--- 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") | Dans le zip | Ce qui se passe |
|---|---|
AGENT.md | Le persona et le manifeste de la fiche. |
agent.json | La configuration de l'employé. {} suffit. |
manifest.json | Conservé comme manifeste de l'application : la fenêtre et les autorisations sont transmises à l'application installée. Doit être un JSON valide. |
ui/ | La page. Autorisés : html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, images (png, jpg, gif, svg, webp, avif, ico, bmp), polices (woff, woff2, ttf, otf), son (mp3, wav, ogg, m4a, aac, flac, opus), vidéo (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Les fichiers cachés et node_modules/ sont écartés. |
skills/<name>/ | Les skills propres à l'employé, vérifiés comme un skill téléversé seul : SKILL.md conservé, scripts/ et bin/ de tout type, tout le reste selon la liste autorisée des skills. |
- Limites : 10 MB par fichier et 50 MB par bundle. Un fichier de plus de 10 MB est ignoré (vérifiez
filesSkippedetuiFilesStoreddans le résultat) ; un bundle de plus de 50 MB est refusé. - Le jeton de téléversement est valable 5 minutes. Un dossier racine unique dans le zip est retiré.
- Pour une application privée ou réservée aux canaux, chaque téléversement reconstruit immédiatement le package installable, et Nebo avertit les bots qui ont installé l'application. Un bot en ligne met aussitôt en place le package reconstruit ; un bot hors ligne le fait à sa prochaine connexion. Vous n'avez pas besoin d'augmenter la version pour cela, et les paramètres, les planifications et les données du propriétaire pour l'application sont conservés. Les applications publiques, non référencées et sur invitation gardent leur package approuvé jusqu'à ce qu'une nouvelle version passe l'examen.
- Une nouvelle version suit le réglage de mises à jour automatiques de chaque propriétaire pour l'application. Il est désactivé tant que le propriétaire ne l'active pas : par défaut, le bot affiche « Mise à jour disponible » et le propriétaire l'applique depuis Paramètres, puis Mises à jour, ou depuis la Boîte de réception. Une mise à jour n'accorde jamais de nouvelles autorisations ; une autorisation ajoutée par la nouvelle version est demandée la première fois que l'application en a besoin.
- Si NeboAI retire une application de la boutique, chaque bot qui l'a installée la désactive et prévient le propriétaire. Rien n'est supprimé : tout ce que l'application a enregistré est conservé.
- Une application avec un sidecar téléverse plutôt le binaire de chaque plateforme avec
binary-token, et la page sous forme d'archiveui. Voir Sidecar d'application et Publication.