Paketet
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 | Obligatorisk | Syfte |
|---|---|---|
AGENT.md | ja | Personan: vem medarbetaren är, hur den arbetar och dess regler. Se Persona och minne. |
agent.json | nej | Funktioner den kräver, frågor till ägaren, arbetsflöden, minnesinställningar och godkännandetak. Se agent.json-referens. |
skills/ | nej | Färdigheter i standardformatet SKILL.md. Bara den här medarbetaren ser dem. |
manifest.json | endast appar | Identitet med "type": "app". Marknadsplatsen skriver ett eget manifest när den paketerar en medarbetare. |
ui/ | endast appar | Appens sida. Se Appar. |
Skriv ett paket
Börja med personan. Frontmatter namnger medarbetaren och ger en beskrivning på en rad; brödtexten är instruktioner 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.
Lägg till agent.json när rollen behöver ett system, en inställning från ägaren eller arbete som den gör utan att bli ombedd. Den här kräver funktionen mail, ställer en fråga vid anställningen och svarar på varje nytt meddelande när det kommer in.
{
"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."
}
]
}
}
} Bevakningen namnger funktionen mail, inte en produkt. Vid körning kopplas den till det plugin som ägaren har anslutit för e-post. Se Arbetsflöden för utlösare och aktiviteter.
Läs in det på en bot
Lägg mappen i <data>/user/agents/<name>/. Nebo bevakar AGENT.md, agent.json och manifest.json och läser in medarbetaren på nytt ungefär en sekund efter en ändring. Om du tar bort mappen inaktiveras medarbetaren, men dess post finns kvar.
Nebo läser in medarbetare från tre källor, och senare källor vinner: medarbetare som är inbyggda i Nebo, förseglade paket från marknadsplatsen i <data>/nebo/agents/ och mappar i <data>/user/agents/. En medarbetare kan också skapa eller ändra ett paket åt dig med verktygen create_employee och update_employee, som skriver samma mapp.
Det här händer vid anställningen
När en ägare anställer din medarbetare från marknadsplatsen eller med en AGNT--kod gör Nebo följande:
- Läser paketets behov utan att fråga en modell: varje funktion i
requires.interfaces, varje plugin irequires.pluginsoch varje funktion eller plugin som en bevakningsutlösare namnger. - Visar ägaren en mening om samtycke för de behoven och ger dem vid anställningen till medarbetaren som stående behörigheter. Åtgärder som kräver godkännande fortsätter att göra det. Se Funktioner och godkännanden.
- Installerar beroenden: plugins i
requires.plugins, färdigheter från marknadsplatsen som namnges iskillsoch i aktiviteter, samt de beroenden som deklarerades när paketet publicerades. - Ställer frågorna i
inputstill ägaren och meddelar ägaren via inkorgen om varje funktion som ännu saknar anslutning.
Ett arbetsflöde vars funktion saknar anslutning behålls och markeras som nedsatt, med orsaken. Det börjar fungera så snart ägaren ansluter ett system.
Det här kontrollerar Nebo
Nebo läser agent.json tolerant. Okända nycklar ignoreras. Ett arbetsflöde som inte matchar schemat hoppas över, och ägaren får ett meddelande i inkorgen om att det inte kommer att köras; resten av medarbetaren läses ändå in. Följande problem gör att hela filen avvisas:
- En
event-utlösare med en tomsources-lista. - Två aktiviteter med samma
idi ett och samma arbetsflöde. - Indata med ett annat
scopeäncompanyellerseat, eller en fråga om pengar med ett standardvärde. - Ett
ceiling-värde som inte är"approval". - Ett samtalsträd för telefon som inte har exakt en hälsning och minst en namngiven avsikt.
Vissa kontroller körs när ett arbetsflöde startar snarare än när det läses in, till exempel de parametrar som varje aktivitetstyp kräver. Se Aktiviteter.
Skriv ansvarsområden, inte verktyg. Ett medarbetarpaket namnger funktioner, som ledger eller mail, och aldrig en viss produkt, ett visst företag eller en viss bransch. Ägaren bestämmer vilket system som fyller varje funktion, så ett och samma paket fungerar för varje företag som anställer medarbetaren.
Nästa
- agent.json-referens
- Persona och minne
- Publicering: lägg ut medarbetaren på marknadsplatsen.