NeboAI
NeboAI
Бастау

Әрекеттер

Әрекет — жұмыс процесінің бір қадамы. Әрекеттердің көбін қызметкер атқарады: сіз мақсатты айтасыз, ал ол жұмысты өз дағдыларымен және қосылымдарымен орындайды. Алты түрі модельсіз жұмыс істейді, сондықтан бағыттау мен уақыт дәл сақталады.

Өрістер

{
  "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" }
}
ӨрісӘдепкіМағынасы
idміндеттіЖұмыс процесі ішінде бірегей. connections және деректер жолдарында пайдаланылады.
typecustomҚызметкер қадамы немесе condition, loop, wait, http, command, decide түрлерінің бірі.
intentжоқҚызметкер не нәрсеге қол жеткізуі керек. Қызметкер қадамына intent немесе steps қажет.
steps[]Бір сөйлем жеткіліксіз болғандағы реттелген нұсқаулар.
labelжоқИесіне көрсетілетін атау.
skills[]Пайдаланылатын дағдылар. Мұнда көрсетілген маркетплейс дағдылары қызметкермен бірге орнатылады.
tools[]Орнатылған болса, қадам пайдалана алатын жалғыз құралдар.
requires_tools[]Қадам орындалды деп есептелуі үшін сәтті орындалуы тиіс құралдар.
cmds[]Қадам үшін аталған плагин командалары.
mcps[]Қадам үшін аталған MCP серверлері.
modelжоқОсы қадамға арналған модель идентификаторы.
paramsжоқТиптелген әрекеттерге арналған параметрлер және қызметкер қадамдарына арналған maxIterations.
min_iterationsжоқҚадам аяқталмас бұрын модель кезектерінің ең аз саны.
token_budgetжоқ{max}. Болжам.
on_error{retry: 1, fallback: notify_owner}Қайталау әрекеттері, содан кейін балама жоспар. Қайталаулардан кейінгі кез келген сәтсіздік іске қосуды аяқтайды.

Қызметкер қадамдары

Қызметкер қадамы қызметкердің кезегі ретінде орындалады: оның персонасы, жадысы және қосылымдары қолданылады, және ол 50 модель кезегіне дейін немесе params.maxIterations мәніне дейін пайдалана алады. Алдыңғы қадамдардың нәтижелері [Activity 'id' result] блоктары ретінде беріледі. Жұмыс процесін emit тізімімен аяқтайтын қадамға сол оқиғалармен emit_event шақыру тапсырылады. Іске қосуды аяқтау үшін exit құралы әрқашан қолжетімді.

Деректер контексі

Типтелген әрекеттер мәндерді бір объектіден нүктелі жол арқылы оқиды: inputs іске қосудың кіріс мәндерін, nodes.<id> аяқталған әр әрекеттің шығысын (JSON болса, JSON ретінде талданады), ал item цикл ішіндегі ағымдағы элементті қамтиды. Жай жол алдымен inputs, содан кейін nodes ішінен іздейді.

condition

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

params.expression міндетті. Оның шығыс байланыстары True және False деп белгіленеді. params.mode оның қалай оқылатынын таңдайды:

РежимӨрнек
expressionӘдепкі. ==, !=, >=, <=, > немесе < бар path op value, екі жағы да сан болса, сан ретінде салыстырылады; немесе жай жол, оның мәні ақиқат болса, true.
existsЖол; ол ақиқат мәнге айналса, true болады.
containspath contains text немесе алдыңғы шығыспен салыстырылатын жай мәтін.
regexАлдыңғы шығыспен салыстырылатын үлгі.

loop

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

params.source — тізімнің жолы. Each item деп белгіленген байланыс денеге апарады, ол item орнатылған күйде әр элемент үшін бір рет орындалады; Done деп белгіленгені барлық элементтен кейін орындалады. concurrency орнатпасаңыз, итерациялар бірге басталады. maxIterations және batchSize да қабылданады.

"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 және 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" } }
ТүріМіндеттіӘрекеті
waitparams.durations, m немесе h түріндегі аралыққа кідіреді. «Белгілі бір сәтке дейін күту» жоқ; оқиға бойынша жалғастыру үшін соған екінші жұмыс процесін іске қосыңыз.
httpparams.urlСұрауды жібереді. method, headers және body міндетті емес.
commandparams.commandShell командасын іске қосады. Оның stdout шығысы — әрекеттің шығысы.

decide

Decide әрекеті осы уақытқа дейінгі жұмыс туралы типтелген сұрақтар қойып, condition бағыттай алатын құрылымдық жауаптарды жазады.

{
  "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 }
  }
}
Сұрақ түріcriteriaЖауап
choiceНұсқадан сипаттамаға сәйкестік объектісі, 2-ден 255-ке дейін нұсқа.choice, confidence және probabilities.
score2-ден 10-ға дейінгі реттелген деңгейлер тізімі.0-ден (бірінші деңгей) жоғары қарай score және confidence.
noulЖоқ.noul, тұжырымның дұрыс болу ықтималдығы.

Жауап бойынша condition арқылы бағыттаңыз, мысалы, nodes.triage.urgency.score >= 1.5. params.default шешім қабылдау мүмкін болмағанда әр сұраққа қауіпсіз жауап береді; әдепкі жауаптың сенімділігі 0. Әдепкі мәні жоқ сұрақ жауапсыз қалады, сондықтан оған қойылған шарттар False қырымен жүреді.

Қателер

on_error.retry сәтсіз әрекеттің неше рет қайталанатынын белгілейді; әдепкі мәні — 1. Соңғы қайталаудан кейін іске қосу аяқталады, ал әдепкі fallback мәні notify_owner болғанда иесіне хабарланады. Nebo іске қосу басталғанда әр типтелген әрекеттің міндетті параметрлерін тексереді және белгісіз әрекетке нұсқайтын тармақты қабылдамайды.