Σύνδεση
Προσθέστε το https://neboai.com/mcp σε οποιονδήποτε πελάτη MCP που υποστηρίζει απομακρυσμένους διακομιστές. Ο πελάτης εντοπίζει τον διακομιστή εξουσιοδότησης, εγγράφεται και σας συνδέει με OAuth και PKCE. Οποιοσδήποτε λογαριασμός NeboAI μπορεί να συνδεθεί. Τα access tokens διαρκούν μία ώρα και ανανεώνονται για 30 ημέρες.
Λογαριασμός προγραμματιστή
Οποιοσδήποτε έχει λογαριασμό NeboAI μπορεί να δημοσιεύσει. Η υποβολή έκδοσης και το ανέβασμα αρχείων χρησιμοποιούν τον λογαριασμό προγραμματιστή σας, ο οποίος ρυθμίζεται για εσάς, δωρεάν, την πρώτη φορά που υποβάλλετε ή ζητάτε token ανεβάσματος. Δεν υπάρχει χρέωση ούτε βήμα έγκρισης.
Για να δημοσιεύσετε για μια ομάδα αντί για τον εαυτό σας, επιλέξτε τον λογαριασμό της ομάδας για τη συνεδρία. Πρέπει να είστε μέλος της ομάδας.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
Το developer μπορεί επίσης να ρυθμίσει τον λογαριασμό σας εκ των προτέρων (action: "create", προαιρετικό) και απαριθμεί και επιλέγει χώρους ονομάτων (resource: "namespace"). Ο επιλεγμένος χώρος ονομάτων γίνεται μέρος κάθε πλήρους ονόματος που δημοσιεύετε.
Εργαλεία
Τα εργαλεία skill, agent και plugin μοιράζονται ένα σύνολο ενεργειών. Οι εφαρμογές δημοσιεύονται με το εργαλείο agent.
| Ενέργεια | Λογαριασμός προγραμματιστή | Τι κάνει |
|---|---|---|
create | δεν χρειάζεται | Δημιουργεί το στοιχείο και τον κωδικό εγκατάστασής του. |
update | δεν χρειάζεται | Αλλάζει πεδία, περιεχόμενο, έκδοση ή ορατότητα. |
get, list, delete | δεν χρειάζεται | Διαβάζει ή αφαιρεί τα στοιχεία σας. |
install | δεν χρειάζεται | Εγκαθιστά σε ένα από τα bot σας: id, botId και cascade για να συμπεριληφθούν οι εξαρτήσεις. |
bundle-token | ρυθμίζεται αυτόματα | Ένα token για ανέβασμα ενός zip με αρχεία κειμένου. |
binary-token | ρυθμίζεται αυτόματα | Ένα token για ανέβασμα εκτελέσιμων, plugin.json, agent.json και UI εφαρμογών. |
list-binaries, delete-binary | ρυθμίζεται αυτόματα | Διαχειρίζεται τα εκτελέσιμα που έχουν ανέβει. |
submit | ρυθμίζεται αυτόματα | Υποβάλλει μια έκδοση για έλεγχο. |
| Πεδίο | Σημασία |
|---|---|
name | Εμφανιζόμενο όνομα. Το slug δημιουργείται από αυτό. |
description | Μία γραμμή, 10 έως 500 χαρακτήρες για υποβολή. |
manifestContent | Το κύριο αρχείο του στοιχείου: SKILL.md, AGENT.md ή PLUGIN.md. |
version | Σημασιολογική έκδοση. Προεπιλογή 0.1.0. |
visibility | private (προεπιλογή), loop (κοινόχρηστο με τα Κανάλια σας) ή public. |
category | Κατηγορία αγοράς. |
longDescription | Το κείμενο «Τι κάνει» της αγοράς (μόνο με update). |
sourceUrl, manifestUrl | Προαιρετικοί σύνδεσμοι. |
dependencies | Μόνο για υπαλλήλους. Βλ. Εξαρτήσεις. |
Το εργαλείο marketplace κάνει αναζήτηση στην αγορά και απαριθμεί κατηγορίες. Το εργαλείο pricing ορίζει τιμή σε ένα στοιχείο· τα στοιχεία επί πληρωμή απαιτούν ολοκλήρωση της ρύθμισης πληρωμών.
Δημοσίευση δεξιότητας
Δημιουργήστε τη δεξιότητα με το SKILL.md της ως περιεχόμενο.
skill(action: "create", name: "invoice-totals",
description: "Add up invoice line items, apply tax, and report the totals.",
category: "finance", version: "1.0.0", manifestContent: "<contents of SKILL.md>") Ονομάστε τη δεξιότητα με το name του frontmatter της. Το πλήρες όνομά της είναι @<namespace>/skills/<slug>, με το slug να δημιουργείται από το εμφανιζόμενο όνομα, και τα bot επιλύουν τα πλήρη ονόματα με βάση το name του frontmatter, οπότε τα δύο πρέπει να ταιριάζουν.
Αν η δεξιότητα έχει άλλα αρχεία, ανεβάστε τον φάκελο ως zip. Ένας μοναδικός φάκελος ανώτατου επιπέδου στο zip αφαιρείται αυτόματα και οι φάκελοι build και ελέγχου εκδόσεων παραλείπονται.
skill(action: "bundle-token", id: "<skill id>") cd invoice-totals && zip -r ../invoice-totals.zip . && cd .. curl -X POST "https://neboai.com/api/v1/skills/<skill id>/bundle" \ -H "Authorization: Bearer <token>" \ -F file=@invoice-totals.zip
| Κανόνας πακέτου | Όριο |
|---|---|
| Μέγεθος zip | 50 MB |
| Κάθε αρχείο | 10 MB |
| Όλα τα αρχεία | 50 MB |
| Τύποι αρχείων | Κείμενο, κώδικας, δεδομένα, εικόνες, PDF και γραμματοσειρές, όπως .md, .py, .js, .ts, .json, .yaml, .csv, .html. Οτιδήποτε στα scripts/, bin/ ή dist/ γίνεται δεκτό. |
| Διαδρομές | Χωρίς .. και χωρίς απόλυτες διαδρομές. |
Κάντε τη δεξιότητα δημόσια και υποβάλετε μια έκδοση.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Δημοσίευση υπαλλήλου
Δημιουργήστε τον υπάλληλο με το AGENT.md του ως περιεχόμενο και τις εξαρτήσεις του από την αγορά.
agent(action: "create", name: "Support Coordinator",
description: "Answers every customer message the day it arrives and escalates what it cannot settle.",
version: "1.0.0", manifestContent: "<contents of AGENT.md>",
dependencies: { skills: [ { qualifiedName: "@example-studio/skills/reply-drafting", id: "<skill id>", name: "reply-drafting" } ] }) Ανεβάστε το agent.json με ένα binary token. Οι υπάλληλοι δεν χρειάζονται εκτελέσιμο· το config αρκεί. Για να συμπεριλάβετε τον φάκελο skills/ του ίδιου του υπαλλήλου, ανεβάστε αντί γι' αυτό το πακέτο ως bundle: AGENT.md, agent.json και skills/ σε ένα zip.
agent(action: "binary-token", id: "<agent id>") curl -X POST "https://neboai.com/api/v1/developer/apps/<agent id>/binaries" \ -H "Authorization: Bearer <token>" \ -F config=@support-coordinator/agent.json
Κρατήστε τις εξαρτήσεις στο agent.json. Ένα agent.json που ανεβαίνει αντικαθιστά την αποθηκευμένη διαμόρφωση, συμπεριλαμβανομένων των εξαρτήσεων που ορίστηκαν με create ή update, και ένα update με dependencies αντικαθιστά το αποθηκευμένο agent.json. Όταν χρησιμοποιείτε και τα δύο, βάλτε το ίδιο αντικείμενο dependencies μέσα στο agent.json.
Εξαρτήσεις
Το dependencies έχει λίστες skills, agents και connectors. Κάθε καταχώριση είναι {qualifiedName, id, name}· το NeboAI ελέγχει πρώτα το qualified name και μετά το id. Ένα πρόσθετο καταχωρίζεται στο skills. Τα πρόσθετα που απαιτούνται από δεξιότητες που αναφέρονται στο agent.json προστίθενται αυτόματα. Όταν ένας κάτοχος εγκαθιστά τον υπάλληλό σας από την αγορά ή με τον κωδικό του, το bot εγκαθιστά μαζί του και τις εξαρτήσεις του σε δεξιότητες, πρόσθετα και υπαλλήλους.
Δημοσίευση πρόσθετου ή εφαρμογής
Τα πρόσθετα ανεβάζουν ένα εκτελέσιμο ανά πλατφόρμα μαζί με το plugin.json και τις δεξιότητες του πρόσθετου· δείτε τη Διάθεση πρόσθετου. Μια εφαρμογή μόνο με σελίδα δεν χρειάζεται εκτελέσιμο: ανεβάστε ένα bundle με bundle-token που περιέχει AGENT.md (με artifact_type: app), agent.json, manifest.json, ui/ και τυχόν skills/. Μια εφαρμογή με sidecar χρησιμοποιεί το ίδιο ανέβασμα εκτελέσιμου με το εργαλείο agent: το εκτελέσιμο του sidecar ως file με το platform του και τη σελίδα ως ui, ένα .tar.gz του φακέλου ui/. Δείτε τις Εφαρμογές.
Έλεγχος
Το submit χρειάζεται το περιεχόμενο του κύριου αρχείου και μια περιγραφή 10 έως 500 χαρακτήρων. Κάθε υποβολή σαρώνεται. Μια καθαρή σάρωση μπορεί να εγκριθεί αυτόματα· οτιδήποτε επισημαίνεται πηγαίνει σε χειροκίνητο έλεγχο. Η έγκριση υπογράφει τυχόν εκτελέσιμα και κάνει την έκδοση ενεργή. Μια απορριφθείσα έκδοση επιστρέφει σε πρόχειρο.
| Κατάσταση στοιχείου | Σημασία |
|---|---|
draft | Δεν υποβλήθηκε ή απορρίφθηκε. |
pending_review, review | Αναμένει έλεγχο. |
active | Εγκρίθηκε. Καταχωρίζεται στην αγορά όταν η ορατότητα είναι public. |
revoked | Αποσύρθηκε. |
Κωδικοί εγκατάστασης
Κάθε στοιχείο παίρνει τον κωδικό εγκατάστασής του όταν δημιουργείται: SKIL-, AGNT-, PLUG-, APPS-, CONN- ή COLL- ακολουθούμενο από οκτώ χαρακτήρες. Αν πληκτρολογήσετε τον κωδικό ως μήνυμα σε μια συνομιλία του Nebo, το στοιχείο εγκαθίσταται· δείτε τις Βασικές έννοιες.