Το πακέτο
Μια εφαρμογή είναι ένα πακέτο υπαλλήλου με ένα manifest.json που τη χαρακτηρίζει ως εφαρμογή και έναν φάκελο ui/ με τη σελίδα.
<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"]
} | Πεδίο | Σημασία |
|---|---|
type | "app". Κάνει τον υπάλληλο εφαρμογή. Το Nebo διαβάζει επίσης το παλαιότερο artifact_type. |
id | Ένα UUID που δημιουργείται όταν δημιουργείται η εφαρμογή. Η σελίδα σερβίρεται στο /apps/<id>/ui/. |
name, version | Το όνομα του υπαλλήλου και η έκδοση του πακέτου. |
window | title, width, height, resizable, fullscreen, orientation. Προεπιλογές: 1024 × 768, με αλλαγή μεγέθους, όχι πλήρης οθόνη, κατακόρυφος προσανατολισμός, με τίτλο το όνομα του υπαλλήλου. |
permissions | Τι επιτρέπεται να κάνει η σελίδα. Προεπιλογή ["storage:readwrite"]. |
Δικαιώματα
| Δικαίωμα | Παραχωρεί |
|---|---|
storage:readwrite | Ο χώρος αποθήκευσης κλειδιού-τιμής της εφαρμογής. |
subagent:<employee-id> | Ερώτηση σε άλλον υπάλληλο από τη σελίδα. Ο υπάλληλος της ίδιας της εφαρμογής δεν χρειάζεται δικαίωμα. |
network:<host> ή network:* | Αιτήματα προς εξωτερικούς hosts μέσω του διακομιστή μεσολάβησης του Nebo. |
device:motion | Το γυροσκόπιο και το επιταχυνσιόμετρο μόνο για αυτή τη σελίδα. Στο iPhone η σελίδα καλεί επίσης το DeviceMotionEvent.requestPermission() από ένα πάτημα. |
Κάθε δικαίωμα έχει τη μορφή prefix:scope. Ζητήστε το ελάχιστο που χρειάζεται η εφαρμογή.
Πλήρης οθόνη, προσανατολισμός και κλίση
Τα παιχνίδια και οι ταινίες μπορούν να καταλαμβάνουν όλη την οθόνη. Ορίστε το fullscreen και, για την εφαρμογή για κινητά, ένα orientation: portrait (η προεπιλογή), landscape ή any. Οποιοσδήποτε άλλος προσανατολισμός απορρίπτεται όταν γράφεται το manifest.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Στον υπολογιστή, η εφαρμογή ανοίγει σε παράθυρο πλήρους οθόνης.
- Στην εφαρμογή για κινητά δεν υπάρχει γραμμή εφαρμογής, οι γραμμές συστήματος κρύβονται, η οθόνη μένει αναμμένη και η ανανέωση με τράβηγμα είναι απενεργοποιημένη. Ένα μικρό κουμπί Κλείσιμο βρίσκεται στην πάνω αριστερή γωνία και σβήνει μετά από λίγα δευτερόλεπτα· ένα άγγιγμα κοντά στην κορυφή το επαναφέρει. Η χειρονομία σάρωσης από την άκρη στο iOS είναι απενεργοποιημένη και το κουμπί επιστροφής του Android διατρέχει το ιστορικό της σελίδας πριν κλείσει.
- Προσθέστε περιθώρια στη σελίδα με
env(safe-area-inset-*)καιviewport-fit=coverκαι κρατήστε τα στοιχεία ελέγχου μακριά από την πάνω αριστερή γωνία.
Το φωνητικό χειριστήριο
Κάθε εφαρμογή που ανοίγει στην εφαρμογή Nebo για υπολογιστή ή στην εφαρμογή για κινητά δείχνει ένα μικρό φωνητικό χειριστήριο στην κάτω δεξιά γωνία της, ώστε ο ιδιοκτήτης να μπορεί να μιλά με τον υπάλληλο της εφαρμογής ενώ αυτός δουλεύει στη σελίδα. Το χειριστήριο βρίσκεται έξω από τη σελίδα σας, οπότε η επαναφόρτωση της σελίδας δεν διακόπτει ποτέ την κλήση.
- Στον υπολογιστή είναι μια μπάρα περίπου 300 επί 48 pixel, 16 pixel μέσα από την κάτω δεξιά γωνία του παραθύρου.
- Στην εφαρμογή για κινητά είναι ένα στρογγυλό κουμπί 48 point μέσα στην ασφαλή περιοχή, που ο ιδιοκτήτης μπορεί να σύρει σε οποιαδήποτε πλευρά. Σε μια εφαρμογή πλήρους οθόνης συμπτύσσεται ξανά σε αυτό το κουμπί λίγα δευτερόλεπτα μετά την έναρξη μιας κλήσης.
- Κρατήστε τα σημαντικά στοιχεία ελέγχου μακριά από την κάτω δεξιά γωνία.
- Κατά τη διάρκεια μιας μεγάλης εργασίας σε κλήση, ο υπάλληλος λέει σύντομες ενημερώσεις όπως «Επεξεργάζομαι τώρα.» και δεν εκφωνεί ποτέ ονόματα αρχείων ή εντολές.
Δημιουργία εφαρμογής
Ένας υπάλληλος μπορεί να φτιάξει μια εφαρμογή με δύο τρόπους και επιλέγει ανάλογα με το τι λέει ο ιδιοκτήτης. Το «Φτιάξε μου μια εφαρμογή για τις παραγγελίες μου» δημιουργεί έναν νέο υπάλληλο-εφαρμογή. Το «Εσύ είσαι η εφαρμογή» ή το «φτιάξε στον εαυτό σου ένα παιχνίδι» μετατρέπει τον υπάλληλο με τον οποίο μιλά ο ιδιοκτήτης στην εφαρμογή: κρατά τη συνομιλία, τη μνήμη και την περσόνα του και η σελίδα του επαναφορτώνεται ενώ ο ιδιοκτήτης του μιλά. Αυτό λειτουργεί και για υπάλληλο που προσλήφθηκε μέσα στη συνομιλία. Όταν δεν είναι σαφές τι εννοεί ο ιδιοκτήτης, ο υπάλληλος ρωτά μία φορά.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Τα καθημερινά εργαλεία (ένα εργαλείο παρακολούθησης, μια φόρμα, ένας μικρός πίνακας ελέγχου) φτιάχνονται με την ενσωματωμένη δεξιότητα εφαρμογών του Nebo. Μια σελίδα που πρέπει να δείχνει σχεδιασμένη και όχι παραγόμενη, όπως μια κινηματογραφική σελίδα προορισμού, μια ταινία που προχωρά με την κύλιση, παραγόμενη τέχνη ή ένα παιχνίδι, φτιάχνεται με τη δεξιότητα App Studio από την αγορά.
Για μια νέα εφαρμογή, ο πιο απλός τρόπος είναι να το ζητήσετε από έναν υπάλληλο. Το Nebo περιλαμβάνει μια ενσωματωμένη δεξιότητα για τη δημιουργία εφαρμογών και ο υπάλληλος χρησιμοποιεί το create_employee, που γράφει τον φάκελο, το manifest, την περσόνα και τη σελίδα σε μία κλήση. Η εφαρμογή εμφανίζεται στην ομάδα εργασίας του ιδιοκτήτη μέσα σε δευτερόλεπτα.
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 δέχεται τα ίδια ορίσματα ui, app και agent_md. Μια διαδρομή στο ui αντικαθιστά εκείνο το ένα αρχείο. Η σελίδα διαβάζεται από τον δίσκο σε κάθε αίτημα, οπότε η επαναφόρτωση του παραθύρου δείχνει την αλλαγή.
Μια ελάχιστη σελίδα
Αυτή η σελίδα φορτώνει το SDK, ρωτά ποιος είναι ο υπάλληλός της και τυπώνει την απάντηση. Αν δείχνει το id και το όνομα του υπαλλήλου, η σύνδεση είναι σωστή.
<!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 βρίσκει το id της εφαρμογής από τη διεύθυνση της σελίδας. Μια σελίδα που σερβίρεται από οπουδήποτε αλλού χρειάζεται <meta name="nebo-app-id" content="<id>">. Κρατήστε την κατάσταση στο storage της εφαρμογής, όχι στη σελίδα: το παράθυρο κλείνει, ενώ το storage επιβιώνει.
Πώς σερβίρεται η σελίδα
- Το Nebo σερβίρει το
ui/στο/apps/<id>/ui/και το ανοίγει στο δικό του παράθυρο. - Μια διαδρομή χωρίς αντίστοιχο αρχείο καταλήγει στο
index.html, οπότε η δρομολόγηση στην πλευρά του πελάτη λειτουργεί. - Οι σελίδες HTML λαμβάνουν τις μετα-ετικέτες
nebo-app-idκαιnebo-base-url. - Κάθε αρχείο αποστέλλεται με τον πραγματικό τύπο περιεχομένου του, συμπεριλαμβανομένων βίντεο, ήχου, γραμματοσειρών,
wasmκαι τρισδιάστατων μοντέλων (glb,gltf). Ένα αρχείο με άγνωστη επέκταση αποστέλλεται ωςapplication/octet-streamκαι το πρόγραμμα περιήγησης δεν θα το χρησιμοποιήσει. - Τα αρχεία απαντούν σε αιτήματα εύρους (
206, ή416για εύρος πέρα από το τέλος), ώστε το βίντεο και ο ήχος να μπορούν να μετακινούνται. Στην εφαρμογή για κινητά, το βίντεο παίζει επιτόπου χωρίς πάτημα:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Ένα αρχείο του οποίου το όνομα περιέχει hash περιεχομένου, όπως το
main-0a8ksftt.js, αποθηκεύεται προσωρινά για έναν χρόνο. Όλα τα υπόλοιπα, μαζί και τοindex.html, ελέγχονται σε κάθε άνοιγμα και απαντούν304όταν δεν έχουν αλλάξει. Κάντε build με ονόματα που περιέχουν hash αντί να μετονομάζετε αρχεία χειροκίνητα. - Κάθε αρχείο σελίδας μπορεί να είναι το πολύ 10 MB.
- Η διαγραφή του φακέλου απενεργοποιεί τον υπάλληλο· το
delete_employeeτον αφαιρεί εντελώς.
Προσθήκη sidecar
Όταν η σελίδα χρειάζεται λογική διακομιστή, δικά της δεδομένα ή εργαλεία που μπορεί να καλεί ο υπάλληλος, προσθέστε ένα sidecar: ένα εκτελέσιμο που εκτελεί το Nebo δίπλα στην εφαρμογή. Η σελίδα φτάνει σε αυτό με το neboFetch και μια σχετική διαδρομή. Δείτε το Sidecar εφαρμογών.
Δημοσίευση από το Nebo
Μια εφαρμογή που έφτιαξε ο ιδιοκτήτης μπορεί να δημοσιεύσει τον εαυτό της. Ο ιδιοκτήτης λέει «δημοσίευσε τον εαυτό σου» ή πατά Δημοσίευση στη συνομιλία της εφαρμογής, στην οθόνη της εφαρμογής στην εφαρμογή για κινητά (στην πάνω γραμμή ή ως κουμπί δίπλα στο Κλείσιμο για εφαρμογή πλήρους οθόνης), ή επιλέγει Δημοσίευση αυτής της εφαρμογής… από το μενού του υπολογιστή (το μενού File στο macOS όταν ένα παράθυρο εφαρμογής είναι μπροστά· το μενού App του παραθύρου της εφαρμογής σε Windows και Linux). Ο υπάλληλος συντάσσει την καταχώριση από την εφαρμογή, τραβά 3 έως 5 στιγμιότυπα οθόνης και δείχνει την καταχώριση στη συνομιλία για να τη διαμορφώσετε μιλώντας. Τίποτα δεν αποστέλλεται μέχρι ο ιδιοκτήτης να απαντήσει Υποβολή για έλεγχο στην κάρτα, με πάτημα ή με φωνή.
Μια εφαρμογή που έφτιαξε ο ιδιοκτήτης έχει πάντα τα εργαλεία προγραμματιστή της για τον εαυτό της: επαναφόρτωση, κατάσταση, κονσόλα, στιγμιότυπα οθόνης και δημοσίευση. Η λειτουργία App Developer (Ρυθμίσεις bot, Developer) επιτρέπει σε άλλους υπαλλήλους να δουλεύουν σε οποιαδήποτε από τις εφαρμογές του ιδιοκτήτη, προσθέτει μια αιωρούμενη κονσόλα στη σελίδα και απενεργοποιεί την προσωρινή αποθήκευση. Οι εφαρμογές που εγκαθίστανται από την αγορά δεν αποκτούν ποτέ εργαλεία προγραμματιστή ή κουμπί Δημοσίευσης.
Δημοσιεύστε μια εφαρμογή μόνοι σας
Μια εφαρμογή μόνο με σελίδα δημοσιεύεται ως ένα πακέτο με το εργαλείο agent. Το frontmatter του AGENT.md πρέπει να λέει artifact_type: app, αλλιώς η αγορά δημιουργεί έναν απλό υπάλληλο χωρίς σελίδα. Βάλτε σε εισαγωγικά κάθε τιμή που περιέχει άνω και κάτω τελεία ακολουθούμενη από κενό· χωρίς εισαγωγικά, το frontmatter δεν μπορεί να διαβαστεί και η εφαρμογή γίνεται σιωπηλά ένας απλός υπάλληλος.
--- 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 | Τι συμβαίνει |
|---|---|
AGENT.md | Η περσόνα και το manifest της καταχώρισης. |
agent.json | Η διαμόρφωση του υπαλλήλου. Το {} είναι αποδεκτό. |
manifest.json | Διατηρείται ως το manifest της εφαρμογής: το παράθυρο και τα δικαιώματα φτάνουν στην εγκατεστημένη εφαρμογή. Πρέπει να είναι έγκυρο JSON. |
ui/ | Η σελίδα. Επιτρέπονται: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, εικόνες (png, jpg, gif, svg, webp, avif, ico, bmp), γραμματοσειρές (woff, woff2, ttf, otf), ήχος (mp3, wav, ogg, m4a, aac, flac, opus), βίντεο (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Τα αρχεία που ξεκινούν με τελεία και το node_modules/ απορρίπτονται. |
skills/<name>/ | Οι δεξιότητες του ίδιου του υπαλλήλου, ελεγμένες όπως μια δεξιότητα που ανεβαίνει μόνη της: το SKILL.md διατηρείται, τα scripts/ και bin/ οποιουδήποτε τύπου, όλα τα υπόλοιπα σύμφωνα με τη λίστα επιτρεπόμενων δεξιοτήτων. |
- Όρια: 10 MB ανά αρχείο και 50 MB ανά πακέτο. Ένα αρχείο πάνω από 10 MB παραλείπεται (ελέγξτε τα
filesSkippedκαιuiFilesStoredστο αποτέλεσμα)· ένα πακέτο πάνω από 50 MB απορρίπτεται. - Το token ανεβάσματος διαρκεί 5 λεπτά. Ένας μοναδικός ανώτατος φάκελος στο zip αφαιρείται.
- Για μια ιδιωτική εφαρμογή ή εφαρμογή μόνο για κανάλια, κάθε ανέβασμα ξαναφτιάχνει αμέσως το πακέτο εγκατάστασης και το Nebo ενημερώνει τα bot που εγκατέστησαν την εφαρμογή. Ένα bot που είναι σε σύνδεση τοποθετεί αμέσως το νέο πακέτο· ένα που είναι εκτός σύνδεσης το κάνει μόλις συνδεθεί ξανά. Δεν χρειάζεται να αυξήσετε την έκδοση γι' αυτό, και οι ρυθμίσεις, τα χρονοδιαγράμματα και τα δεδομένα του ιδιοκτήτη για την εφαρμογή διατηρούνται. Οι δημόσιες, μη καταχωρισμένες και μόνο με πρόσκληση εφαρμογές κρατούν το εγκεκριμένο πακέτο τους μέχρι μια νέα έκδοση να περάσει τον έλεγχο.
- Μια νέα έκδοση ακολουθεί τη ρύθμιση αυτόματων ενημερώσεων κάθε ιδιοκτήτη για την εφαρμογή. Είναι απενεργοποιημένη εκτός αν την ενεργοποιήσει ο ιδιοκτήτης, οπότε από προεπιλογή το bot δείχνει «Διαθέσιμη ενημέρωση» και ο ιδιοκτήτης την εφαρμόζει από τις Ρυθμίσεις και μετά τις Ενημερώσεις, ή από τα Εισερχόμενα. Μια ενημέρωση δεν παραχωρεί ποτέ νέα δικαιώματα· ένα δικαίωμα που προσθέτει η νέα έκδοση ζητείται όταν η εφαρμογή το χρειαστεί για πρώτη φορά.
- Αν η NeboAI αποσύρει μια εφαρμογή από την αγορά, κάθε bot που την εγκατέστησε την απενεργοποιεί και ενημερώνει τον ιδιοκτήτη. Τίποτα δεν διαγράφεται: όλα όσα αποθήκευσε η εφαρμογή διατηρούνται.
- Μια εφαρμογή με sidecar ανεβάζει αντί γι' αυτό το εκτελέσιμο κάθε πλατφόρμας με το
binary-tokenκαι τη σελίδα ως αρχείοui. Δείτε το Sidecar εφαρμογών και τη Δημοσίευση.