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 | Dosya | Zorunlu | Amaç |
|---|---|---|
AGENT.md | evet | Kişilik: çalışanın kim olduğu, nasıl çalıştığı ve kuralları. Bkz. Kişilik ve Bellek. |
agent.json | hayır | Gerektirdiği yetenekler, sahibine sorulacak sorular, iş akışları, bellek ayarları ve onay tavanları. Bkz. agent.json Başvurusu. |
skills/ | hayır | Standart SKILL.md biçimindeki beceriler. Onları yalnızca bu çalışan görür. |
manifest.json | yalnızca uygulamalar | "type": "app" ile kimlik. Pazar yeri, bir çalışanı paketlerken kendi manifestosunu yazar. |
ui/ | yalnızca uygulamalar | Uygulamanı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:
- Paketin ihtiyaçlarını bir modele sormadan okur:
requires.interfacesiçindeki her yetenek,requires.pluginsiçindeki her eklenti ve bir izleme tetikleyicisinin adlandırdığı her yetenek veya eklenti. - 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.
- Bağımlılıkları yükler:
requires.pluginsiçindeki eklentiler,skillsiçinde ve etkinliklerde adı geçen pazar yeri becerileri ve paket yayımlandığında bildirilen bağımlılıklar. - Sahibine
inputssoruları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ş
sourceslistesine sahip bireventtetikleyicisi. - Bir iş akışında aynı
iddeğerine sahip iki etkinlik. companyveyaseatdışında birscopedeğerine sahip girdi ya da varsayılanı olan bir para sorusu."approval"dışında birceilingdeğ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
- agent.json Başvurusu
- Kişilik ve Bellek
- Yayımlama: çalışanı pazar yerine koyun.