NeboAI
NeboAI
Magsimula

Mga Package ng Empleyado

Inilalarawan ng employee package ang isang tungkuling puwedeng i-hire ng kumpanya: kung ano ang responsibilidad ng empleyado, paano ito nagtatrabaho, anong mga uri ng system ang kailangan nito, at ano ang ginagawa nito nang mag-isa. Isinusulat mo ito bilang folder na may AGENT.md at, kapag kailangan ng tungkulin ng higit pa sa chat, isang agent.json.

Ang package

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
FileKailanganLayunin
AGENT.mdooAng persona: kung sino ang empleyado, paano ito nagtatrabaho, at ang mga patakaran nito. Tingnan ang Persona at Memory.
agent.jsonhindiMga capability na kailangan nito, mga tanong para sa may-ari, mga workflow, memory settings at mga approval ceiling. Tingnan ang agent.json Reference.
skills/hindiMga skill sa standard na SKILL.md format. Ang empleyadong ito lang ang nakakakita sa mga ito.
manifest.jsonapps langPagkakakilanlan na may "type": "app". Sariling manifest ang isinusulat ng marketplace kapag ipina-package nito ang isang empleyado.
ui/apps langAng pahina ng app. Tingnan ang Apps.

Magsulat ng package

Magsimula sa persona. Pinapangalanan ng frontmatter ang empleyado at nagbibigay ng isang linyang paglalarawan; ang body ay mga tagubilin sa simpleng 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.

Idagdag ang agent.json kapag kailangan ng tungkulin ng isang system, isang setting mula sa may-ari, o trabahong ginagawa nito nang hindi inuutusan. Kailangan nito ang mail capability, nagtatanong ng isang tanong sa pag-hire, at sinasagot ang bawat bagong mensahe pagdating nito.

{
  "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."
        }
      ]
    }
  }
}

Pinapangalanan ng watch ang capability na mail, hindi isang produkto. Sa run time, nare-resolve ito sa plugin na ikinonekta ng may-ari para sa mail. Tingnan ang Workflows para sa mga trigger at activity.

I-load ito sa isang bot

Ilagay ang folder sa <data>/user/agents/<name>/. Binabantayan ng Nebo ang AGENT.md, agent.json at manifest.json at nire-reload ang empleyado mga isang segundo pagkatapos ng pagbabago. Dina-deactivate ng pag-alis ng folder ang empleyado pero pinapanatili ang record nito.

Nilo-load ng Nebo ang mga empleyado mula sa tatlong source, at nananaig ang mga huli: mga empleyadong built-in sa Nebo, mga selyadong marketplace package sa <data>/nebo/agents/, at mga folder sa <data>/user/agents/. Puwede ring gumawa o magbago ng package para sa iyo ang isang empleyado gamit ang mga tool nitong create_employee at update_employee, na sumusulat sa parehong folder.

Ano ang nangyayari sa pag-hire

Kapag ini-hire ng may-ari ang empleyado mo mula sa marketplace o gamit ang AGNT- code, ang Nebo ay:

  1. Binabasa ang mga kailangan ng package nang hindi nagtatanong sa model: bawat capability sa requires.interfaces, bawat plugin sa requires.plugins, at bawat capability o plugin na pinapangalanan ng isang watch trigger.
  2. Nagpapakita sa may-ari ng isang pangungusap ng pagpayag para sa mga kailangang iyon at, sa pag-hire, ibinibigay ang mga ito sa empleyadong ito bilang permanenteng pahintulot. Nananatiling ganoon ang mga operasyong nangangailangan ng pag-apruba. Tingnan ang Mga Kakayahan at Pag-apruba.
  3. Ini-install ang mga dependency: mga plugin sa requires.plugins, mga marketplace skill na pinangalanan sa skills at sa mga activity, at ang mga dependency na idineklara noong na-publish ang package.
  4. Itinatanong sa may-ari ang mga tanong sa inputs, at sinasabihan ang may-ari sa Inbox tungkol sa anumang capability na wala pang koneksyon.

Pinapanatili ang workflow na walang koneksyon ang capability at minamarkahan itong degraded, kasama ang dahilan. Magsisimula itong gumana sa sandaling magkonekta ang may-ari ng isang system.

Ano ang sinusuri ng Nebo

Maluwag na binabasa ng Nebo ang agent.json. Hindi pinapansin ang mga hindi kilalang key. Nilalaktawan ang workflow na hindi tugma sa schema, at nakakatanggap ang may-ari ng abiso sa Inbox na hindi ito tatakbo; nilo-load pa rin ang natitirang bahagi ng empleyado. Tinatanggihan ng mga problemang ito ang buong file:

  • Isang event trigger na walang laman ang sources list.
  • Dalawang activity na may parehong id sa isang workflow.
  • Isang input na may scope na iba sa company o seat, o isang tanong tungkol sa pera na may default.
  • Isang ceiling value na iba sa "approval".
  • Isang phone call tree na walang eksaktong isang pagbati at kahit isang may-pangalang intent.

May mga pagsusuring tumatakbo kapag nagsimula ang workflow sa halip na kapag nilo-load ito, gaya ng mga parameter na kailangan ng bawat uri ng activity. Tingnan ang Activities.

Isulat ang mga responsibilidad, hindi ang mga tool. Pinapangalanan ng employee package ang mga capability, gaya ng ledger o mail, at hindi kailanman isang partikular na produkto, kumpanya, o industriya. Ang may-ari ang nagpapasya kung aling system ang pupuno sa bawat capability, kaya nagsisilbi ang isang package sa bawat kumpanyang nag-hire nito.

Susunod