NeboAI
NeboAI
Kom i gang

Medarbejderpakker

En medarbejderpakke beskriver en rolle, som en virksomhed kan ansætte: hvad medarbejderen har ansvar for, hvordan den arbejder, hvilke slags systemer den har brug for, og hvad den gør på egen hånd. Du skriver den som en mappe med en AGENT.md og, når rollen kræver mere end chat, en agent.json.

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
FilPåkrævetFormål
AGENT.mdjaPersonaen: hvem medarbejderen er, hvordan den arbejder, og dens regler. Se Persona og hukommelse.
agent.jsonnejFunktioner, den kræver, spørgsmål til ejeren, workflows, indstillinger for hukommelse og lofter for godkendelse. Se agent.json-reference.
skills/nejFærdigheder i standardformatet SKILL.md. Kun denne medarbejder ser dem.
manifest.jsonkun appsIdentitet med "type": "app". Markedspladsen skriver sit eget manifest, når den pakker en medarbejder.
ui/kun appsAppens side. Se Apps.

Skriv en pakke

Start med personaen. Frontmatter navngiver medarbejderen og giver en beskrivelse på én linje; brødteksten er instruktioner i almindelig 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.

Tilføj agent.json, når rollen kræver et system, en indstilling fra ejeren eller arbejde, den udfører uden at blive bedt om det. Denne kræver funktionen mail, stiller ét spørgsmål ved ansættelsen og besvarer hver ny besked, 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ågningen navngiver funktionen mail, ikke et produkt. Ved kørsel peger den på det plugin, ejeren har forbundet til mail. Se Workflows for udløsere og aktiviteter.

Indlæs den på en bot

Læg mappen i <data>/user/agents/<name>/. Nebo overvåger AGENT.md, agent.json og manifest.json og genindlæser medarbejderen omkring et sekund efter en ændring. Hvis du fjerner mappen, deaktiveres medarbejderen, men dens post bevares.

Nebo indlæser medarbejdere fra tre kilder, og senere kilder vinder: medarbejdere bygget ind i Nebo, forseglede pakker fra markedspladsen i <data>/nebo/agents/ og mapper i <data>/user/agents/. En medarbejder kan også oprette eller ændre en pakke for dig med sine værktøjer create_employee og update_employee, som skriver den samme mappe.

Hvad der sker ved ansættelse

Når en ejer ansætter din medarbejder fra markedspladsen eller med en AGNT--kode, gør Nebo følgende:

  1. Læser pakkens behov uden at spørge en model: hver funktion i requires.interfaces, hvert plugin i requires.plugins og hver funktion eller hvert plugin, som en overvågningsudløser navngiver.
  2. Viser ejeren én samtykkesætning for de behov og giver dem ved ansættelsen til denne medarbejder som stående tilladelser. Operationer, der kræver godkendelse, bliver ved med at gøre det. Se Funktioner og godkendelser.
  3. Installerer afhængigheder: plugins i requires.plugins, færdigheder fra markedspladsen, der er navngivet i skills og i aktiviteter, og de afhængigheder, der blev erklæret, da pakken blev udgivet.
  4. Stiller ejeren spørgsmålene i inputs og fortæller ejeren via Indbakken om enhver funktion, der endnu ikke har en forbindelse.

Et workflow, hvis funktion ikke har en forbindelse, bevares og markeres som nedsat, med begrundelsen. Det begynder at virke, så snart ejeren forbinder et system.

Hvad Nebo tjekker

Nebo læser agent.json overbærende. Ukendte nøgler ignoreres. Et workflow, der ikke matcher skemaet, springes over, og ejeren får en besked i Indbakken om, at det ikke kører; resten af medarbejderen indlæses stadig. Disse problemer afviser hele filen:

  • En event-udløser med en tom sources-liste.
  • To aktiviteter med det samme id i ét workflow.
  • Et input med en anden scope end company eller seat, eller et pengespørgsmål med en standardværdi.
  • En ceiling-værdi, der ikke er "approval".
  • Et telefonmenutræ uden præcis én velkomst og mindst én navngiven hensigt.

Nogle tjek kører, når et workflow starter, frem for når det indlæses, f.eks. de parametre, som hver aktivitetstype kræver. Se Aktiviteter.

Skriv ansvarsområder, ikke værktøjer. En medarbejderpakke navngiver funktioner som ledger eller mail og aldrig et bestemt produkt, en virksomhed eller en branche. Ejeren bestemmer, hvilket system der udfylder hver funktion, så én pakke tjener alle de virksomheder, der ansætter den.

Næste