NeboAI
NeboAI
Ξεκινήστε

Δεξιότητες

Μια δεξιότητα μαθαίνει σε έναν υπάλληλο να κάνει καλά ένα είδος δουλειάς. Τη γράφετε ως φάκελο με ένα αρχείο SKILL.md: μια σύντομη περιγραφή που χρησιμοποιεί ο υπάλληλος για να επιλέξει τη δεξιότητα και οδηγίες που ακολουθεί μόλις φορτωθεί. Οι δεξιότητες δεν χρειάζονται κώδικα και μπορεί να τις χρησιμοποιήσει κάθε υπάλληλος σε ένα bot.

Τι είναι μια δεξιότητα

Μια δεξιότητα είναι ένας φάκελος του οποίου το όνομα ταιριάζει με το name της δεξιότητας. Ο φάκελος περιέχει ένα αρχείο SKILL.md και, προαιρετικά, οποιαδήποτε άλλα αρχεία αναφέρουν οι οδηγίες: έγγραφα αναφοράς, πρότυπα ή σενάρια.

Το SKILL.md έχει δύο μέρη. Το YAML frontmatter ανάμεσα σε γραμμές --- περιέχει το όνομα και μια περιγραφή. Το σώμα Markdown που ακολουθεί περιέχει τις οδηγίες.

Πώς χρησιμοποιούν οι υπάλληλοι τις δεξιότητες

Ένας υπάλληλος δουλεύει με μια δεξιότητα σε τρία βήματα.

  1. Επιλογή. Σε κάθε γύρο, ο υπάλληλος βλέπει μια λίστα με τις δεξιότητες που έχει στη διάθεσή του: το όνομα κάθε δεξιότητας, την περιγραφή της και έως τρεις από τους ενεργοποιητές της. Η περιγραφή είναι αυτό που διαβάζει ο υπάλληλος για να αποφασίσει, γι’ αυτό γράψτε την ώστε να λέει τι κάνει η δεξιότητα και πότε χρησιμοποιείται.
  2. Φόρτωση. Ο υπάλληλος καλεί το εργαλείο use_skill με το όνομα της δεξιότητας. Το εργαλείο επιστρέφει τις οδηγίες, τη διαδρομή του φακέλου της δεξιότητας και τα ονόματα των αρχείων της. Αυτός είναι ο μόνος τρόπος με τον οποίο ένας υπάλληλος διαβάζει μια δεξιότητα.
  3. Εργασία. Ο υπάλληλος ακολουθεί τις οδηγίες. Διαβάζει τα βοηθητικά αρχεία με το read_skill_file και εκτελεί τα ενσωματωμένα σενάρια με το execute.

Οι ενεργοποιητές δεν φορτώνουν ποτέ μόνοι τους μια δεξιότητα. Την επιλογή την κάνει πάντα ο υπάλληλος. Όταν η λίστα μεγαλώσει, ο υπάλληλος μπορεί να την αναζητήσει με το find_skills.

Γράψτε την πρώτη σας δεξιότητα

Δημιουργήστε έναν φάκελο με το όνομα της δεξιότητας, με ένα αρχείο μέσα.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

Βάλτε τον φάκελο στον κατάλογο δεξιοτήτων χρήστη ενός bot (δείτε Πού βρίσκονται οι δεξιότητες). Το Nebo εντοπίζει τον νέο φάκελο μέσα σε περίπου ένα δευτερόλεπτο και κάθε υπάλληλος σε εκείνο το bot μπορεί να χρησιμοποιήσει τη δεξιότητα.

Ένας υπάλληλος μπορεί επίσης να γράψει μια δεξιότητα για εσάς. Ζητήστε του να αποθηκεύσει μία και θα καλέσει το save_skill, που γράφει τον φάκελο στον ίδιο κατάλογο δεξιοτήτων χρήστη.

Κανόνες που επιβάλλει ο φορτωτής

Μια δεξιότητα που παραβιάζει έναν από αυτούς τους κανόνες δεν φορτώνεται. Το Nebo καταγράφει μια προειδοποίηση και την παραλείπει.

ΚανόναςΛεπτομέρεια
Το αρχείο ξεκινά με ---Το frontmatter πρέπει να είναι το πρώτο πράγμα στο αρχείο. Το αρχείο πρέπει να είναι UTF-8.
Το name είναι υποχρεωτικόΜόνο πεζά γράμματα, ψηφία και παύλες· χωρίς παύλα στην αρχή ή στο τέλος· χωρίς διπλή παύλα· έως 64 byte.
Το description είναι υποχρεωτικόΈως 1.024 byte.
Τα πεδία έχουν τον σωστό τύποΈνα πεδίο με λάθος τύπο YAML αποτυγχάνει ολόκληρο το αρχείο. Βάλτε τις εκδόσεις σε εισαγωγικά, όπως "1.0.0".
Το platform ταιριάζειΑν υπάρχει, η δεξιότητα φορτώνεται μόνο στα λειτουργικά συστήματα που αναφέρονται.

Τα κλειδιά frontmatter που δεν αναγνωρίζει το Nebo αγνοούνται. Το σώμα δεν έχει όριο μεγέθους, αλλά οι συντομότερες οδηγίες αφήνουν περισσότερο χώρο για τη δουλειά. Μεταφέρετε το εκτενές υλικό σε αρχεία που διαβάζει ο υπάλληλος όταν τα χρειάζεται.

Προσθήκη αρχείων

Κάθε αρχείο στον φάκελο εκτός από το SKILL.md και τα κρυφά αρχεία είναι διαθέσιμο στον υπάλληλο. Τα ονόματα των φακέλων τα επιλέγετε εσείς· το Nebo δεν δίνει ειδική σημασία στα references/ ή assets/. Τα αρχεία κάτω από τα scripts/ ή bin/ μπορούν να εκτελεστούν.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

Αναφερθείτε στα αρχεία με τη διαδρομή τους μέσα στον φάκελο, όπως references/policy.md. Ο υπάλληλος τα διαβάζει με το read_skill_file, που απορρίπτει κάθε διαδρομή που βγαίνει από τον φάκελο. Τα σενάρια εκτελούνται με το εργαλείο execute σε απομονωμένο περιβάλλον. Η αναφορά SKILL.md καλύπτει τα περιβάλλοντα εκτέλεσης, τις μεταβλητές περιβάλλοντος, τα μυστικά και την πρόσβαση στο δίκτυο.

Πού βρίσκονται οι δεξιότητες

Ένα bot συλλέγει δεξιότητες από διάφορα σημεία. Όταν δύο πηγές παρέχουν δεξιότητα με το ίδιο όνομα, υπερισχύει η πηγή που εμφανίζεται αργότερα σε αυτή τη λίστα.

ΠηγήΤοποθεσίαΠοιος μπορεί να τη χρησιμοποιήσει
ΕνσωματωμένηΕνσωματωμένη στον κώδικα του NeboΚάθε υπάλληλος
Αγορά<data>/nebo/skills/<slug>/<version>/Κάθε υπάλληλος
ΠρόσθετοΟ φάκελος skills/ ενός εγκατεστημένου πρόσθετουΚάθε υπάλληλος
Χρήστη<data>/user/skills/<name>/Κάθε υπάλληλος
Πακέτο υπαλλήλουskills/ μέσα σε ένα εγκατεστημένο πακέτο υπαλλήλουΜόνο ο συγκεκριμένος υπάλληλος
Μαθημένη<data>/learned/skills/<employee>/<name>/Μόνο ο συγκεκριμένος υπάλληλος

Το <data> είναι ~/Library/Application Support/Nebo στο macOS, %APPDATA%\Nebo στα Windows και ~/.local/share/nebo στο Linux. Η μεταβλητή περιβάλλοντος NEBO_HOME το παρακάμπτει. Όταν ένας υπάλληλος έχει δική του δεξιότητα και μια κοινόχρηστη με το ίδιο όνομα, υπερισχύει η δική του.

Το Nebo παρακολουθεί αυτούς τους φακέλους και φορτώνει ξανά μια δεξιότητα που άλλαξε μετά από ένα δευτερόλεπτο. Για να απενεργοποιήσετε μια δεξιότητα χωρίς να τη διαγράψετε, μετονομάστε το αρχείο της σε SKILL.md.disabled.

Οι δεξιότητες περιγράφουν δουλειά, όχι εργαλεία. Γράψτε μια δεξιότητα γύρω από μια αρμοδιότητα, όπως η συμφωνία αποδείξεων, και αφήστε τον υπάλληλο να χρησιμοποιήσει όποια σύνδεση έχει δώσει ο κάτοχος. Όταν μια δεξιότητα χρειάζεται πραγματικά ένα πρόσθετο, δηλώστε το με το πεδίο plugins.

Επόμενα