Bağlanın
https://neboai.com/mcp adresini uzak sunucuları destekleyen herhangi bir MCP istemcisine ekleyin. İstemci yetkilendirme sunucusunu keşfeder, kendini kaydeder ve sizi OAuth ve PKCE ile oturum açtırır. Her NeboAI hesabı bağlanabilir. Erişim belirteçleri bir saat geçerlidir ve 30 gün boyunca yenilenir.
Geliştirici hesabı
NeboAI hesabı olan herkes yayımlayabilir. Bir sürüm göndermek ve dosya yüklemek, ilk kez gönderim yaptığınızda veya yükleme belirteci istediğinizde sizin için ücretsiz olarak kurulan geliştirici hesabınızı kullanır. Ücret yoktur ve onay adımı yoktur.
Kendiniz yerine bir ekip adına yayımlamak için oturumda ekibin hesabını seçin. Ekibin üyesi olmanız gerekir.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer hesabınızı önceden de kurabilir (action: "create", isteğe bağlı) ve ad alanlarını listeleyip seçebilir (resource: "namespace"). Seçilen ad alanı, yayımladığınız her nitelikli adın bir parçası olur.
Araçlar
skill, agent ve plugin araçları aynı eylem kümesini paylaşır. Uygulamalar agent aracıyla yayımlanır.
| Eylem | Geliştirici hesabı | Ne yapar |
|---|---|---|
create | gerekmez | Öğeyi ve yükleme kodunu oluşturur. |
update | gerekmez | Alanları, içeriği, sürümü veya görünürlüğü değiştirir. |
get, list, delete | gerekmez | Öğelerinizi okur veya kaldırır. |
install | gerekmez | Botlarınızdan birine yükler: id, botId ve bağımlılıkları dahil etmek için cascade. |
bundle-token | otomatik kurulur | Metin dosyalarından oluşan bir zip yüklemek için bir belirteç. |
binary-token | otomatik kurulur | İkili dosyaları, plugin.json, agent.json ve uygulama arayüzlerini yüklemek için bir belirteç. |
list-binaries, delete-binary | otomatik kurulur | Yüklenen ikili dosyaları yönetir. |
submit | otomatik kurulur | Bir sürümü incelemeye gönderir. |
| Alan | Anlamı |
|---|---|
name | Görünen ad. Slug bundan oluşturulur. |
description | Tek satır; göndermek için 10 ile 500 karakter arası. |
manifestContent | Öğenin ana dosyası: SKILL.md, AGENT.md veya PLUGIN.md. |
version | Anlamsal sürüm. Varsayılan 0.1.0. |
visibility | private (varsayılan), loop (Kanallarınızla paylaşılır) veya public. |
category | Pazar yeri kategorisi. |
longDescription | Pazar yerindeki "Ne yapar" metni (yalnızca update). |
sourceUrl, manifestUrl | İsteğe bağlı bağlantılar. |
dependencies | Yalnızca çalışanlar. Bkz. Bağımlılıklar. |
marketplace aracı pazar yerinde arama yapar ve kategorileri listeler. pricing aracı bir öğeye fiyat belirler; ücretli öğeler için ödeme alma kaydının tamamlanması gerekir.
Bir beceri yayımlayın
Beceriyi içerik olarak SKILL.md dosyasıyla oluşturun.
skill(action: "create", name: "invoice-totals",
description: "Add up invoice line items, apply tax, and report the totals.",
category: "finance", version: "1.0.0", manifestContent: "<contents of SKILL.md>") Beceriyi ön bilgideki name ile adlandırın. Nitelikli adı @<namespace>/skills/<slug> şeklindedir; slug görünen addan oluşturulur ve botlar nitelikli adları ön bilgideki name ile çözümler, bu yüzden ikisi eşleşmelidir.
Becerinin başka dosyaları varsa klasörü zip olarak yükleyin. Zip içindeki tek bir üst düzey klasör otomatik olarak kaldırılır ve derleme ile sürüm denetimi klasörleri atlanır.
skill(action: "bundle-token", id: "<skill id>") cd invoice-totals && zip -r ../invoice-totals.zip . && cd .. curl -X POST "https://neboai.com/api/v1/skills/<skill id>/bundle" \ -H "Authorization: Bearer <token>" \ -F file=@invoice-totals.zip
| Paket kuralı | Sınır |
|---|---|
| Zip boyutu | 50 MB |
| Her dosya | 10 MB |
| Tüm dosyalar | 50 MB |
| Dosya türleri | Metin, kod, veri, görseller, PDF ve yazı tipleri; örneğin .md, .py, .js, .ts, .json, .yaml, .csv, .html. scripts/, bin/ veya dist/ altındaki her şey kabul edilir. |
| Yollar | .. ve mutlak yol olmaz. |
Beceriyi herkese açık yapın ve bir sürüm gönderin.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Bir çalışan yayımlayın
Çalışanı içerik olarak AGENT.md dosyasıyla ve pazar yeri bağımlılıklarıyla oluşturun.
agent(action: "create", name: "Support Coordinator",
description: "Answers every customer message the day it arrives and escalates what it cannot settle.",
version: "1.0.0", manifestContent: "<contents of AGENT.md>",
dependencies: { skills: [ { qualifiedName: "@example-studio/skills/reply-drafting", id: "<skill id>", name: "reply-drafting" } ] }) agent.json dosyasını bir ikili dosya belirteciyle yükleyin. Çalışanların ikili dosyaya ihtiyacı yoktur; config yeterlidir. Çalışanın kendi skills/ klasörünü dahil etmek için paketi bunun yerine tek bir bundle olarak yükleyin: tek bir zip içinde AGENT.md, agent.json ve skills/.
agent(action: "binary-token", id: "<agent id>") curl -X POST "https://neboai.com/api/v1/developer/apps/<agent id>/binaries" \ -H "Authorization: Bearer <token>" \ -F config=@support-coordinator/agent.json
Bağımlılıkları agent.json içinde tutun. Yüklenen bir agent.json, create veya update ile ayarlanan bağımlılıklar dahil saklanan yapılandırmanın yerini alır ve dependencies içeren bir update da saklanan agent.json dosyasının yerini alır. İkisini birlikte kullandığınızda aynı dependencies nesnesini agent.json içine koyun.
Bağımlılıklar
dependencies; skills, agents ve connectors listelerini içerir. Her giriş {qualifiedName, id, name} biçimindedir; NeboAI önce nitelikli adı, ardından kimliği kontrol eder. Eklentiler skills altında listelenir. agent.json içinde adı geçen becerilerin gerektirdiği eklentiler otomatik olarak eklenir. Bir sahip çalışanınızı pazar yerinden veya koduyla yüklediğinde bot, çalışanın beceri, eklenti ve çalışan bağımlılıklarını da onunla birlikte yükler.
Bir eklenti veya uygulama yayımlayın
Eklentiler, eklentinin plugin.json dosyası ve becerileriyle birlikte platform başına bir ikili dosya yükler; bkz. Eklenti Yayınlama. Yalnızca sayfadan oluşan bir uygulamanın ikili dosyaya ihtiyacı yoktur: bundle-token ile AGENT.md (artifact_type: app ile), agent.json, manifest.json, ui/ ve varsa skills/ içeren tek bir paket yükleyin. Sidecar'ı olan bir uygulama, agent aracıyla aynı ikili dosya yüklemesini kullanır: sidecar ikili dosyası platform değeriyle birlikte file olarak, sayfa ise ui/ klasörünün bir .tar.gz arşivi olan ui olarak. Bkz. Uygulamalar.
İnceleme
submit, ana dosyanın içeriğini ve 10 ile 500 karakter arasında bir açıklama gerektirir. Her gönderim taranır. Temiz bir tarama otomatik olarak onaylanabilir; işaretlenen her şey elle incelemeye gider. Onay, varsa ikili dosyaları imzalar ve sürümü etkin hâle getirir. Reddedilen bir sürüm taslağa döner.
| Öğe durumu | Anlamı |
|---|---|
draft | Gönderilmedi veya reddedildi. |
pending_review, review | İnceleme bekleniyor. |
active | Onaylandı. Görünürlük public olduğunda pazar yerinde listelenir. |
revoked | Geri çekildi. |
Yükleme kodları
Her öğe oluşturulduğunda yükleme kodunu alır: SKIL-, AGNT-, PLUG-, APPS-, CONN- veya COLL- ve ardından sekiz karakter. Kodu bir Nebo sohbetinde mesaj olarak yazmak öğeyi yükler; bkz. Temel Kavramlar.