NeboAI
NeboAI
Mulakan

Pakej Pekerja

Pakej pekerja menerangkan peranan yang boleh diambil oleh syarikat: apa yang menjadi tanggungjawab pekerja, cara ia bekerja, jenis sistem yang diperlukannya, dan apa yang dilakukannya dengan sendirinya. Anda menulisnya sebagai folder dengan AGENT.md dan, apabila peranan itu memerlukan lebih daripada sembang, agent.json.

Pakej

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
FailWajibTujuan
AGENT.mdyaPersona: siapa pekerja itu, cara ia bekerja dan peraturannya. Lihat Persona dan Memori.
agent.jsontidakKeupayaan yang diperlukannya, soalan untuk pemilik, aliran kerja, tetapan memori dan had kelulusan. Lihat Rujukan agent.json.
skills/tidakKemahiran dalam format SKILL.md standard. Hanya pekerja ini yang melihatnya.
manifest.jsonaplikasi sahajaIdentiti dengan "type": "app". Pasaran menulis manifesnya sendiri apabila ia membungkus pekerja.
ui/aplikasi sahajaHalaman aplikasi. Lihat Aplikasi.

Tulis pakej

Mulakan dengan persona. Frontmatter menamakan pekerja dan memberikan penerangan satu baris; badannya ialah arahan dalam prosa biasa.

---
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.

Tambah agent.json apabila peranan itu memerlukan sistem, tetapan daripada pemilik, atau kerja yang dilakukannya tanpa diminta. Yang ini memerlukan keupayaan mail, bertanya satu soalan semasa pengambilan, dan menjawab setiap mesej baharu sebaik sahaja ia tiba.

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

Pemantauan itu menamakan keupayaan mail, bukan produk. Semasa masa jalan, ia diselesaikan kepada plugin yang disambungkan oleh pemilik untuk mel. Lihat Aliran Kerja untuk pencetus dan aktiviti.

Muatkannya pada bot

Letakkan folder dalam <data>/user/agents/<name>/. Nebo memantau AGENT.md, agent.json dan manifest.json dan memuat semula pekerja kira-kira sesaat selepas perubahan. Membuang folder itu menyahaktifkan pekerja tetapi mengekalkan rekodnya.

Nebo memuatkan pekerja daripada tiga sumber, dan sumber terkemudian diutamakan: pekerja yang terbina dalam Nebo, pakej pasaran termeterai dalam <data>/nebo/agents/, dan folder dalam <data>/user/agents/. Pekerja juga boleh mencipta atau mengubah pakej untuk anda dengan alat create_employee dan update_employeenya, yang menulis folder yang sama.

Apa yang berlaku semasa pengambilan

Apabila pemilik mengambil pekerja anda dari pasaran atau dengan kod AGNT-, Nebo:

  1. Membaca keperluan pakej tanpa bertanya kepada model: setiap keupayaan dalam requires.interfaces, setiap plugin dalam requires.plugins, dan setiap keupayaan atau plugin yang dinamakan oleh pencetus pemantauan.
  2. Menunjukkan kepada pemilik satu ayat persetujuan untuk keperluan tersebut dan, semasa pengambilan, memberikannya kepada pekerja ini sebagai kebenaran tetap. Operasi yang memerlukan kelulusan kekal begitu. Lihat Keupayaan dan Kelulusan.
  3. Memasang kebergantungan: plugin dalam requires.plugins, kemahiran pasaran yang dinamakan dalam skills dan dalam aktiviti, serta kebergantungan yang diisytiharkan semasa pakej diterbitkan.
  4. Bertanya kepada pemilik soalan inputs, dan memberitahu pemilik melalui Peti Masuk tentang sebarang keupayaan yang belum mempunyai sambungan.

Aliran kerja yang keupayaannya tiada sambungan disimpan dan ditanda sebagai terjejas, bersama sebabnya. Ia mula berfungsi sebaik sahaja pemilik menyambungkan sistem.

Apa yang disemak oleh Nebo

Nebo membaca agent.json secara longgar. Kunci yang tidak dikenali diabaikan. Aliran kerja yang tidak sepadan dengan skema dilangkau, dan pemilik mendapat notis Peti Masuk bahawa ia tidak akan berjalan; selebihnya pekerja itu tetap dimuatkan. Masalah berikut menolak keseluruhan fail:

  • Pencetus event dengan senarai sources yang kosong.
  • Dua aktiviti dengan id yang sama dalam satu aliran kerja.
  • Input dengan scope selain company atau seat, atau soalan wang dengan nilai lalai.
  • Nilai ceiling selain "approval".
  • Pepohon panggilan telefon tanpa tepat satu ucapan alu-aluan dan sekurang-kurangnya satu niat bernama.

Sesetengah semakan dijalankan apabila aliran kerja bermula dan bukannya apabila ia dimuatkan, seperti parameter yang diperlukan oleh setiap jenis aktiviti. Lihat Aktiviti.

Tulis tanggungjawab, bukan alat. Pakej pekerja menamakan keupayaan, seperti ledger atau mail, dan tidak sekali-kali produk, syarikat atau industri tertentu. Pemilik menentukan sistem mana yang mengisi setiap keupayaan, jadi satu pakej melayani setiap syarikat yang mengambilnya.

Seterusnya