NeboAI
NeboAI
Ξεκινήστε

Αναφορά agent.json

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

Παράδειγμα

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

Πεδία

ΠεδίοΤύποςΣημασία
requires.interfacesλίστα συμβολοσειρώνΔυνατότητες που χρειάζεται ο ρόλος, όπως mail ή ledger. Παραχωρούνται κατά την πρόσληψη· κάθε λειτουργία που απαιτεί έγκριση παραμένει στοιχείο έγκρισης. Βλ. Δυνατότητες και εγκρίσεις.
requires.pluginsλίστα συμβολοσειρώνΠρόσθετα που εγκαθίστανται μαζί με τον υπάλληλο. Χρησιμοποιήστε το μόνο όταν ο ρόλος εξαρτάται πραγματικά από ένα πρόσθετο· προτιμήστε μια δυνατότητα.
requires.toolsλίστα συμβολοσειρώνΕργαλεία που φορτώνονται στη συνεδρία του υπαλλήλου από τον πρώτο του γύρο. Αυτό δεν παρακάμπτει ποτέ την έγκριση.
skillsλίστα συμβολοσειρώνΔεξιότητες της αγοράς προς εγκατάσταση και χρήση: @org/skills/name, προαιρετικά @version, ή ένας κωδικός SKIL-. Οι δεξιότητες στον φάκελο skills/ του ίδιου του πακέτου δεν χρειάζονται καταχώριση.
inputslistΕρωτήσεις που απαντά ο ιδιοκτήτης κατά την πρόσληψη. Βλ. Είσοδοι.
memoryobjectΠώς διατηρούνται οι συνομιλίες και η μνήμη. Βλ. Περσόνα και μνήμη.
subscribesλίστα συμβολοσειρώνΠεριοχές εταιρικών δεδομένων που ο υπάλληλος ξαναδιαβάζει όταν αλλάζουν, όπως finance.ar.*.
ceilingmapΛειτουργία προς "approval". Αυτή η λειτουργία ρωτά πάντα τον ιδιοκτήτη για αυτόν τον υπάλληλο. Δεν γίνεται δεκτή άλλη τιμή.
workflowsmapΌνομα ροής εργασίας προς ροή εργασίας. Βλ. Ροές εργασίας.
toolslistΕργαλεία HTTP που σερβίρονται από το sidecar μιας εφαρμογής. Βλ. Εργαλεία sidecar.
scopesmapΕπώνυμες ομάδες από tools, skills και plugins. Τα plugins ενός scope περιγράφονται στον υπάλληλο όταν αυτό το scope είναι ενεργό.

Είσοδοι

Ένα input είναι μια ερώτηση που απαντά ο κάτοχος κατά την πρόσληψη. Οι απαντήσεις εμφανίζονται στον υπάλληλο στην ενότητα «Configured Inputs» και συμπληρώνουν τα placeholders {{key}} στους triggers παρακολούθησης και φακέλων.

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
ΠεδίοΠροεπιλογήΣημασία
keyυποχρεωτικόΌνομα που χρησιμοποιείται στα placeholders. Το name γίνεται δεκτό ως εναλλακτική.
labelαπό το keyΗ ερώτηση που εμφανίζεται στον ιδιοκτήτη.
typetexttext, textarea, number, select, checkbox ή radio.
requiredfalseΣημειώνει την ερώτηση ως ερώτηση που πρέπει να απαντήσει ο ιδιοκτήτης.
defaultκαμίαΠροσυμπληρωμένη απάντηση. Δεν επιτρέπεται σε χρηματική ερώτηση.
placeholder, descriptionκαμίαΚείμενο βοήθειας.
optionsκαμίαΓια select και radio: αντικείμενα {value, label} ή απλές συμβολοσειρές.
idκαμίαΈνα σταθερό όνομα με τελείες για το στοιχείο, όπως finance.ap.invoice_mailbox, ώστε να μπορούν να το μοιράζονται και άλλοι υπάλληλοι.
scopecompanycompany: ένα κοινό στοιχείο της εταιρείας. seat: μόνο για αυτή την πρόσληψη.
missingκαμίαΤι κάνει ο υπάλληλος όσο η ερώτηση μένει αναπάντητη.
moneyfalseΣημειώνει χρηματικό ποσό. Μια χρηματική ερώτηση δεν μπορεί να έχει προεπιλογή.

Εργαλεία sidecar

Μια εφαρμογή με sidecar εκθέτει endpoints HTTP στον υπάλληλό της ως εργαλεία. Το Nebo καταχωρίζει κάθε καταχώριση ως app__<app>__<name> και στέλνει τις κλήσεις στο sidecar στα method και path. Δείτε το Sidecar εφαρμογών.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

Ροές εργασίας

Κάθε κλειδί κάτω από το workflows ονομάζει μία ροή εργασίας· το όνομα είναι το αναγνωριστικό της. Η πλήρης μορφή βρίσκεται στις σελίδες Ροές εργασίας, Εναύσματα και Δραστηριότητες.