NeboAI
NeboAI
Başlayın

Aktiviteler

Etkinlik, bir iş akışının tek bir adımıdır. Çoğu etkinliği çalışan yürütür: siz amacı belirtirsiniz, o da işi becerileri ve bağlantılarıyla yapar. Altı tür model olmadan çalışır; böylece yönlendirme ve zamanlama kesin kalır.

Alanlar

{
  "id": "draft-reply",
  "label": "Draft the reply",
  "intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
  "skills": ["reply-drafting"],
  "requires_tools": ["mail_message_send"],
  "on_error": { "retry": 1, "fallback": "notify_owner" }
}
AlanVarsayılanAnlamı
idzorunluİş akışı içinde benzersizdir. connections ve veri yollarında kullanılır.
typecustomBir çalışan adımı ya da condition, loop, wait, http, command, decide türlerinden biri.
intentyokÇalışanın ne başarması gerektiği. Bir çalışan adımı intent veya steps gerektirir.
steps[]Tek cümle yetmediğinde sıralı talimatlar.
labelyokSahibe gösterilen ad.
skills[]Kullanılacak beceriler. Burada listelenen pazar yeri becerileri çalışanla birlikte kurulur.
tools[]Ayarlandığında, adımın kullanabileceği tek araçlar.
requires_tools[]Adımın tamamlanmış sayılması için başarılı olması gereken araçlar.
cmds[]Adım için adı verilen eklenti komutları.
mcps[]Adım için adı verilen MCP sunucuları.
modelyokBu adım için bir model kimliği.
paramsyokTürlendirilmiş etkinlikler için parametreler ve çalışan adımları için maxIterations.
min_iterationsyokAdımın bitebilmesi için gereken en az model turu.
token_budgetyok{max}. Bir tahmin.
on_error{retry: 1, fallback: notify_owner}Yeniden denemeler, ardından yedek davranış. Yeniden denemelerden sonraki her hata çalıştırmayı sonlandırır.

Çalışan adımları

Bir çalışan adımı, çalışanın bir turu olarak çalışır: kişiliği, belleği ve bağlantıları geçerlidir ve en fazla 50 model turu ya da params.maxIterations kadar tur kullanabilir. Önceki adımların sonuçları [Activity 'id' result] blokları olarak aktarılır. Bir iş akışını emit listesiyle bitiren adıma, bu olaylarla emit_event çağırması söylenir. Çalıştırmayı bitirmek için exit aracı her zaman kullanılabilir.

Veri bağlamı

Türlendirilmiş etkinlikler değerleri tek bir nesneden noktalı yolla okur: inputs çalıştırmanın girdilerini, nodes.<id> biten her etkinliğin çıktısını (JSON ise JSON olarak ayrıştırılmış hâlde), item ise bir döngü içindeki geçerli öğeyi tutar. Yalın bir yol önce inputs, sonra nodes içinde aranır.

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

params.expression zorunludur. Giden bağlantıları True ve False olarak etiketlenir. params.mode nasıl okunacağını seçer:

Modİfade
expressionVarsayılan. ==, !=, >=, <=, > veya < ile path op value; iki taraf da sayıysa sayı olarak karşılaştırılır. Ya da yalın bir yol; değeri doğru kabul edildiğinde doğrudur.
existsBir yol; doğru kabul edilen bir değere çözümlendiğinde doğrudur.
containspath contains text ya da önceki çıktıyla eşleştirilen yalın metin.
regexÖnceki çıktıyla eşleştirilen bir desen.

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

params.source bir listenin yoludur. Each item etiketli bağlantı, item ayarlı olarak her öğe için bir kez çalışan gövdeye gider; Done etiketli olan tüm öğelerden sonra çalışır. concurrency ayarlamadığınız sürece yinelemeler birlikte başlar. maxIterations ve batchSize da kabul edilir.

"connections": [
  { "from": "__trigger__", "to": "fetch" },
  { "from": "fetch", "to": "each-invoice" },
  { "from": "each-invoice", "to": "check", "label": "Each item" },
  { "from": "each-invoice", "to": "report", "label": "Done" }
]

wait, http ve command

{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } }
TürZorunluDavranış
waitparams.durations, m veya h cinsinden bir süre boyunca duraklar. Belirli bir ana kadar bekleme yoktur; bir olayla devam etmek için o olayla ikinci bir iş akışını tetikleyin.
httpparams.urlİsteği yapar. method, headers ve body isteğe bağlıdır.
commandparams.commandBir kabuk komutu çalıştırır. Stdout çıktısı etkinliğin çıktısıdır.

decide

Bir decide etkinliği, o ana kadarki iş hakkında türlendirilmiş sorular sorar ve bir koşulun yönlendirme yapabileceği yapılandırılmış yanıtlar kaydeder.

{
  "id": "triage",
  "type": "decide",
  "params": {
    "questions": {
      "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
      "refund": { "type": "noul", "instructions": "The customer is asking for money back." }
    },
    "default": { "urgency": "normal", "refund": false }
  }
}
Soru türücriteriaYanıt
choiceSeçenekten açıklamaya nesne, 2 ile 255 arasında seçenek.choice, confidence ve probabilities.
score2 ile 10 arasında sıralı seviye listesi.0’dan (ilk seviye) yukarı doğru score ve confidence.
noulYok.noul, ifadenin doğru olma olasılığı.

Bir yanıta göre bir koşulla yönlendirme yapın; örneğin nodes.triage.urgency.score >= 1.5. params.default, karar verilemediğinde her soru için güvenli yanıtı verir; varsayılana düşen bir yanıtın güven değeri 0’dır. Varsayılanı olmayan bir soru yanıt almaz; bu yüzden ona bağlı koşullar False kenarını izler.

Hatalar

on_error.retry, başarısız bir etkinliğin kaç kez yeniden deneneceğini belirler; varsayılan 1’dir. Son yeniden denemeden sonra çalıştırma sona erer ve varsayılan fallback değeri olan notify_owner ile sahibe bildirilir. Nebo, çalıştırma başladığında her türlendirilmiş etkinliğin zorunlu parametrelerini denetler ve bilinmeyen bir etkinliği gösteren dalı reddeder.