NeboAI
NeboAI
Kom igång

Medarbetarpaket

Ett medarbetarpaket beskriver en roll som ett företag kan anställa: vad medarbetaren ansvarar för, hur den arbetar, vilka typer av system den behöver och vad den gör på egen hand. Du skriver det som en mapp med en AGENT.md och, när rollen behöver mer än chatt, en agent.json.

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
FilObligatoriskSyfte
AGENT.mdjaPersonan: vem medarbetaren är, hur den arbetar och dess regler. Se Persona och minne.
agent.jsonnejFunktioner den kräver, frågor till ägaren, arbetsflöden, minnesinställningar och godkännandetak. Se agent.json-referens.
skills/nejFärdigheter i standardformatet SKILL.md. Bara den här medarbetaren ser dem.
manifest.jsonendast apparIdentitet med "type": "app". Marknadsplatsen skriver ett eget manifest när den paketerar en medarbetare.
ui/endast apparAppens 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:

  1. Läser paketets behov utan att fråga en modell: varje funktion i requires.interfaces, varje plugin i requires.plugins och varje funktion eller plugin som en bevakningsutlösare namnger.
  2. 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.
  3. Installerar beroenden: plugins i requires.plugins, färdigheter från marknadsplatsen som namnges i skills och i aktiviteter, samt de beroenden som deklarerades när paketet publicerades.
  4. Ställer frågorna i inputs till ä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 tom sources-lista.
  • Två aktiviteter med samma id i ett och samma arbetsflöde.
  • Indata med ett annat scope än company eller seat, 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