Àpò náà
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 | Fáìlì | Ó pọn dandan | Ète |
|---|---|---|
AGENT.md | bẹ́ẹ̀ni | Ìwà náà: ẹni tí òṣìṣẹ́ náà jẹ́, bí ó ṣe ń ṣiṣẹ́, àti àwọn òfin rẹ̀. Wo Ìwà àti ìrántí. |
agent.json | rárá | Àwọn agbára tí ó nílò, àwọn ìbéèrè fún olùní, àwọn ìlànà iṣẹ́, ètò ìrántí àti àwọn ààlà ìfọwọ́sí. Wo Ìtọ́kasí agent.json. |
skills/ | rárá | Àwọn ọgbọ́n nínú ìrísí SKILL.md boṣewa. Òṣìṣẹ́ yìí nìkan ló ń rí wọn. |
manifest.json | àwọn áàpù nìkan | Ìdánimọ̀ pẹ̀lú "type": "app". Ọjà ń kọ manifest tirẹ̀ nígbà tí ó bá ń di òṣìṣẹ́ kan pọ̀. |
ui/ | àwọn áàpù nìkan | Ojú-ìwé áàpù náà. Wo Àwọn áàpù. |
Kọ àpò kan
Bẹ̀rẹ̀ pẹ̀lú ìwà náà. Frontmatter ń dárúkọ òṣìṣẹ́ náà, ó sì ń fún un ní àpèjúwe ìlà kan; ara rẹ̀ jẹ́ ìtọ́ni ní ọ̀rọ̀ tí ó rọrùn.
--- 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.
Fi agent.json kún un nígbà tí ipò náà bá nílò ètò kan, ètò kan láti ọ̀dọ̀ olùní, tàbí iṣẹ́ tí ó ń ṣe láìjẹ́ pé a béèrè. Èyí nílò agbára mail, ó ń béèrè ìbéèrè kan nígbà ìgbàsíṣẹ́, ó sì ń dáhùn ìránṣẹ́ tuntun kọ̀ọ̀kan bí ó ṣe ń dé.
{
"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."
}
]
}
}
} Ìṣọ́ náà ń dárúkọ agbára mail, kì í ṣe ọjà kan. Nígbà ìṣiṣẹ́, ó ń yanjú sí plugin tí olùní so pọ̀ fún ímeèlì. Wo Àwọn ìlànà iṣẹ́ fún àwọn trigger àti ìgbòkègbodò.
Gbé e wọlé sórí bot kan
Fi fódà náà sínú <data>/user/agents/<name>/. Nebo ń ṣọ́ AGENT.md, agent.json àti manifest.json, ó sì ń tún òṣìṣẹ́ náà gbé wọlé ní nǹkan bí ìṣẹ́jú-àáyá kan lẹ́yìn ìyípadà. Yíyọ fódà náà kúrò ń dá òṣìṣẹ́ náà dúró ṣùgbọ́n ó ń pa àkọsílẹ̀ rẹ̀ mọ́.
Nebo ń gbé àwọn òṣìṣẹ́ wọlé láti orísun mẹ́ta, àwọn orísun tí ó kẹ́yìn sì ń borí: àwọn òṣìṣẹ́ tí a kọ́ sínú Nebo, àwọn àpò ọjà tí a dì nínú <data>/nebo/agents/, àti àwọn fódà nínú <data>/user/agents/. Òṣìṣẹ́ kan tún lè ṣẹ̀dá tàbí yí àpò kan padà fún ọ pẹ̀lú àwọn irinṣẹ́ create_employee àti update_employee rẹ̀, tí ó ń kọ fódà kan náà.
Ohun tí ó ń ṣẹlẹ̀ nígbà ìgbàsíṣẹ́
Nígbà tí olùní bá gba òṣìṣẹ́ rẹ síṣẹ́ láti ọjà tàbí pẹ̀lú kóòdù AGNT-, Nebo:
- Ń ka àwọn ohun tí àpò náà nílò láìbéèrè lọ́wọ́ àwòṣe kan: gbogbo agbára nínú
requires.interfaces, gbogbo plugin nínúrequires.plugins, àti gbogbo agbára tàbí plugin tí trigger ìṣọ́ kan dárúkọ. - Ń fi gbólóhùn ìfọwọ́sí kan hàn olùní fún àwọn ohun tí ó nílò wọ̀nyẹn, nígbà ìgbàsíṣẹ́ ó sì ń fún òṣìṣẹ́ yìí ní wọn gẹ́gẹ́ bí àṣẹ tí ó dúró. Àwọn iṣẹ́ tí ó nílò ìfọwọ́sí ṣì wà bẹ́ẹ̀. Wo Àwọn agbára àti àwọn ìfọwọ́sí.
- Ń fi àwọn ohun tí ó gbára lé sórí ẹ̀rọ: àwọn plugin nínú
requires.plugins, àwọn ọgbọ́n ọjà tí a dárúkọ nínúskillsàti nínú àwọn ìgbòkègbodò, àti àwọn ohun tí ó gbára lé tí a kéde nígbà tí a ṣe àtẹ̀jáde àpò náà. - Ń béèrè àwọn ìbéèrè
inputslọ́wọ́ olùní, ó sì ń sọ fún olùní nípasẹ̀ Àpótí ìránṣẹ́ nípa agbára èyíkéyìí tí kò tíì ní ìsopọ̀.
Ìlànà iṣẹ́ tí agbára rẹ̀ kò ní ìsopọ̀ ni a ń pa mọ́, a sì ń sàmì sí i pé ó ti dín kù, pẹ̀lú ìdí rẹ̀. Ó ń bẹ̀rẹ̀ iṣẹ́ ní kété tí olùní bá so ètò kan pọ̀.
Ohun tí Nebo ń ṣàyẹ̀wò
Nebo ń ka agent.json pẹ̀lú ìfaradà. A ń fojú fo àwọn kọ́kọ́rọ́ tí a kò mọ̀. A ń fo ìlànà iṣẹ́ tí kò bá àwòṣe mu, olùní sì ń gba ìkéde nínú Àpótí ìránṣẹ́ pé kò ní ṣiṣẹ́; ìyókù òṣìṣẹ́ náà ṣì ń wọlé. Àwọn ìṣòro wọ̀nyí ń kọ gbogbo fáìlì náà:
- Trigger
eventpẹ̀lú àtòjọsourcestí ó ṣófo. - Ìgbòkègbodò méjì pẹ̀lú
idkan náà nínú ìlànà iṣẹ́ kan. - Ohun tí ó ń wọlé pẹ̀lú
scopetí kì í ṣecompanytàbíseat, tàbí ìbéèrè owó pẹ̀lú ìpìlẹ̀. - Iye
ceilingtí kì í ṣe"approval". - Igi ìpè fóònù tí kò ní ìkíni kan gan-an àti ó kéré tán ète kan tí a dárúkọ.
Àwọn àyẹ̀wò kan ń ṣiṣẹ́ nígbà tí ìlànà iṣẹ́ bá bẹ̀rẹ̀ dípò ìgbà tí ó bá wọlé, bí àwọn paramita tí irú ìgbòkègbodò kọ̀ọ̀kan nílò. Wo Àwọn ìgbòkègbodò.
Kọ àwọn ojúṣe, kì í ṣe àwọn irinṣẹ́. Àpò òṣìṣẹ́ kan ń dárúkọ àwọn agbára, bí ledger tàbí mail, kì í sì í dárúkọ ọjà, ilé-iṣẹ́, tàbí ẹ̀ka iṣẹ́ pàtó kan rárá. Olùní ló ń pinnu ètò tí yóò kún agbára kọ̀ọ̀kan, nítorí náà àpò kan ń ṣiṣẹ́ fún gbogbo ilé-iṣẹ́ tí ó bá gbà á síṣẹ́.
Èyí tó kàn
- Ìtọ́kasí agent.json
- Ìwà àti ìrántí
- Ṣíṣe àtẹ̀jáde: gbé òṣìṣẹ́ náà sí ọjà.