NeboAI
NeboAI
Başlayın

Çalışan paketleri

Bir çalışan paketi, bir şirketin işe alabileceği bir rolü tanımlar: çalışanın neden sorumlu olduğunu, nasıl çalıştığını, ne tür sistemlere ihtiyaç duyduğunu ve kendi başına ne yaptığını. Bunu bir AGENT.md ve rol sohbetten fazlasını gerektirdiğinde bir agent.json içeren bir klasör olarak yazarsınız.

Paket

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
DosyaZorunluAmaç
AGENT.mdevetKişilik: çalışanın kim olduğu, nasıl çalıştığı ve kuralları. Bkz. Kişilik ve Bellek.
agent.jsonhayırGerektirdiği yetenekler, sahibine sorulacak sorular, iş akışları, bellek ayarları ve onay tavanları. Bkz. agent.json Başvurusu.
skills/hayırStandart SKILL.md biçimindeki beceriler. Onları yalnızca bu çalışan görür.
manifest.jsonyalnızca uygulamalar"type": "app" ile kimlik. Pazar yeri, bir çalışanı paketlerken kendi manifestosunu yazar.
ui/yalnızca uygulamalarUygulamanın sayfası. Bkz. Uygulamalar.

Bir paket yazın

Kişilikle başlayın. Ön bilgi çalışana bir ad ve tek satırlık bir açıklama verir; gövde ise düz metin hâlinde talimatlardır.

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

Rol bir sisteme, sahibinden bir ayara ya da istenmeden yapılan bir işe ihtiyaç duyduğunda agent.json ekleyin. Bu örnek mail yeteneğini gerektirir, işe alımda bir soru sorar ve gelen her yeni mesajı geldiği anda yanıtlar.

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

İzleme bir ürünü değil, mail yeteneğini adlandırır. Çalışma anında sahibinin posta için bağladığı eklentiye çözülür. Tetikleyiciler ve etkinlikler için İş Akışları sayfasına bakın.

Bir bota yükleyin

Klasörü <data>/user/agents/<name>/ konumuna koyun. Nebo AGENT.md, agent.json ve manifest.json dosyalarını izler ve bir değişiklikten yaklaşık bir saniye sonra çalışanı yeniden yükler. Klasörü kaldırmak çalışanı devre dışı bırakır ama kaydını korur.

Nebo çalışanları üç kaynaktan yükler ve sonraki kaynaklar önceliklidir: Nebo'ya yerleşik çalışanlar, <data>/nebo/agents/ içindeki mühürlü pazar yeri paketleri ve <data>/user/agents/ içindeki klasörler. Bir çalışan, aynı klasörü yazan create_employee ve update_employee araçlarıyla sizin için bir paket de oluşturabilir veya değiştirebilir.

İşe alımda ne olur

Bir sahip çalışanınızı pazar yerinden ya da bir AGNT- koduyla işe aldığında Nebo:

  1. Paketin ihtiyaçlarını bir modele sormadan okur: requires.interfaces içindeki her yetenek, requires.plugins içindeki her eklenti ve bir izleme tetikleyicisinin adlandırdığı her yetenek veya eklenti.
  2. Bu ihtiyaçlar için sahibine tek bir onay cümlesi gösterir ve işe alımda bunları bu çalışana kalıcı izinler olarak verir. Onay gerektiren işlemler öyle kalır. Bkz. Yetenekler ve Onaylar.
  3. Bağımlılıkları yükler: requires.plugins içindeki eklentiler, skills içinde ve etkinliklerde adı geçen pazar yeri becerileri ve paket yayımlandığında bildirilen bağımlılıklar.
  4. Sahibine inputs sorularını sorar ve henüz bağlantısı olmayan her yeteneği Gelen Kutusu üzerinden sahibine bildirir.

Yeteneğinin bağlantısı olmayan bir iş akışı korunur ve nedeniyle birlikte kısıtlı olarak işaretlenir. Sahip bir sistem bağladığı anda çalışmaya başlar.

Nebo neleri denetler

Nebo agent.json dosyasını hoşgörülü okur. Bilinmeyen anahtarlar yok sayılır. Şemaya uymayan bir iş akışı atlanır ve sahibi bu iş akışının çalışmayacağına dair bir Gelen Kutusu bildirimi alır; çalışanın geri kalanı yine yüklenir. Şu sorunlar dosyanın tamamını reddettirir:

  • Boş sources listesine sahip bir event tetikleyicisi.
  • Bir iş akışında aynı id değerine sahip iki etkinlik.
  • company veya seat dışında bir scope değerine sahip girdi ya da varsayılanı olan bir para sorusu.
  • "approval" dışında bir ceiling değeri.
  • Tam olarak bir karşılaması ve en az bir adlandırılmış amacı olmayan bir telefon arama ağacı.

Bazı denetimler, her etkinlik türünün gerektirdiği parametreler gibi, iş akışı yüklenirken değil başlarken çalışır. Bkz. Etkinlikler.

Araçları değil, sorumlulukları yazın. Bir çalışan paketi ledger veya mail gibi yetenekleri adlandırır; asla belirli bir ürünü, şirketi veya sektörü adlandırmaz. Her yeteneği hangi sistemin karşılayacağına sahibi karar verir, böylece tek bir paket onu işe alan her şirkete hizmet eder.

Sonraki