NeboAI
NeboAI
Kom i gang

Ansattpakker

En ansattpakke beskriver en rolle en bedrift kan ansette: hva den ansatte har ansvar for, hvordan den jobber, hvilke typer systemer den trenger, og hva den gjør på egen hånd. Du skriver den som en mappe med en AGENT.md og, når rollen trenger mer enn 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åkrevdFormål
AGENT.mdjaPersonaen: hvem den ansatte er, hvordan den jobber, og reglene dens. Se Persona og minne.
agent.jsonneiFunksjoner den krever, spørsmål til eieren, arbeidsflyter, minneinnstillinger og godkjenningstak. Se agent.json-referanse.
skills/neiFerdigheter i standard SKILL.md-format. Bare denne ansatte ser dem.
manifest.jsonkun apperIdentitet med "type": "app". Markedsplassen skriver sitt eget manifest når den pakker en ansatt.
ui/kun apperAppens 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:

  1. Leser pakkens behov uten å spørre en modell: hver funksjon i requires.interfaces, hvert tillegg i requires.plugins, og hver funksjon eller hvert tillegg en overvåkingsutløser nevner.
  2. 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.
  3. Installerer avhengigheter: tillegg i requires.plugins, markedsplassferdigheter nevnt i skills og i aktiviteter, og avhengighetene som ble erklært da pakken ble publisert.
  4. 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 tom sources-liste.
  • To aktiviteter med samme id i én arbeidsflyt.
  • Et inndatafelt med en annen scope enn company eller seat, 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