Ang package
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 | File | Kailangan | Layunin |
|---|---|---|
AGENT.md | oo | Ang persona: kung sino ang empleyado, paano ito nagtatrabaho, at ang mga patakaran nito. Tingnan ang Persona at Memory. |
agent.json | hindi | Mga capability na kailangan nito, mga tanong para sa may-ari, mga workflow, memory settings at mga approval ceiling. Tingnan ang agent.json Reference. |
skills/ | hindi | Mga skill sa standard na SKILL.md format. Ang empleyadong ito lang ang nakakakita sa mga ito. |
manifest.json | apps lang | Pagkakakilanlan na may "type": "app". Sariling manifest ang isinusulat ng marketplace kapag ipina-package nito ang isang empleyado. |
ui/ | apps lang | Ang pahina ng app. Tingnan ang Apps. |
Magsulat ng package
Magsimula sa persona. Pinapangalanan ng frontmatter ang empleyado at nagbibigay ng isang linyang paglalarawan; ang body ay mga tagubilin sa simpleng 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.
Idagdag ang agent.json kapag kailangan ng tungkulin ng isang system, isang setting mula sa may-ari, o trabahong ginagawa nito nang hindi inuutusan. Kailangan nito ang mail capability, nagtatanong ng isang tanong sa pag-hire, at sinasagot ang bawat bagong mensahe pagdating nito.
{
"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."
}
]
}
}
} Pinapangalanan ng watch ang capability na mail, hindi isang produkto. Sa run time, nare-resolve ito sa plugin na ikinonekta ng may-ari para sa mail. Tingnan ang Workflows para sa mga trigger at activity.
I-load ito sa isang bot
Ilagay ang folder sa <data>/user/agents/<name>/. Binabantayan ng Nebo ang AGENT.md, agent.json at manifest.json at nire-reload ang empleyado mga isang segundo pagkatapos ng pagbabago. Dina-deactivate ng pag-alis ng folder ang empleyado pero pinapanatili ang record nito.
Nilo-load ng Nebo ang mga empleyado mula sa tatlong source, at nananaig ang mga huli: mga empleyadong built-in sa Nebo, mga selyadong marketplace package sa <data>/nebo/agents/, at mga folder sa <data>/user/agents/. Puwede ring gumawa o magbago ng package para sa iyo ang isang empleyado gamit ang mga tool nitong create_employee at update_employee, na sumusulat sa parehong folder.
Ano ang nangyayari sa pag-hire
Kapag ini-hire ng may-ari ang empleyado mo mula sa marketplace o gamit ang AGNT- code, ang Nebo ay:
- Binabasa ang mga kailangan ng package nang hindi nagtatanong sa model: bawat capability sa
requires.interfaces, bawat plugin sarequires.plugins, at bawat capability o plugin na pinapangalanan ng isang watch trigger. - Nagpapakita sa may-ari ng isang pangungusap ng pagpayag para sa mga kailangang iyon at, sa pag-hire, ibinibigay ang mga ito sa empleyadong ito bilang permanenteng pahintulot. Nananatiling ganoon ang mga operasyong nangangailangan ng pag-apruba. Tingnan ang Mga Kakayahan at Pag-apruba.
- Ini-install ang mga dependency: mga plugin sa
requires.plugins, mga marketplace skill na pinangalanan saskillsat sa mga activity, at ang mga dependency na idineklara noong na-publish ang package. - Itinatanong sa may-ari ang mga tanong sa
inputs, at sinasabihan ang may-ari sa Inbox tungkol sa anumang capability na wala pang koneksyon.
Pinapanatili ang workflow na walang koneksyon ang capability at minamarkahan itong degraded, kasama ang dahilan. Magsisimula itong gumana sa sandaling magkonekta ang may-ari ng isang system.
Ano ang sinusuri ng Nebo
Maluwag na binabasa ng Nebo ang agent.json. Hindi pinapansin ang mga hindi kilalang key. Nilalaktawan ang workflow na hindi tugma sa schema, at nakakatanggap ang may-ari ng abiso sa Inbox na hindi ito tatakbo; nilo-load pa rin ang natitirang bahagi ng empleyado. Tinatanggihan ng mga problemang ito ang buong file:
- Isang
eventtrigger na walang laman angsourceslist. - Dalawang activity na may parehong
idsa isang workflow. - Isang input na may
scopena iba sacompanyoseat, o isang tanong tungkol sa pera na may default. - Isang
ceilingvalue na iba sa"approval". - Isang phone call tree na walang eksaktong isang pagbati at kahit isang may-pangalang intent.
May mga pagsusuring tumatakbo kapag nagsimula ang workflow sa halip na kapag nilo-load ito, gaya ng mga parameter na kailangan ng bawat uri ng activity. Tingnan ang Activities.
Isulat ang mga responsibilidad, hindi ang mga tool. Pinapangalanan ng employee package ang mga capability, gaya ng ledger o mail, at hindi kailanman isang partikular na produkto, kumpanya, o industriya. Ang may-ari ang nagpapasya kung aling system ang pupuno sa bawat capability, kaya nagsisilbi ang isang package sa bawat kumpanyang nag-hire nito.
Susunod
- agent.json Reference
- Persona at Memory
- Pag-publish: ilagay ang empleyado sa marketplace.