Pakken
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 | Fil | Påkrevd | Formål |
|---|---|---|
AGENT.md | ja | Personaen: hvem den ansatte er, hvordan den jobber, og reglene dens. Se Persona og minne. |
agent.json | nei | Funksjoner den krever, spørsmål til eieren, arbeidsflyter, minneinnstillinger og godkjenningstak. Se agent.json-referanse. |
skills/ | nei | Ferdigheter i standard SKILL.md-format. Bare denne ansatte ser dem. |
manifest.json | kun apper | Identitet med "type": "app". Markedsplassen skriver sitt eget manifest når den pakker en ansatt. |
ui/ | kun apper | Appens side. Se Apper. |
Skriv en pakke
Start med personaen. Frontmatter gir den ansatte et navn og en beskrivelse på én linje; brødteksten er instruksjoner i vanlig prosa.
--- 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.
Legg til agent.json når rollen trenger et system, en innstilling fra eieren eller arbeid den gjør uten å bli bedt om det. Denne krever funksjonen mail, stiller ett spørsmål ved ansettelse og svarer på hver nye melding når den kommer.
{
"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."
}
]
}
}
} Overvåkingen nevner funksjonen mail, ikke et produkt. Ved kjøring løses den til tillegget eieren har koblet til for e-post. Se Arbeidsflyter for utløsere og aktiviteter.
Last den inn på en bot
Legg mappen i <data>/user/agents/<name>/. Nebo overvåker AGENT.md, agent.json og manifest.json og laster den ansatte inn på nytt omtrent ett sekund etter en endring. Fjerner du mappen, deaktiveres den ansatte, men oppføringen beholdes.
Nebo laster ansatte fra tre kilder, og senere kilder vinner: ansatte innebygd i Nebo, forseglede markedsplasspakker i <data>/nebo/agents/, og mapper i <data>/user/agents/. En ansatt kan også opprette eller endre en pakke for deg med verktøyene create_employee og update_employee, som skriver den samme mappen.
Hva som skjer ved ansettelse
Når en eier ansetter den ansatte din fra markedsplassen eller med en AGNT--kode, gjør Nebo dette:
- Leser pakkens behov uten å spørre en modell: hver funksjon i
requires.interfaces, hvert tillegg irequires.plugins, og hver funksjon eller hvert tillegg en overvåkingsutløser nevner. - Viser eieren én samtykkesetning for disse behovene og gir dem, ved ansettelse, til denne ansatte som faste tillatelser. Operasjoner som krever godkjenning, forblir slik. Se Funksjoner og godkjenninger.
- Installerer avhengigheter: tillegg i
requires.plugins, markedsplassferdigheter nevnt iskillsog i aktiviteter, og avhengighetene som ble erklært da pakken ble publisert. - Stiller eieren
inputs-spørsmålene, og varsler eieren via innboksen om funksjoner som ennå ikke har en tilkobling.
En arbeidsflyt der funksjonen mangler tilkobling, beholdes og merkes som redusert, med begrunnelsen. Den begynner å fungere så snart eieren kobler til et system.
Hva Nebo sjekker
Nebo leser agent.json overbærende. Ukjente nøkler ignoreres. En arbeidsflyt som ikke samsvarer med skjemaet, hoppes over, og eieren får et varsel i innboksen om at den ikke vil kjøre; resten av den ansatte lastes likevel. Disse problemene avviser hele filen:
- En
event-utløser med en tomsources-liste. - To aktiviteter med samme
idi én arbeidsflyt. - Et inndatafelt med en annen
scopeenncompanyellerseat, eller et pengespørsmål med en standardverdi. - En
ceiling-verdi som ikke er"approval". - Et telefonsamtaletre uten nøyaktig én hilsen og minst én navngitt intensjon.
Noen sjekker kjøres når en arbeidsflyt starter i stedet for når den lastes, for eksempel parameterne hver aktivitetstype krever. Se Aktiviteter.
Skriv ansvarsområder, ikke verktøy. En ansattpakke nevner funksjoner, som ledger eller mail, og aldri et bestemt produkt, en bedrift eller en bransje. Eieren bestemmer hvilket system som fyller hver funksjon, slik at én pakke fungerer for alle bedrifter som ansetter den.
Neste
- agent.json-referanse
- Persona og minne
- Publisering: legg den ansatte ut på markedsplassen.