NeboAI
NeboAI
Mulai

Paket Karyawan

Paket karyawan menggambarkan peran yang dapat direkrut perusahaan: apa tanggung jawab karyawan itu, bagaimana ia bekerja, jenis sistem apa yang dibutuhkannya, dan apa yang dikerjakannya sendiri. Anda menulisnya sebagai folder berisi AGENT.md dan, jika peran tersebut membutuhkan lebih dari sekadar obrolan, agent.json.

Paketnya

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
FileWajibTujuan
AGENT.mdyaPersona: siapa karyawan itu, bagaimana ia bekerja, dan aturannya. Lihat Persona dan Memori.
agent.jsontidakKapabilitas yang dibutuhkannya, pertanyaan untuk pemilik, workflow, pengaturan memori, dan batas persetujuan. Lihat Referensi agent.json.
skills/tidakSkill dalam format SKILL.md standar. Hanya karyawan ini yang dapat melihatnya.
manifest.jsonhanya aplikasiIdentitas dengan "type": "app". Marketplace menulis manifesnya sendiri saat mengemas karyawan.
ui/hanya aplikasiHalaman aplikasi. Lihat Aplikasi.

Tulis paket

Mulailah dengan persona. Frontmatter memberi nama karyawan dan deskripsi satu baris; isinya berupa instruksi 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.

Tambahkan agent.json jika peran tersebut membutuhkan sebuah sistem, pengaturan dari pemilik, atau pekerjaan yang dilakukannya tanpa diminta. Contoh ini membutuhkan kapabilitas mail, mengajukan satu pertanyaan saat perekrutan, dan menjawab setiap pesan baru saat pesan itu masuk.

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

Watch menyebut kapabilitas mail, bukan sebuah produk. Saat runtime, kapabilitas itu diarahkan ke plugin yang dihubungkan pemilik untuk email. Lihat Workflow untuk pemicu dan aktivitas.

Muat di bot

Letakkan folder di <data>/user/agents/<name>/. Nebo memantau AGENT.md, agent.json, dan manifest.json serta memuat ulang karyawan sekitar satu detik setelah ada perubahan. Menghapus folder akan menonaktifkan karyawan tetapi tetap menyimpan catatannya.

Nebo memuat karyawan dari tiga sumber, dan sumber yang lebih akhir yang berlaku: karyawan bawaan Nebo, paket marketplace tersegel di <data>/nebo/agents/, dan folder di <data>/user/agents/. Seorang karyawan juga dapat membuat atau mengubah paket untuk Anda dengan alat create_employee dan update_employee miliknya, yang menulis ke folder yang sama.

Apa yang terjadi saat perekrutan

Saat pemilik merekrut karyawan Anda dari marketplace atau dengan kode AGNT-, Nebo:

  1. Membaca kebutuhan paket tanpa bertanya kepada model: setiap kapabilitas di requires.interfaces, setiap plugin di requires.plugins, dan setiap kapabilitas atau plugin yang disebut oleh pemicu watch.
  2. Menampilkan kepada pemilik satu kalimat persetujuan untuk kebutuhan tersebut dan, saat perekrutan, memberikannya kepada karyawan ini sebagai izin tetap. Operasi yang memerlukan persetujuan tetap seperti itu. Lihat Kapabilitas dan Persetujuan.
  3. Memasang dependensi: plugin di requires.plugins, skill marketplace yang disebut di skills dan di aktivitas, serta dependensi yang dideklarasikan saat paket dipublikasikan.
  4. Mengajukan pertanyaan inputs kepada pemilik, dan memberi tahu pemilik melalui Kotak Masuk tentang kapabilitas apa pun yang belum memiliki koneksi.

Workflow yang kapabilitasnya belum memiliki koneksi tetap disimpan dan ditandai menurun beserta alasannya. Workflow itu mulai berjalan begitu pemilik menghubungkan sebuah sistem.

Apa yang diperiksa Nebo

Nebo membaca agent.json secara longgar. Key yang tidak dikenal diabaikan. Workflow yang tidak sesuai skema akan dilewati, dan pemilik mendapat pemberitahuan di Kotak Masuk bahwa workflow itu tidak akan berjalan; bagian lain dari karyawan tetap dimuat. Masalah-masalah berikut membuat seluruh file ditolak:

  • Pemicu event dengan daftar sources yang kosong.
  • Dua aktivitas dengan id yang sama dalam satu workflow.
  • Input dengan scope selain company atau seat, atau pertanyaan uang yang memiliki nilai default.
  • Nilai ceiling selain "approval".
  • Pohon panggilan telepon yang tidak memiliki tepat satu sapaan dan setidaknya satu intent bernama.

Beberapa pemeriksaan dijalankan saat workflow dimulai, bukan saat dimuat, misalnya parameter yang diwajibkan setiap tipe aktivitas. Lihat Aktivitas.

Tulis tanggung jawab, bukan alat. Paket karyawan menyebut kapabilitas, seperti ledger atau mail, dan tidak pernah menyebut produk, perusahaan, atau industri tertentu. Pemilik menentukan sistem mana yang mengisi setiap kapabilitas, sehingga satu paket dapat melayani setiap perusahaan yang merekrutnya.

Berikutnya