NeboAI
NeboAI
Ξεκινήστε

Πακέτα υπαλλήλων

Ένα πακέτο υπαλλήλου περιγράφει έναν ρόλο που μπορεί να προσλάβει μια εταιρεία: για τι είναι υπεύθυνος ο υπάλληλος, πώς δουλεύει, τι είδους συστήματα χρειάζεται και τι κάνει μόνος του. Το γράφετε ως φάκελο με ένα AGENT.md και, όταν ο ρόλος χρειάζεται κάτι περισσότερο από συνομιλία, ένα agent.json.

Το πακέτο

support-coordinator/
├── AGENT.md        # required: who the employee is and how it works
├── agent.json      # optional: capabilities, inputs, workflows, memory
└── skills/         # optional: skills only this employee uses
    └── reply-drafting/
        └── SKILL.md
ΑρχείοΥποχρεωτικόΣκοπός
AGENT.mdναιΗ περσόνα: ποιος είναι ο υπάλληλος, πώς δουλεύει και οι κανόνες του. Βλ. Περσόνα και μνήμη.
agent.jsonόχιΔυνατότητες που απαιτεί, ερωτήσεις για τον ιδιοκτήτη, ροές εργασίας, ρυθμίσεις μνήμης και ανώτατα όρια έγκρισης. Βλ. Αναφορά agent.json.
skills/όχιΔεξιότητες στην τυπική μορφή SKILL.md. Μόνο αυτός ο υπάλληλος τις βλέπει.
manifest.jsonμόνο για εφαρμογέςΤαυτότητα με "type": "app". Η αγορά γράφει το δικό της manifest όταν πακετάρει έναν υπάλληλο.
ui/μόνο για εφαρμογέςΗ σελίδα της εφαρμογής. Βλ. Εφαρμογές.

Γράψτε ένα πακέτο

Ξεκινήστε με την περσόνα. Το frontmatter δίνει όνομα στον υπάλληλο και μια περιγραφή μίας γραμμής· το σώμα είναι οδηγίες σε απλό κείμενο.

---
name: Support Coordinator
description: Answers every customer message the day it arrives and escalates what it cannot settle.
---

# Support Coordinator

You answer customer email for the company. Reply within the configured window,
in the company's voice, and keep every thread moving until the customer has an answer.

## How you work
- Read the whole thread before you reply.
- Use the reply-drafting skill for every customer reply.
- When a message is about money, draft a proposal for the owner instead of promising anything.

## Rules
- Never promise a refund, a discount or a date you cannot confirm.

Προσθέστε το agent.json όταν ο ρόλος χρειάζεται ένα σύστημα, μια ρύθμιση από τον ιδιοκτήτη ή δουλειά που κάνει χωρίς να του ζητηθεί. Αυτό εδώ απαιτεί τη δυνατότητα mail, κάνει μία ερώτηση κατά την πρόσληψη και απαντά σε κάθε νέο μήνυμα μόλις φτάνει.

{
  "requires": { "interfaces": ["mail"] },
  "inputs": [
    {
      "key": "reply_window_hours",
      "label": "Reply within (hours)",
      "type": "number",
      "id": "support.reply_window_hours",
      "scope": "company",
      "default": 24
    }
  ],
  "workflows": {
    "new-mail": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "description": "Handle each customer message as it arrives.",
      "activities": [
        {
          "id": "reply",
          "intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
        }
      ]
    }
  }
}

Η παρακολούθηση ονομάζει τη δυνατότητα mail, όχι ένα προϊόν. Κατά την εκτέλεση αντιστοιχίζεται στο πρόσθετο που συνέδεσε ο ιδιοκτήτης για το email. Δείτε τις Ροές εργασίας για εναύσματα και δραστηριότητες.

Φορτώστε το σε ένα bot

Τοποθετήστε τον φάκελο στο <data>/user/agents/<name>/. Το Nebo παρακολουθεί τα AGENT.md, agent.json και manifest.json και επαναφορτώνει τον υπάλληλο περίπου ένα δευτερόλεπτο μετά από μια αλλαγή. Η αφαίρεση του φακέλου απενεργοποιεί τον υπάλληλο αλλά κρατά την εγγραφή του.

Το Nebo φορτώνει υπαλλήλους από τρεις πηγές και οι μεταγενέστερες υπερισχύουν: υπάλληλοι ενσωματωμένοι στο Nebo, σφραγισμένα πακέτα της αγοράς στο <data>/nebo/agents/ και φάκελοι στο <data>/user/agents/. Ένας υπάλληλος μπορεί επίσης να δημιουργήσει ή να αλλάξει ένα πακέτο για εσάς με τα εργαλεία του create_employee και update_employee, τα οποία γράφουν τον ίδιο φάκελο.

Τι συμβαίνει κατά την πρόσληψη

Όταν ένας ιδιοκτήτης προσλαμβάνει τον υπάλληλό σας από την αγορά ή με κωδικό AGNT-, το Nebo:

  1. Διαβάζει τις ανάγκες του πακέτου χωρίς να ρωτήσει μοντέλο: κάθε δυνατότητα στο requires.interfaces, κάθε πρόσθετο στο requires.plugins και κάθε δυνατότητα ή πρόσθετο που ονομάζει ένα έναυσμα παρακολούθησης.
  2. Δείχνει στον ιδιοκτήτη μία πρόταση συναίνεσης για αυτές τις ανάγκες και, με την πρόσληψη, τις παραχωρεί σε αυτόν τον υπάλληλο ως μόνιμα δικαιώματα. Οι λειτουργίες που χρειάζονται έγκριση παραμένουν έτσι. Δείτε τις Δυνατότητες και εγκρίσεις.
  3. Εγκαθιστά εξαρτήσεις: πρόσθετα στο requires.plugins, δεξιότητες της αγοράς που αναφέρονται στο skills και σε δραστηριότητες, καθώς και τις εξαρτήσεις που δηλώθηκαν κατά τη δημοσίευση του πακέτου.
  4. Κάνει στον ιδιοκτήτη τις ερωτήσεις του inputs και τον ενημερώνει μέσω των Εισερχομένων για κάθε δυνατότητα που δεν έχει ακόμη σύνδεση.

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

Τι ελέγχει το Nebo

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

  • Ένα έναυσμα event με κενή λίστα sources.
  • Δύο δραστηριότητες με το ίδιο id σε μία ροή εργασίας.
  • Μια είσοδος με scope διαφορετικό από company ή seat, ή μια χρηματική ερώτηση με προεπιλογή.
  • Μια τιμή ceiling διαφορετική από "approval".
  • Ένα δέντρο τηλεφωνικής κλήσης χωρίς ακριβώς έναν χαιρετισμό και τουλάχιστον μία επώνυμη πρόθεση.

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

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

Επόμενα