NeboAI
NeboAI
Aloita

Toiminnot

Toiminto on työnkulun yksi vaihe. Useimmat toiminnot suorittaa työntekijä: kerrot tavoitteen, ja se tekee työn taidoillaan ja yhteyksillään. Kuusi tyyppiä toimii ilman mallia, joten reititys ja ajoitus pysyvät tarkkoina.

Kentät

{
  "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" }
}
KenttäOletusMerkitys
idpakollinenYksilöllinen työnkulun sisällä. Käytetään kentässä connections ja datapoluissa.
typecustomTyöntekijävaihe tai jokin näistä: condition, loop, wait, http, command, decide.
intentei mitäänMitä työntekijän pitäisi saada aikaan. Työntekijävaihe tarvitsee kentän intent tai steps.
steps[]Järjestetyt ohjeet, kun yksi lause ei riitä.
labelei mitäänOmistajalle näytettävä nimi.
skills[]Käytettävät taidot. Tässä luetellut kaupan taidot asennetaan työntekijän mukana.
tools[]Kun asetettu, ainoat työkalut, joita vaihe saa käyttää.
requires_tools[]Työkalut, joiden on onnistuttava, jotta vaihe lasketaan tehdyksi.
cmds[]Vaiheelle nimetyt laajennuskomennot.
mcps[]Vaiheelle nimetyt MCP-palvelimet.
modelei mitäänTämän vaiheen mallin tunniste.
paramsei mitäänTyypitettyjen toimintojen parametrit ja työntekijävaiheiden maxIterations.
min_iterationsei mitäänMallin vuorojen vähimmäismäärä ennen kuin vaihe voi päättyä.
token_budgetei mitään{max}. Arvio.
on_error{retry: 1, fallback: notify_owner}Uudelleenyritykset ja sitten varavaihtoehto. Mikä tahansa epäonnistuminen uudelleenyritysten jälkeen päättää suorituksen.

Työntekijävaiheet

Työntekijävaihe suoritetaan työntekijän vuorona: sen persoona, muisti ja yhteydet ovat käytössä, ja se voi käyttää enintään 50 mallin vuoroa tai params.maxIterations-arvon verran. Aiempien vaiheiden tulokset välitetään [Activity 'id' result] -lohkoina. Vaihetta, joka päättää työnkulun emit-listalla, pyydetään kutsumaan emit_event näillä tapahtumilla. exit-työkalu on aina käytettävissä suorituksen päättämiseen.

Datakonteksti

Tyypitetyt toiminnot lukevat arvoja pisteellisellä polulla yhdestä objektista: inputs sisältää suorituksen syötteet, nodes.<id> sisältää kunkin valmistuneen toiminnon tulosteen (jäsennettynä JSONina, kun se on JSONia), ja item sisältää silmukan nykyisen kohteen. Pelkkä polku etsitään ensin kohdasta inputs, sitten kohdasta nodes.

condition

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

params.expression on pakollinen. Sen lähtevät yhteydet merkitään True ja False. params.mode valitsee, miten se luetaan:

TilaLauseke
expressionOletus. path op value operaattoreilla ==, !=, >=, <=, > tai <, verrattuna lukuina, kun molemmat puolet ovat lukuja; tai pelkkä polku, tosi, kun sen arvo on todeksi tulkittava.
existsPolku; tosi, kun se ratkeaa todeksi tulkittavaan arvoon.
containspath contains text tai pelkkä teksti, jota verrataan edelliseen tulosteeseen.
regexKuvio, jota verrataan edelliseen tulosteeseen.

loop

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

params.source on listan polku. Yhteys, jonka nimi on Each item, johtaa runkoon, joka suoritetaan kerran jokaista kohdetta kohden item asetettuna; yhteys nimeltä Done suoritetaan kaikkien kohteiden jälkeen. Kierrokset alkavat yhtä aikaa, ellet aseta concurrency-arvoa. Myös maxIterations ja batchSize hyväksytään.

"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 ja 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" } }
TyyppiPakollinenToiminta
waitparams.durationPysähtyy aikavälin ajaksi yksikössä s, m tai h. Odotusta tiettyyn hetkeen ei ole; jos haluat jatkaa tapahtuman myötä, laukaise toinen työnkulku sillä.
httpparams.urlTekee pyynnön. method, headers ja body ovat valinnaisia.
commandparams.commandSuorittaa komentotulkin komennon. Sen stdout on toiminnon tuloste.

decide

decide-toiminto esittää tyypitettyjä kysymyksiä tähänastisesta työstä ja tallentaa jäsennellyt vastaukset, joiden perusteella ehto voi reitittää.

{
  "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 }
  }
}
KysymystyyppicriteriaVastaus
choiceObjekti, jossa vaihtoehto on liitetty kuvaukseen, 2–255 vaihtoehtoa.choice, confidence ja probabilities.
scoreLista, jossa on 2–10 järjestettyä tasoa.score arvosta 0 (ensimmäinen taso) ylöspäin sekä confidence.
noulEi mitään.noul, todennäköisyys sille, että väite pitää paikkansa.

Reititä vastauksen perusteella ehdolla, kuten nodes.triage.urgency.score >= 1.5. params.default antaa kullekin kysymykselle turvallisen vastauksen, kun päätöstä ei voida tehdä; oletusvastauksen varmuus on 0. Kysymys ilman oletusta ei saa vastausta, joten sitä koskevat ehdot kulkevat False-reunaa pitkin.

Virheet

on_error.retry määrää, kuinka monta kertaa epäonnistunutta toimintoa yritetään uudelleen; oletus on 1. Viimeisen uudelleenyrityksen jälkeen suoritus päättyy, ja oletusarvoisella fallback-arvolla notify_owner omistajalle kerrotaan. Nebo tarkistaa jokaisen tyypitetyn toiminnon pakolliset parametrit suorituksen alkaessa ja hylkää haaran, joka osoittaa tuntemattomaan toimintoon.