NeboAI
NeboAI
Începe

Pachete de angajați

Un pachet de angajat descrie un rol pe care o companie îl poate angaja: de ce răspunde angajatul, cum lucrează, de ce tipuri de sisteme are nevoie și ce face singur. Îl scrii ca folder cu un AGENT.md și, când rolul are nevoie de mai mult decât chat, cu un agent.json.

Pachetul

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
FișierObligatoriuScop
AGENT.mddaPersona: cine este angajatul, cum lucrează și care îi sunt regulile. Vezi Persona și memorie.
agent.jsonnuCapabilitățile de care are nevoie, întrebări pentru proprietar, fluxuri de lucru, setări de memorie și plafoane de aprobare. Vezi Referință agent.json.
skills/nuAbilități în formatul standard SKILL.md. Doar acest angajat le vede.
manifest.jsondoar aplicațiiIdentitate cu "type": "app". Magazinul își scrie propriul manifest când împachetează un angajat.
ui/doar aplicațiiPagina aplicației. Vezi Aplicații.

Scrie un pachet

Începe cu persona. Frontmatterul numește angajatul și oferă o descriere pe un rând; corpul conține instrucțiuni în proză simplă.

---
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.

Adaugă agent.json când rolul are nevoie de un sistem, de o setare de la proprietar sau de muncă pe care o face fără să i se ceară. Acesta are nevoie de capabilitatea mail, pune o întrebare la angajare și răspunde la fiecare mesaj nou pe măsură ce sosește.

{
  "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."
        }
      ]
    }
  }
}

Monitorizarea numește capabilitatea mail, nu un produs. La rulare, se rezolvă la pluginul pe care proprietarul l-a conectat pentru e-mail. Vezi Fluxuri de lucru pentru declanșatoare și activități.

Încarcă-l pe un bot

Pune folderul în <data>/user/agents/<name>/. Nebo monitorizează AGENT.md, agent.json și manifest.json și reîncarcă angajatul la aproximativ o secundă după o modificare. Eliminarea folderului dezactivează angajatul, dar îi păstrează înregistrarea.

Nebo încarcă angajații din trei surse, iar sursele ulterioare au prioritate: angajații integrați în Nebo, pachetele sigilate din magazin aflate în <data>/nebo/agents/ și folderele din <data>/user/agents/. Un angajat poate și să creeze sau să modifice un pachet pentru tine cu instrumentele lui create_employee și update_employee, care scriu același folder.

Ce se întâmplă la angajare

Când un proprietar îți angajează angajatul din magazin sau cu un cod AGNT-, Nebo:

  1. Citește nevoile pachetului fără să întrebe un model: fiecare capabilitate din requires.interfaces, fiecare plugin din requires.plugins și fiecare capabilitate sau plugin numit de un declanșator de monitorizare.
  2. Îi arată proprietarului o singură propoziție de consimțământ pentru aceste nevoi și, la angajare, i le acordă acestui angajat ca permisiuni permanente. Operațiunile care necesită aprobare rămân așa. Vezi Capabilități și aprobări.
  3. Instalează dependențele: pluginurile din requires.plugins, abilitățile din magazin numite în skills și în activități și dependențele declarate când pachetul a fost publicat.
  4. Îi pune proprietarului întrebările din inputs și îl anunță prin Inbox despre orice capabilitate care nu are încă o conexiune.

Un flux de lucru a cărui capabilitate nu are conexiune e păstrat și marcat ca degradat, cu motivul. Începe să funcționeze imediat ce proprietarul conectează un sistem.

Ce verifică Nebo

Nebo citește agent.json cu toleranță. Cheile necunoscute sunt ignorate. Un flux de lucru care nu respectă schema e omis, iar proprietarul primește în Inbox o notificare că nu va rula; restul angajatului se încarcă în continuare. Aceste probleme resping întregul fișier:

  • Un declanșator event cu o listă sources goală.
  • Două activități cu același id în același flux de lucru.
  • O dată de intrare cu un scope diferit de company sau seat ori o întrebare despre bani cu valoare implicită.
  • O valoare ceiling diferită de "approval".
  • Un arbore de apeluri telefonice care nu are exact un mesaj de întâmpinare și cel puțin o intenție cu nume.

Unele verificări rulează când pornește un flux de lucru, nu când se încarcă, de exemplu parametrii pe care îi cere fiecare tip de activitate. Vezi Activități.

Scrie responsabilități, nu instrumente. Un pachet de angajat numește capabilități, precum ledger sau mail, și niciodată un anumit produs, o anumită companie sau industrie. Proprietarul decide ce sistem acoperă fiecare capabilitate, așa că un singur pachet servește fiecare companie care îl angajează.

Următorul