NeboAI
NeboAI
Aloita

Työntekijäpaketit

Työntekijäpaketti kuvaa roolin, jonka yritys voi palkata: mistä työntekijä vastaa, miten se työskentelee, millaisia järjestelmiä se tarvitsee ja mitä se tekee omin päin. Kirjoitat sen kansiona, jossa on AGENT.md ja, kun rooli tarvitsee enemmän kuin chatin, agent.json.

Paketti

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
TiedostoPakollinenTarkoitus
AGENT.mdkylläPersoona: kuka työntekijä on, miten se työskentelee ja sen säännöt. Katso Persoona ja muisti.
agent.jsoneiKyvyt, joita se vaatii, kysymykset omistajalle, työnkulut, muistiasetukset ja hyväksyntäkatot. Katso agent.json-viite.
skills/eiTaidot tavallisessa SKILL.md-muodossa. Vain tämä työntekijä näkee ne.
manifest.jsonvain sovelluksetIdentiteetti, jossa on "type": "app". Kauppa kirjoittaa oman manifestinsa paketoidessaan työntekijän.
ui/vain sovelluksetSovelluksen sivu. Katso Sovellukset.

Kirjoita paketti

Aloita persoonasta. Etuosa nimeää työntekijän ja antaa yksirivisen kuvauksen; runko on ohjeita tavallisena proosana.

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

Lisää agent.json, kun rooli tarvitsee järjestelmän, omistajan antaman asetuksen tai työtä, jota se tekee pyytämättä. Tämä vaatii mail-kyvyn, esittää yhden kysymyksen palkattaessa ja vastaa jokaiseen uuteen viestiin sen saapuessa.

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

Seuranta nimeää kyvyn mail, ei tuotetta. Ajon aikana se ratkeaa laajennukseksi, jonka omistaja yhdisti sähköpostia varten. Käynnistimet ja toiminnot kuvataan sivulla Työnkulut.

Lataa se bottiin

Sijoita kansio polkuun <data>/user/agents/<name>/. Nebo seuraa tiedostoja AGENT.md, agent.json ja manifest.json ja lataa työntekijän uudelleen noin sekunti muutoksen jälkeen. Kansion poistaminen poistaa työntekijän käytöstä mutta säilyttää sen tietueen.

Nebo lataa työntekijät kolmesta lähteestä, ja myöhemmät lähteet voittavat: Neboon sisäänrakennetut työntekijät, sinetöidyt kaupan paketit polussa <data>/nebo/agents/ ja kansiot polussa <data>/user/agents/. Työntekijä voi myös luoda tai muuttaa paketin puolestasi create_employee- ja update_employee-työkaluillaan, jotka kirjoittavat saman kansion.

Mitä palkattaessa tapahtuu

Kun omistaja palkkaa työntekijäsi kaupasta tai AGNT--koodilla, Nebo:

  1. Lukee paketin tarpeet kysymättä mallilta: jokaisen kyvyn kentässä requires.interfaces, jokaisen laajennuksen kentässä requires.plugins sekä jokaisen kyvyn tai laajennuksen, jonka seurantakäynnistin nimeää.
  2. Näyttää omistajalle yhden suostumuslauseen näistä tarpeista ja palkattaessa myöntää ne tälle työntekijälle pysyvinä lupina. Hyväksyntää vaativat toiminnot pysyvät sellaisina. Katso Kyvyt ja hyväksynnät.
  3. Asentaa riippuvuudet: laajennukset kentästä requires.plugins, kaupan taidot, jotka on nimetty kentässä skills ja toiminnoissa, sekä riippuvuudet, jotka ilmoitettiin paketin julkaisun yhteydessä.
  4. Esittää omistajalle inputs-kysymykset ja kertoo omistajalle Saapuneet-kansion kautta jokaisesta kyvystä, jolla ei vielä ole yhteyttä.

Työnkulku, jonka kyvyllä ei ole yhteyttä, säilytetään ja merkitään heikentyneeksi syineen. Se alkaa toimia heti, kun omistaja yhdistää järjestelmän.

Mitä Nebo tarkistaa

Nebo lukee tiedoston agent.json sallivasti. Tuntemattomat avaimet ohitetaan. Skeemaa vastaamaton työnkulku ohitetaan, ja omistaja saa Saapuneet-ilmoituksen, ettei sitä suoriteta; muu työntekijä latautuu silti. Nämä ongelmat hylkäävät koko tiedoston:

  • event-käynnistin, jonka sources-luettelo on tyhjä.
  • Kaksi toimintoa, joilla on sama id samassa työnkulussa.
  • Syöte, jonka scope on jokin muu kuin company tai seat, tai rahakysymys, jolla on oletusarvo.
  • ceiling-arvo, joka on jokin muu kuin "approval".
  • Puhelinvalikkopuu, jossa ei ole täsmälleen yhtä tervehdystä ja vähintään yhtä nimettyä aikomusta.

Jotkin tarkistukset tehdään työnkulun käynnistyessä eikä sen latautuessa, kuten kunkin toimintotyypin vaatimat parametrit. Katso Toiminnot.

Kirjoita vastuita, älä työkaluja. Työntekijäpaketti nimeää kykyjä, kuten ledger tai mail, eikä koskaan tiettyä tuotetta, yritystä tai toimialaa. Omistaja päättää, mikä järjestelmä täyttää kunkin kyvyn, joten yksi paketti palvelee jokaista sen palkkaavaa yritystä.

Seuraavaksi