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 | Tiedosto | Pakollinen | Tarkoitus |
|---|---|---|
AGENT.md | kyllä | Persoona: kuka työntekijä on, miten se työskentelee ja sen säännöt. Katso Persoona ja muisti. |
agent.json | ei | Kyvyt, joita se vaatii, kysymykset omistajalle, työnkulut, muistiasetukset ja hyväksyntäkatot. Katso agent.json-viite. |
skills/ | ei | Taidot tavallisessa SKILL.md-muodossa. Vain tämä työntekijä näkee ne. |
manifest.json | vain sovellukset | Identiteetti, jossa on "type": "app". Kauppa kirjoittaa oman manifestinsa paketoidessaan työntekijän. |
ui/ | vain sovellukset | Sovelluksen 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:
- Lukee paketin tarpeet kysymättä mallilta: jokaisen kyvyn kentässä
requires.interfaces, jokaisen laajennuksen kentässärequires.pluginssekä jokaisen kyvyn tai laajennuksen, jonka seurantakäynnistin nimeää. - 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.
- Asentaa riippuvuudet: laajennukset kentästä
requires.plugins, kaupan taidot, jotka on nimetty kentässäskillsja toiminnoissa, sekä riippuvuudet, jotka ilmoitettiin paketin julkaisun yhteydessä. - 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, jonkasources-luettelo on tyhjä.- Kaksi toimintoa, joilla on sama
idsamassa työnkulussa. - Syöte, jonka
scopeon jokin muu kuincompanytaiseat, 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
- agent.json-viite
- Persoona ja muisti
- Julkaiseminen: vie työntekijä kauppaan.